Preparing for the Integration
Setting Up Service Accounts
Before initiating an integration with Getint, one critical step is to prepare and set up Service Accounts in the systems you plan to integrate. Service Accounts act as the bridge through which Getint accesses and synchronizes data between different platforms. Here’s a guide on how to effectively prepare these accounts:
Choose the Right Account Type:
Opt for dedicated Service Accounts rather than personal user accounts. Service Accounts are designed to facilitate automated processes and integrations, ensuring uninterrupted service and more controlled access.
Comments are added as the user you chose to create the connection. Therefore, we recommend using a dedicated Service Account for this purpose. While there is no technical possibility of adding comments as the original authors, you can still map the assignees. However, issues, incidents, and tasks will be created, and comments will be attributed to the user who established the connection.
Example of a comment that was synced with Getint: [Author: Radek, Created on: 2024-08-12T12:53:21.711+0000] [Origin: DEMO-346, Comment ID: 26888].
Although comments are still attributed to the integration account, the footer includes additional details such as the original author, creation date, the task that triggered the comment, and the comment ID. It’s an industry standard to add comments as one, the default user, but Getint adds the information about the original commenter and the original date of the comment in the footer, which is not an industry standard.
How to Create a Jira Service Account
Atlassian now provides native Service Accounts that are ideal for integrations like Getint. These accounts do not consume a standard user license and are purpose-built for API interactions.
Why use a Service Account?
Security: Avoid sharing personal login credentials.
Continuity: Integrations won't break when individual passwords change or when users are deactivated.
Audit Trails: Easily distinguish between actions performed by company users and those performed by Getint.
Permission Control: Only grant the specific access required for the integration.
Creating a Service Account
To begin, you need to define the account within your Atlassian Organization.
Log in to admin.atlassian.com.
Select your Organization from the list.
Navigate to Directory > Service accounts.
Click Create service account.
Enter a Name (for example,
Getint-Sync-Bot) and an optional Description.Select the user role for the service account in Jira.
Click Create.
Generate Authentication Credentials
Service accounts cannot log in via a browser UI. You must use an API Token with classic or granular scopes.
OAuth 2.0 isn't supported yet.
Creating an API Token
Go to Directory > Service accounts and select your account.
Click More actions (•••) > Create credentials.
Select API token and click Next.
Name your token: Use something descriptive like
Production-Sync-Token.Set Scopes: To know the necessary permissions to connect with Getint, please click here.
Set Expiration: Choose a duration (1–365 days) that aligns with your security policy.
Copy & Save: Copy the token immediately. You will not be able to see it again.
Your service account is now ready for use with Getint.
Document and Maintain:
Keep a record of the Service Accounts you've created for integration purposes. Document their purpose, associated systems, and any relevant details.
Regularly review and maintain these accounts. Update credentials periodically and ensure they’re in line with your organization's security policies.
Test the Accounts:
Before finalizing the integration setup, test the Service Accounts to ensure they have the appropriate level of access and can perform all intended functions successfully.
If you're setting up a service account to synchronize Jira with tools like Azure DevOps, ServiceNow, Asana, and so on, check out our Integration Guides or reach out to our Getint support team.
Last updated
Was this helpful?