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.

/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

{
    "connectionId":"2",
    "update": [{
        "connection": [{
            "name" : "new name",
            "userDn":"new user DN"
        }],
        "data":[{
            "userKey":"JIRAUSER10119",
            "fields":[{
                "departmentNumber":"124567"
            }]
        },{
            "userKey":"JIRAUSER10000",
            "fields":[{
                "departmentNumber":"123456"
            }]
        }]
    }]
}