- Working with synchronized data
- Presenting synchronized data
- Using synchronized data in workflow
- Using synchronized data in JQL
- Using synchronized data in notification
Last updated Mar 10, 2022
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.
Info
For more information on using REST API in Jira, see official Atlassian documentation.
/rest/intenso/ad/1.0/public/connection
Request
| Short description | Syntax |
|---|---|
| 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
| Short description | Syntax |
|---|---|
| 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
| Short description | Syntax |
|---|---|
| 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
| Short description | Syntax |
|---|---|
| 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
| Short description | Syntax |
|---|---|
| Update user’s data or connection details | PUT /rest/intenso/ad/1.0/public/update |
Sample output
Note
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"
}]
}]
}]
}
Tip
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-usersGET /rest/api/2/user?username=jsmith
Need help?
If you can’t find the answer you need in our documentation, raise a support request.