Authenticate with OAuth2

OAuth2 allows you to authenticate with remote web services

What is OAuth 2 ?

OAuth is a standard for authorisation. In short, it allows you authorise an access to a third party cloud service without having to provide your login and password to your local system.

nFeed supports OAuth 2.0, which is also supported by many cloud services such as those provided by Google, Salesforce, Facebook and Microsoft.

With nFeed, you will be able to use these services REST API to get data.

How it works

We will not detail the communication flow here, because this is rather technical and it does not help in the context of this documentation.

All you need to know to setup an OAuth authentication for nFeed is :

  • You will need to create an authorisation on your target service. We will help you as far as we can for that.
  • While creating a new datasource in nFeed, you will have to provide this authorisation.
  • There will be potential redirections from nFeed administration page to your remote service and back to nFeed, to finalise the process.
  • Once your datasource is saved, your authorisation is stored and valid (unless you revoke it).

Quick setup

If you are trying to connect one of the following services REST API, you can go directly to their specific page to follow the instructions step by step:

For other services supporting OAuth2, we don't have specific help page for now. You will need to find out information in the service documentation.

Callback URL

This property can be called Authorised redirect URIs or redirect URI or callback URL, depending on the third party service. This is the following value :

<Your platform base URL>/nfeed/admin/models/datasources/oauth/_callback

Your platform base URL above must be replaced with your own value. The base URL can be found in your JIRA administration in the system information.

For example, if your dashboard URL is :

https://my-server/jira/secure/Dashboard.jspa


Then the callback URL will be :

https://my-server/jira/nfeed/admin/models/datasources/oauth/_callback

Important note about the base URL

The base URL in your system information is the reference. For the authentication to work properly, this base URL must be visible and accessible from the internet.

FAQ

When editing a nFeed field, what authorisation will my JIRA user have on the remote platform ?

When you configure a datasource with OAuth2 in nFeed administration, you grant nFeed access on your own behalf. This access will be shared by everyone using a nFeed field on your JIRA instance.

Every user will have access to the same set of data. Of course, depending on the target system, you can have the possibility to configure the access scope that you gave to nFeed.