search
Book a demo

screwdriver-wrenchIntegrations troubleshooting

hashtag
Jira integration issues

hashtag
OAuth scopes error when connecting Jira

Symptom: After creating an OAuth app in the Atlassian Developer Console and entering the credentials in SRE.ai, you receive an error related to scopes or permissions.

Cause: The OAuth app in Atlassian requires specific API scopes to be configured before SRE.ai can connect.

Solution:

  1. Go to the Atlassian Developer Consolearrow-up-right

  2. Select your SRE.ai OAuth app

  3. Go to Permissions in the left sidebar

  4. Add the Jira API permission

  5. Configure the following scopes:

    • read:jira-work — View Jira issues and projects

    • write:jira-work — Create and manage issues

    • manage:jira-webhook — Receive webhook updates for story changes

  6. Go to Authorization in the left sidebar

  7. Click Add next to "OAuth 2.0 (3LO)"

  8. Enter the callback URL provided by SRE.ai

  9. Save and return to SRE.ai to retry the connection

hashtag
Jira integration is limited to certain projects

Symptom: After connecting Jira, you can only see or interact with some projects, not all projects in your Atlassian workspace.

Cause: The Jira integration inherits the permissions of the user who created the OAuth app. If that user doesn't have access to certain projects, SRE.ai won't be able to access them either.

Solution:

  1. Have a user with broader project access create the OAuth app, or

  2. Ensure the user who created the OAuth app is granted access to the necessary Jira projects

circle-info

You can create one OAuth app for your entire Atlassian organization. There's no need for a per-project approach.

hashtag
GitHub connection issues

hashtag
Connection works on initial setup, but fails on updates

Symptom: You initially connected GitHub, but when you try to update repository access (adding or removing repositories), the changes don't seem to take effect, or you're not redirected back to SRE.ai.

Solution:

  1. Return to SRE.ai manually: After updating your GitHub app installation settings, navigate back to SRE.ai directly. Your updated repository access should be reflected.

  2. Verify in GitHub: Go to your GitHub organization settings → Installed GitHub Apps → SRE.ai GitHub App to confirm your repository selections were saved.

  3. Reconnect if needed: If the connection appears broken, you can remove the SRE.ai GitHub app from your organization and reinstall it with the correct repository access.

hashtag
Accidentally connected the personal account instead of the organization

Symptom: You connected GitHub, but don't see your organization's repositories, or SRE.ai is connected to your personal repositories instead of your team's.

Solution:

  1. Go to GitHub → Settings → Applications → Installed GitHub Apps

  2. Find the SRE GitHub App and click Configure

  3. If it's installed on your personal account, click Uninstall

  4. Return to SRE.ai and click Connect GitHub Account again

  5. This time, select your organization from the list (not your personal account)

  6. Choose the repositories you want to connect to and complete the installation

Last updated