- Working with synchronized data
- Presenting synchronized data
- Hiding attributes based on group memberships
- Using synchronized data in workflow
- Using synchronized data in JQL
- Using synchronized data in notification
REST API
This page provides REST API methods for Active Directory Attributes Sync app.
Active Directory Attributes Sync app exposes a REST API that provides two methods (GET and PUT) mapped to CRUD operations.
For more information on using REST API in Jira, see official Atlassian documentation.
/rest/intenso/ad/1.0/public/connection
Request
Get all enabled connections
GET /rest/intenso/ad/1.0/public/connection
Sample output
{
"LDAP_server_23":
[
"title",
"telephoneNumber",
"l",
"company",
"mobile",
"streetAddress",
"manager",
"description",
"department",
"mail",
"wWWHomePage"
]
}
Request
Get all fields for user for enable connection
GET /rest/intenso/ad/1.0/public/connection/{idOrName}/user/{userKeyOrName}
Sample output
{
"title": "Jira AD Sync Expert",
"telephoneNumber": "111 222 333",
"l": "Wroclaw",
"company": "Deviniti",
"mobile": "111 222 333",
"streetAddress": "Jira LDAP Connection Square",
"physicalDeliveryOfficeName": "Jira User Management Zone",
"manager": "Jirard Serverin",
"description": "Jira Active Directory Sync Expert",
"department": "Jira AD Integration",
"mail": "jira-ad-expert@deviniti.com"
}
Request
Get value for field for user
GET /rest/intenso/ad/1.0/public/connection/{idOrName}/user/{userKeyOrName}/field/{idFromAD}
Sample output
{
"title": "Software developer"
}
/rest/intenso/ad/1.0/public/user
Request
Get all user’s values for all enabled connections
GET /rest/intenso/ad/1.0/public/user/{userKeyOrName}
Sample output
{
"LDAP_server_23":
{
"title": "Jira AD Sync Expert",
"telephoneNumber": "111 222 333",
"l": "Wroclaw",
"company": "Deviniti",
"mobile": "111 222 333",
"streetAddress": "Jira LDAP Connection Square",
"physicalDeliveryOfficeName": "Jira User Management Zone",
"manager": "Jirard Serverin",
"description": "Jira Active Directory Sync Expert",
"department": "Jira AD Integration",
"mail": "jira-ad-expert@deviniti.com"
}
}
/rest/intenso/ad/1.0/public/update
Request
Update user’s data or connection details
PUT /rest/intenso/ad/1.0/public/update
Sample output
Keep in mind this method will update data in Jira. The data will be overwritten during next synchronization.
{
"connectionId":"2",
"update": [{
"connection": [{
"name" : "new name",
"userDn":"new user DN"
}],
"data":[{
"userKey":"JIRAUSER10119",
"fields":[{
"departmentNumber":"124567"
}]
},{
"userKey":"JIRAUSER10000",
"fields":[{
"departmentNumber":"123456"
}]
}]
}]
}
To easily find a userKey you can send one of the following requests to the Jira REST API:
GET /rest/api/2/group/member?groupname=jira-software-users
GET /rest/api/2/user?username=jsmith
If you can’t find the answer you need in our documentation, raise a support request.