Atlassian Cloud OAuth Single Sign-On (SSO) AWS Cognito

Download And Installation

• Log into your Jira instance as an admin.
• Navigate to Apps → Explore more apps from the header menu.
• Next, search for the miniOrange OAuth/OpenID SSO app.
• Click on Try it free to begin a new trial of the app.
• On the menu bar click on Apps and locate the OAuth/OpenID SSO app and click .

Part 1: Setup miniOrange with Atlassian Access

Step 1. Setup miniOrange as an Identity Provider

• Login into miniOrange Admin Console.
• Go to Apps and click on the Add Application button.

• In Choose Application Type click on Create App button in SAML/WS-FED application type.

• Search for Atlassian Cloud (SAML) in the list.

• Enter the following values in the respective fields, you will receive these values after creating an app in Atlassian access. Refer this step.

• Custom Application Name	Any name would be fine
  SP Entity ID or Issuer	You will receive after configuring Atlassian Access App
  ACS URL	You will receive after configuring Atlassian Access App

• Also make sure that Sign Response & Sign Assertion both options are turned ON. Then click on the Save button.
• Once the App is successfully Created, Select that App and then click on Metadata option to get app’s Metadata.

• Since we are using miniOrange as a Brokering Service in this solution, Go to Information required to authenticate via external idp section as highlighted, and Click on Show Metadata Details.

• After clicking on the Show Metadata Details button you can see the metadata details.
You will need these details while configuring an Atlassian Access app.

• In the left sidebar hover on Users then click on Users List

• Click on Add User and enter details to enforce Single Sign On(SSO) on that user.

Make sure that the user created here will also exist in the Atlassian Cloud.

Step 2. Setup Atlassian Cloud

• Now login to Atlassian Cloud Admin Console.
• Select your organization and then select the Security tab. Click on SAML Single Sign-On from the left sidebar.

• You can click on Instructions for different Identity Providers. It provides a help page for specific IDP and Attribute Names for Attribute Mapping.

• Here you will get the SAML Configuration Instructions for different identity providers as listed. Click on Got it.

• Click on Add SAML Configuration.

• You will be redirected to the Add SAML Configuration window. Enter IDP Entity ID, SSO URL and the public certificate. Click on the Save Configuration button.
You will get these details in the metadata details section after configuring the miniorange app. Refer this step

• Now you will be shown SP Entity ID & SP ACS URL as shown below. These details will be needed in miniOrange app configuration. Now set up the Authentication Policies by clicking on the View Authentication Policies.

• Click on Add Policy.

• Enter the policy name and add the policy.
• Now under Single Sign-On, click on Enable Single Sign-On.

• Then click on the Members tab besides the settings tab and click on Add Members.
The Single Sign On(SSO) will work only for Added Members.

• Enter details and click on Add Members.
The user must be present in both Atlassian and miniOrange.

Step 3. Test Atlassian Cloud - miniOrange Configuration

• Go to Atlassian Login Page.
• Enter email and click on Continue. Then you will be redirected to miniOrange Login Page
• After logging into miniOrange, you will be successfully logged into Atlassian Cloud Dashboard

Part 2: Setup miniOrange with AWS Cognito

Step 1. Configure miniOrange as SP in AWS Cognito

Obtain the following steps to get callback url.

• Go to miniOrange Admin Console.
• From the left navigation bar select Identity Provider. Then, click on Add Identity Provider button.

• You will get the callback URL here, keep it handy this would be required in next steps.

• Sign in to AWS Amazon.
• Now enter “Cognito” in search textbox & select Cognito from dropdown.



• Go to “Manage your user pools”.



• Click on “Create a user pool”.



• Add pool name and select “Review Defaults”.



• Click on “Add app client” & then click on Add an app client.



• Enter App client name & then Click on “Create app client”.



• Click on Return to pool details. After this click on “Create Pool”.
• Navigate to App client settings.
• Now go to the Cognito dashboard and select “Cognito User Pool”, add callback URL here.
• Add application home page URL has to Sign out URL.
• Also, select Authorization code grant as “Allowed OAuth Flows” & select OpenID as “Allowed OAuth Scopes”.
• After selecting all details click on Save changes button.



• Go to “App client” and click on “Show details” to get a client ID and client secret. (Keep client ID and client secret handy as you will need it later.)



• Go to domain name and enter a domain name for your app. After adding domain name you can check its availability by clicking on “Check availability” button. After entering valid domain name click ”Save changes” button.



• Complete domain name: The complete domain name that you need to enter in miniOrange dashboard is {your domain name}.auth.{region name}.amazoncognito.com
• Add Users / Groups to Cognito App : Go to Users and groups and then click on Users. After this click on Create user.



• Fill all required informations and click on Create user.



• Click on Groups and then click on Create group.



• Fill all required informations and click on Create group.

Step 2. Configure AWS Cognito in miniOrange.

• Go to miniOrange Admin Console.
• From the left navigation bar select Identity Provider. Then, click on Add Identity Provider button.


• Select OAuth


• Enter the following values.

IdP Name	Custom Provider
IdP Display Name	Choose appropriate Name
OAuth Authorize Endpoint	https://{cognito-app-domain}/oauth2/authorize
OAuth Access Token Endpoint	https://{cognito-app-domain}/oauth2/token
OAuth Get User Info Endpoint (optional)	https://{cognito-app-domain}/oauth2/userInfo
Client ID	This value can be obtained from the above steps
Client secret	This value can be obtained from the above steps
Scope	openid

• Now you can click on Save.

Step 3. Test connection between miniOrange and AWS Cognito

• Go to the miniOrange Admin Dashboard.
• Go to Identity Providers tab. Then click on select button under the app you just created. Then click on Test Connection.
• A new popup login window will open. Enter your credentials and login.

• Now you will see TEST SUCCESSFUL in a new popup window. If not, then check if you have missed any of the above step.

Exclusive features other miniOrange cloud app provides