Configure an incoming link
When you configure an incoming link with an external application, you allow this application to access Confluence data, which means that Confluence acts as the OAuth provider. To learn more about the type of links and additional details, see Linking to Another Application.
Before you begin
If you’re creating an OAuth 2.0 integration and want to use Confluence as the provider, you can find the details of our OAuth 2.0 implementation in Confluence OAuth 2.0 provider API.
You can configure additional details using system properties.
Create an incoming link using application links
To create an incoming link:
Go to Administration
> General Configuration > 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:
Read
Write
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, Confluence 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 Confluence. 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 > General Configuration > Application links.
- Find the application link you’re interested in, and select More actions > View credentials.