Configure an outgoing link

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

When you configure an outgoing link to an external application, Confluence requests data from this application, which means that it acts as the OAuth client. To learn more about the type of links and additional details, see Linking to Another Application.

You need to ensure the following:

To create an outgoing link:

  1. Go to Administration  > General Configuration > Application links.

  2. Select Create link.

  3. Select External application, and then choose Outgoing as the direction.

  4. Fill in the details as described in the sections below.

Follow these steps to configure your link.

Choose one of the following providers that you want to configure. For Google or Microsoft, some of the fields will be pre-filled.

  • Google

  • Microsoft

  • Custom (for internal tools or other providers)

Copy the Redirect URL and register it in your external application to obtain the client ID and client secret required to complete the configuration.

If you’re using Google or Microsoft as service providers, you’ll be able to copy the Redirect URL right away. For custom providers, you need to first provide the Authorization endpoint and Token endpoint. For more info on registering the URL with Google or Microsoft, see:

Different providers might have different requirements related to the redirect URL. For example, Google does not allow it to be a private IP address. Make sure you provide an external URL (for example of a load balancer for Data Center).

Provide the remaining details. Here you can find descriptions for all the fields:

Name

Description

Client ID

The client ID generated by the external application after registering Confluence’s Redirect URL. This is the public identifier of the application.

Client secret

The client secret generated by the external application after registering Confluence’s Redirect URL. This is the shared secret between Confluence and the application, which ensures the authorization is secure.

Scopes

The required OAuth 2.0 scopes (permissions) that control what Confluence can do in the external application.

Authorization endpoint

The HTTPS URL where authorization to use OAuth 2.0 is started.

Token endpoint

The HTTPS URL where refresh token requests are sent. As OAuth 2.0 tokens have an expiry, Confluence will periodically update the token.

Redirect URL

The Redirect URL that must be registered in the external application to obtain its client ID and client secret. This redirects the authentication flow back to Confluence.

After you save the link, it will appear on the list together with other application links.

I fail to get an OAuth 2.0 refresh token

Last modified on Jul 6, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.