You have the ability to set your own custom headers for IssueSYNC requests, which takes care of synchronizing process.
When would you like to use it?
You will set headers per each IssueSYNC connection separately.
To determine the connection and authenticate you will need to send connection name and hashed value of local connection authorization key.
You need to include two headers for each REST call:
Basic auth - please check https://developer.atlassian.com/cloud/jira/platform/jira-rest-api-basic-authentication/
IssueSYNC's connection authorization header:
Example:
Let's assume your Local Authorization Key for connection is "myAuthorizationKey "
{"LocalAuthKey":"23c28e1b85bdfd5f786ee67a51d640b4"} |
Basic Responses:
- everything is ok with your request
- everything is ok with your request, your headers has been created, updated or deleted properly.
- Please check your JSON
- You are not authorized, please verify both of JIRA and IssueSYNC's headers
<status> <status-code>401</status-code> <message>Client must be authenticated to access this resource.</message> </status> |
- Internal server error, please try again or contact your JIRA administrator
URI: /rest/synchronizer/1.0/headers/get/{connectionName}
Headers: you need to include JIRA authorization header and IssueSYNC's connection local key header
Responses:
{status:"OK", headers:{ X-Header-Jira:"token-A", X-Header-Authorize:"token-B", My-Server-Secret-Token:"token-C" } } |
{"Description for given status does not exist"} |
Set headers /rest/synchronizer/1.0/headers/create
URI: /rest/synchronizer/1.0/headers/create
Headers: you need to include JIRA authorization header and IssueSYNC's connection local key header
Request body example:
{connectionName:"{connectionName}", customHeaders:{ X-Header-Jira:"token1", X-Header-Authorize:"token2", My-Server-Secret-Token:"token3" } } |
Responses:
{"Headers created or replaced properly."} |
*Please bear in mind putting new headers will remove old ones.
Delete headers /rest/synchronizer/1.0/headers/delete/{connectionName}
URI: rest/synchronizer/1.0/headers/delete/{connectionName}
Headers: you need to include JIRA authorization header and IssueSYNC's connection local key header
Responses:
{"Operation processed properly."} |