Apps documentation
Active Directory Attributes Sync
Active Directory Attributes Sync
Documentation
FAQ
Release notes
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-users
  • GET /rest/api/2/user?username=jsmith
Need help?

If you can’t find the answer you need in our documentation, raise a support request.