This documentation relates to Gadgets and Dashboards 3.0.x
If you are using an earlier version, please view the previous versions of the Gadgets documentation and select the relevant version.

This page provides an introduction to the 'service providers' list of an Atlassian application's OAuth administration page. It also shows you how to add other applications as service providers to your Atlassian application and how to edit or remove existing service providers.
(info) You should be familiar with Atlassian's implementation of the OAuth protocol (refer to the Introduction to OAuth) before reading the information on this page.

On this page:

The 'Service Providers' page contains a list of OAuth-compliant applications whose resources can be accessed by your Atlassian application. If a prospective service provider issues you with consumer key and shared secret to access their application's resources via OAuth, you can add these service provider details using the Service Providers page, thereby establishing an OAuth relationship between your application as a consumer and their application as a service provider.

Establishing OAuth relationships between Atlassian applications


Atlassian applications do not issue shared secrets. Hence, if you wish to establish an OAuth relationship between two Atlassian applications, do not use the 'Service Providers' page.

Instead, the administrator of a prospective Atlassian service provider application will need to add your Atlassian application as a consumer of their application's resources. To do this, you can provide the service provider's administrator with your Atlassian application's URL. To add your application as a consumer, the service provider's administrator will then need to enter this URL into the Consumer Base URL field of their application's OAuth Consumers page.

If this approach does not work, or your application is not an Atlassian application, you will need to provide the service provider's administrator with your application's consumer key and public key (or self-signed certificate). To add your application as a consumer, the service provider's administrator will then need to manually enter these details on their application's OAuth Consumers page.

Upon first viewing your Atlassian application's Service Providers page, you are not likely to see any service providers listed on it (unless there are other administrators of your application who have been adding service providers). On this page, you can add a prospective service provider to your Atlassian application or remove an existing one. It is not possible to edit an existing service provider's details.

Adding a Service Provider of Resources to Your Atlassian Application

The OAuth Service Provider page allows you to add an application as a service provider of resources to your Atlassian application.

To add an application as a service provider of resources to your Atlassian application,

  1. On the 'OAuth Administration' page, click the 'Service Providers' tab if necessary to view your current list of service providers.
  2. Click the 'Add Service Providers' link.
  3. Complete the following fields which relate to the service provider application that you are adding:
    • Service Provider Name — Any descriptive name for the application. This field is mandatory, although the exact wording and format of the application is your choice.
    • Consumer Key — The application's consumer key. This field is mandatory and its contents must match the consumer key supplied by the application.
    • Shared Secret — The share secret supplied to you by the service provider. This secret is used to digitally sign all request tokens sent from your application as a consumer to the service provider. Hence, this information should remain known to you and your service provider only.
    • Description — A short description of the application. By convention, it is useful to include the name of the application and if applicable, its URL, somewhere within the description.
  4. Click the 'Add' button and the service provider is added as a new record into your Atlassian application's service providers list.

At any time, you can click 'Return to Service Provider List' to cancel adding service provider details to your Atlassian application.

Removing a Service Provider of Resources to Your Atlassian Application

In addition to adding service providers, the OAuth Service Provider page allows you to remove existing service providers to your Altassian application.
(warning) Once you remove a service provider application from your Altassian application's service providers list, then your Atlassian application will no longer be able to access that service provider's resources.

To remove a service provider of resources to your Atlassian application,

  1. On the 'OAuth Administration' page, click the 'Service Providers' tab if necessary to view your current list of service providers.
  2. Click the 'Remove' link next to the service provider you wish to remove.
    (info) You will be prompted to confirm this action. Be aware that any tokens which relate to this service provider will be removed and consequently, your application will no longer be able to access your service provider's resources.
  3. The service provider is removed from your Atlassian application's service provider list.

  • No labels