Prepare 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.
Why Atlassian Guard Accounts Aren’t Supported?
Before initiating a connection with Getint, we recommend setting up a dedicated account to serve as the integration's service account. This differs from the Atlassian Guard service accounts, as these introduce specific challenges that may limit compatibility:
Authentication Complexity: Atlassian Guard accounts often rely on SSO and SCIM, which complicates token-based or API authentication flows used by most integration tools.
Limited API Exposure: Atlassian’s current APIs don’t fully expose Guard-specific account metadata, making it difficult to identify or manage these accounts programmatically.
Security Constraints: Guard policies may restrict access or require conditional logic that isn’t yet supported by third-party integration platforms.
Pending Atlassian Updates: Atlassian is still evolving its support for Guard service accounts in external tooling, and full compatibility may depend on future API enhancements or policy changes.
Grant Adequate Permissions:
Ensure that these Service Accounts have the permissions to perform required actions in each system. This typically includes creating, updating, and managing tasks or issues.
Admin-level access is recommended for the most comprehensive functionality, although it's not mandatory. The key is that the account can perform all actions required by Getint, like data synchronization and updates.
Secure Account Credentials:
When setting up Service Accounts, secure their credentials (username and password/token). Getint will use these credentials to authenticate and interact with the connected systems.
Treat these credentials with the same level of security as you would for any sensitive access information.
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.
By carefully preparing your Service Accounts, you establish a secure and efficient foundation for the integration process with Getint. This preparation is a crucial step towards ensuring a smooth, seamless integration experience.
Last updated
Was this helpful?