REST API Authentication On Atlassian using Meetup as OAuth Provider

Atlassian provides REST APIs to perform a number of operations such as Create Page, Delete Page, Add Comment, Create Space, etc. However, it supports only two authentication methods for REST APIs:
  1. Basic Authentication
  2. Using OAuth 1.0
The REST API Authentication plugin allows you to use any third party OAuth 2.0 provider/ OpenID connect to authenticate REST APIs. Here we will go through a guide to configure Meetup as Provider.

Download And Installation

  • Log into your atlassian instance as admin.
  • Navigate to the settings menu and Click Manage Apps.
  • Click Find new apps or Find new add-ons from the left-hand side of the page.
  • Locate Api Token/OAuth Authentication app.
  • Click Try free to begin a new trial or Buy now to purchase a license.
  • Enter your information and click Generate license when redirected to MyAtlassian.
  • Click Apply license.

Step 1: Configure Meetup server:

  • Login to Meetup : Go to Meetup API and login to your account.
  • Click on OAuth Consumers tab.
meetup as oauth/openID provider
  • Create application : Click on "Create New Consumer" or "Create one now".
meetup as oauth/openID provider
  • Consumer name : Name of your Meetupapp.
  • Redirect URI : Enter the Application's Base URL.
  • Check "Yes, I agree" checkbox for Platform Terms of Service and click on "Register Consumer".
       NOTE: all the details on the Register OAuth Consumer page are mandatory and need to be filled before clicking on Register Consumer. meetup as oauth/openID provider    
  • Once App is created successfully, you'll see the key and secret of the app.
  • Get Client ID and Client Secret : key is Client ID and secret is client secret.

meetup

Step 2: Fetch Access token through POSTMAN

  • Open the Postman Application (Here is the link to download Postman Application).
  • Go to Authorization tab.
  • From the dropdown select type as OAuth 2.0 and  click on Get access token.
  • Add the following information from the table below.
  • Postman starts the authentication flow and prompts you to use the access token.
  • Select Add token to the header.
Field Value
Grant type Authorization Code or Client Credentials
Callback URL Enter the Application's base URL if you dont have a callback URL
Auth URL https://secure.meetup.com/oauth2/authorize
Access token URL https://secure.meetup.com/oauth2/access
Client ID Enter the Meetup Client ID
Client secret Enter the Meetup  Client secret
Scope Blank
Client Authentication Send client credentials in body
meetup as oauth/openID provider  
  • Copy the Access Token or click on Use Token.
A sample access token from Meetup Provider looks like this.
A834c0606ba71336423013699db8e971

Step 3: Fetch Username through Meetup:

  • Choose the method type as "GET".
  • Enter the interoception Endpoint from the plugin to fetch the username in the Request URL. For Meetup it is "https://api.meetup.com/2/member/self/".
  • Go to the Authorization tab select the Bearer Token and enter the access token here.
  • Add the header "content-type: application/json" and click on Send.
  meetup as oauth/openID provider Request:
     curl 
     -X GET 
     -H "Authorization: Bearer <Access Token>" 
     -H "Content-type: application/json" 
      https://api.meetup.com/2/member/self/
Copy the attribute value against the username, you will need to configure it in plugin. In this example, the value is "name".  

Configure the Rest API plugin:

Step 1: Enable Rest API Authentication:

  • After installing the app, navigate to the Global Settings tab.
  • Here you will have to Enable the Authentication through Enable REST API Authentication and click on Save.
  • Go to the OAuth/OIDC tab and in the dropdown provided select Meetup as the OAuth provider.
  • Enter the attribute value against which we received the username in the Postman response.
  • Save the settings.
meetup as oauth/openID provider

Step 2: Disable Basic Authentication:

  • Disabling this will restrict all the REST API call made using Basic Authentication.
 

Test REST API using access token:

  • Call any REST API. Include the access token in the Authorization header. Here’s an example of fetching content from Confluence.
  • Go to the Postman application select method type as GET and enter the Request URL. For eg. http://{Confluence_Base_URL}/confluence/rest/api/content/
  • In the Authorization tab select type as Bearer Token.
Confluence-Rest-API-Meetup  
  • In the Header tab add the header “content-type: application/json and send the request.
Confluence-Rest-API-Meetup Request:
     curl 
     -X GET  
     -H "Authorization: Bearer <Access Token>" 
     -H "Content-type: application/json" 
     http://{confluence_base_url}/confluence/rest/api/content/
  • This will show the content in Confluence and will return the status 200.
  • If the token is invalid or missing, the call will return a 401 Unauthorized response



If you are looking for anything which you cannot find, please drop us an email on info@xecurify.com