Jira Connector
Overview
The Jira Splice integrates with the IDHub Connector Application to allow the user to add/modify/revoke different resources in Jira. IDHub Account resource is mapped to Jira User Account which has a list of entitlements associated with the account. IDHUB Entitlement resource contains the list of Group and Project Roles in Jira.
The mapping between IDHUB and Jira is shown in the table below along with operation for each resources.
IDHUB | Confluence | Operation |
---|---|---|
Account | User | List Create Modify Delete Assign Entitlement (PATCH) Revoke Entitlement (PATCH) |
Entitlements | Group
| List Create Modify (NOT in current scope) Delete |
Project Role | List Create (NOT in current scope) Modify (NOT in current scope) Delete (NOT in current scope) |
An Admin account needs to be setup in Jira. A directory needs to be created and that directory ID can be used to call the different provisioning APIs for different Jira resources.
Note : For different operations on Jira resources, the Jira Cloud REST APIs along with the User Provisioning APIs have been used.
Configuration
The configuration of the different resources are explained in their respective sections :
Service Provider Configuration
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:ServiceProviderConfig"
],
"patch": {
"supported": true
},
"bulk": {
"maxPayloadSize": 0,
"maxOperations": 0,
"supported": false
},
"filter": {
"maxResults": 10000,
"supported": true
},
"changePassword": {
"supported": false
},
"sort": {
"supported": false
},
"etag": {
"supported": false
},
"authenticationSchemes": [
{
"name": "OAuth Bearer Token",
"description": "Authentication scheme using the OAuth Bearer Token Standard",
"type": "oauthbearertoken"
}
],
"meta": {
"created": "2018-05-03T19:31:29.723Z",
"location": "https://api.atlassian.com/scim/directory/{directoryId}/ServiceProviderConfig",
"lastModified": "2018-05-03T19:31:29.723Z",
"resourceType": "ServiceProviderConfig"
}
}
Reference Documents
REST APIs For Jira
Jira Server API is used for on-premise application while Jira Cloud API is used for cloud application.
The set of REST APIs for Jira Cloud is available in https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/ , https://docs.atlassian.com/software/jira/docs/api/REST/1000.1517.0/#api
The set of REST APIs for provisioning in Jira is available in https://developer.atlassian.com/cloud/admin/user-provisioning/rest/intro/
The latest Javadoc for Confluence server REST APIs is https://docs.atlassian.com/software/jira/docs/api/REST/7.6.1/
Security details for apps built using Connect is available in https://developer.atlassian.com/cloud/confluence/security-for-connect-apps/
Details for authentication using OAuth is available in https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/, https://confluence.atlassian.com/jiracore/setting-up-oauth-2-0-integration-1005784173.html