Troubleshoot the DVCS Connector
When opened in a viewport, the user will be redirected to: Troubleshoot connections with Jira Software.
Use the following table to troubleshoot Bitbucket Cloud issues with the connector.
Issue | Cause | Solution |
---|---|---|
The list doesn't contain all the repositories; private repositories are missing. | The connector does not have permission to access private repositories. | Use the Reset OAuth settings option to see which account authorized the access. Then, use the DVCS provider to review and, if necessary, change that user's account access. |
The authentication failed. | The OAuth key and secret are invalid. | Verify that the OAuth key and secret are correct. |
The Cloud account doesn't work. | Someone accidentally deleted the OAuth key and secret from the Bitbucket account. |
|
Repository linking problem. The post commit service could not be installed. | The connector does not have administration permission to the repository. | Use the Reset OAuth settings option to see which account authorized the access. Then, use the DVCS provider to review and, if necessary, change that user's account access. |
| ||
The restriction on number of post commit services on the repository was reached. |
| |
"Invalid credentials, please reset OAuth settings" message appears beside the organization. | The connector lost permissions to access the organization. | Use the Reset OAuth settings option to see which account authorized the access. Then, use the DVCS provider to review and, if necessary, change that user's account access. |
If the DVCS provider revoked the access token, regenerate the access token using Reset OAuth settings option. | ||
SmartCommits don't work. | The email address cannot be found in Jira Software. | Update email for either Jira Software user or DVCS user. |
The are multiple Jira Software users with the same email address. | Each user's email must be unique in Jira Software for smart commits to work. | |
The user's email on Bitbucket is different from the user's email in Jira Software. | The email address associated with the user in Bitbucket must also match the address associated with the user in Jira Software. | |
User doesn't have permission to log work. | Grant user permission to log work in Jira Software. | |
The invitation from Bitbucket was not sent. | An invalid or incorrect email was set for the user. | Create an invitation from Bitbucket:
|
The user has not logged into Jira Software yet. | Ask user to log in to Jira Software. | |
Everything is set up correctly, but the email hasn't arrived. |
| |
The groups cannot be downloaded. | The connector does not have administration permission to the account. | Use the Reset OAuth settings option to see which account authorized the access. Then, use the DVCS provider to review and, if necessary, change that user's account access. |
The screen for changing the password for a DVCS account is inaccessible. | Password-based authentication for DVCS accounts has been deprecated | Follow the steps in Migrating DVCS accounts from password-based authentication to OAuth authentication to get your DVCS accounts authenticating using OAuth |
Bitbucket Cloud
Reset OAuth Settings for
Resetting the OAuth token can resolve some of the issues that arise with the DVCS connector.
There are 2 stages to this:
1. Generate the new token
Generate a new token in either Bitbucket or GitHub, depending on which DVCS hosts your repositories:
2. Reset OAuth settings in Jira Software
Add your new token to your DVCS account:
- Navigate to the 'DVCS accounts' section in Jira Software administration.
- Click the 'cog' icon (B in the screenshot above) for your repository and choose Reset OAuth Settings.
- Replace the existing Key and Secret with the new values generated in step 1 above.
- Click Regenerate Access Token.
- Close the window.
After you have confirmed that the new connection works you can go back to your Bitbucket team or account settings and remove the old consumer.