Jira is a prominent SaaS platform known for its cloud-based project management and issue tracking software. Jira offers a comprehensive solution for management, collaboration, and workflow automation. Teams and organizations of all sizes widely use Jira to plan, track, and manage their work efficiently.
Integrating Jira with ManageEngine ADManager Plus provides organizations an efficient and streamlined solution for user lifecycle management. By leveraging Jira's features and ADManager Plus' automation capabilities, organizations enhance productivity, foster collaboration, and ensure accurate employee data management across their IT infrastructure.
Ensure consistent and up-to-date user information across platforms, eliminating the need for manual data management and reducing the risk of errors in user account management.
Advanced reports
Comprehensive reporting and auditing capabilities, enabling IT administrators to track user activities, monitor changes, and generate compliance reports.Actions supported
Integrating ADManager Plus with Jira enables IT admins to:
|
|
How to integrate ADManager Plus and Jira
In ADManager Plus, navigate to the Automation tab and click HCM Integrations.
Under HCM applications, click on the Custom HCM tile to integrate a new custom HCM solution.
In the Custom HCM Integration window that displays, enter a suitable Name, Description and upload a logo of Jira and click Save.
Click on the Jira tile added in the previous step to configure the API authorization methods, endpoints and LDAP data mapping.
In the Authorization section, select OAuth 2.0 as the Authorization Type.
Header Prefix: Specify a prefix value for your authorization header.
OAuth 2.0 Grant Type: The Authorization code is the default grant type.
Note: The client's credentials grantType is also supported.
Callback URL: You will be redirected to the Callback URL after authentication. This should be registered with the API provider.
Auth URL: Specify the Authorization Endpoint URL.
Access Token URL: Enter the OAuth server URL where the application can exchange the Authorization code for an Access Token.
Client ID and Client Secret: Enter a valid ID and its secret key.
Scope: Specify the data you would like to access.
- Click Advanced Options and choose the headers and query parameters from the Add To drop-down menu.
6. In the API Endpoint Configuration section, add the following:
Endpoint URL: https://api.atlassian.com/ex/jira/{cloudid}/{api}
Note: Click here to view Jiras' API references.
Click Advanced Options to add headers and parameters.
Method: Choose Get.
Headers: Click and configure the respective HTTP headers as configured in the endpoint.
Parameters: Cick and configure the query parameters as configured in the endpoint.
Message type: Select None.
Check the Repeat calling this Endpoint box to continually call the API until you get the required response. From the drop-down menu, select the parameter and specify the increment value. You can also set a condition which, when satisfied, calls the endpoint repeatedly.
Note: You can configure multiple endpoints for a HCM solution.
Once finished, click Test & Save. A response window will display the requested elements.
Click Data Source - LDAP Attribute Mapping to match endpoints and to map AD LDAP attributes with the respective attributes in the HCM solution.
Enter the Configuration Name and Description, and select the Automation Category from the drop-down menu.
In the Select Endpoint field, choose those columns that are unique to users (employeeIdenifier, username, etc.). The values in these columns should be consistent across all the endpoints.
In the Attribute Mapping field, select the attribute from the LDAP Attribute Name drop-down menu and map it with the respective column in the HCM solution.
Click Save.
Steps to configure new app integration in Jira
2. Select Create and choose OAuth 2.0 integration.
3. Enter an application name and check the terms and conditions box.
4. Click Create.
Steps to set permissions in Jira
Navigate to Jira api documentation (developer.atlassian.com) > Profile > Developer console.
Select My apps and choose the application you have integrated.
From the left pane choose Permissions.
Click Configure next to Jira API and set the required permissions.
Steps to generate the client ID and the secret in Jira
Navigate to Jira api documentation (developer.atlassian.com) > Profile > Developer console.
Select My apps and choose the application you have integrated.
From the left pane choose Settings.
Copy the Client ID and Secret values and paste the generated values in the required field.
Steps to set the Redirect URI in Jira
Navigate to Jira api documentation (developer.atlassian.com) > Profile > Developer console.
Select My apps and choose the application you have integrated.
From the left pane choose Authorization.
Paste the Callback URL from ADManager Plus in the Callback URL field.
Sample Postman configuration to get access token
Navigate to Postman (https://www.postman.com).
Fill in all the required parameters and click Get New Access Token.
3. Once you click Get New Access Token, you will be redirected to the JIRA login page.
4. Log in with your Jira credentials and complete the authentication process.
5. After successful authentication, the server will respond with Status code 200 if the credentials are valid. The response will include the access token and its expiry time, along with a refresh token if offline_access is specified.
Here's an example of API integration to retrieve all users.
Method : GETAPI : https://api.atlassian.com/ex/jira/{cloudid}/rest/api/3/users
Sample Response:
[
{
"accountId": "63f7300240328c12e4ed4ab7",
"accountType": "atlassian",
"emailAddress": "zykokepo@lyricspad.net",
"avatarUrls": {
},
"displayName": "Baskar",
"active": true,
"locale": "en_US"
},
{
"accountId": "63f74dca40328c12e4ed55d7",
"accountType": "atlassian",
"avatarUrls": {
},
"displayName": "jenish",
"active": true,
"locale": "en_US"
},
]