Configure an incoming link
When you configure an incoming link with an external application, you allow this application to access Bitbucket data, which means that Bitbucket acts as the OAuth provider. To learn more about the type of links and additional details, see Link to other applications.
Before you begin
If you’re creating an OAuth 2.0 integration and want to use Bitbucket as the provider, you can find the details of our OAuth 2.0 implementation in Bitbucket OAuth 2.0 provider API.
You can configure additional details using OAuth 2.0 provider system properties.
Create an incoming link using application links
To create an incoming link:
Go to Administration > Applications > Application links.
Select Create link.
Select External application, and then choose Incoming as the direction.
Fill in the details as described in the sections below.
Provide application details
In this type of link, you only need to provide the Redirect URL (also known as Callback URL) from your external application. After authorizing the application, the user will be redirected to this URL with the authorization code.
Provide application permissions
Select permissions the application can have on your instance. You can choose the following permission scopes:
| Account | Repositories | Projects | Admin | System admin |
|---|---|---|---|---|
|
|
|
|
|
Note that even if you grant higher permissions, the application won’t be able to do more than the user authorizing it. For more info on what each of these scopes do, see OAuth 2.0 scopes for incoming links.
Copy OAuth credentials to the application
After providing the Redirect URL and selecting the scopes, Bitbucket will generate the OAuth credentials that include these details. You need to copy the credentials to your external application to complete the link.
At this point, the application link has already been created in Bitbucket. You can view its details in Application links, including the OAuth credentials in case you needed to access them later.
View OAuth credentials for an existing link
If you lose your OAuth credentials, you can access them any time in the details of the application link you created.
To view OAuth credentials:
Go to Administration > Application links.
Find the application link you’re interested in, and select More actions > View credentials.