<img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=344430429281371&amp;ev=PageView&amp;noscript=1">

How to Setup Atlassian Access And Integrate With Okta in Less Than 8 Minutes

Posted by Foogie Sim on November 21, 2018

Introduction

Atlassian Access is a new Identity Management on Cloud released just recently, to replace the Identity Manager. It offers seamless integration to SAML identity providers like Microsoft Azure, OneLogin, Okta, and Centrify. 

In this How To article, we will look into how you can setup Atlassian Access and Integrate it with Okta in under 11 minutes

 

Prerequisites

 

Steps 

1.1 Setup and Domain Verification

  1. Sign up for a JIRA/Confluence trial via https://www.atlassian.com . Remember to use your own domain email account to sign up for this trial.
  2. Once the instance is setup and ready, navigate to https://admin.atlassian.com (while being logged in with your own domain email account)
  3. Click on Domains, then click on the HTTPS tab:
    Screen Shot 1 at 1.48.14 PM
  4. Download the atlassian-domain-verification.html file, and upload it to the root of your domain
  5. If you don't have a website to upload html file to, but have access to domain's DNS settings - use DNS option and create a TXT record with provided value:
    image2018-9-21_14-2-0
  6. Click Verify Domain
  7. If all goes well, you should see that your domain is verified!
    Screen Shot 2018-09-20 at 1.51.49 PM
  8. Next, click on SAML Single Sign-on and you should be prompted to sign up for an Atlassian Access account. Just follow the instructions and Atlassian Access should now be enabled in your instance.

 

1.2 Setup Okta

  1. Navigate to okta.com and signup for a trial. You should then land on your user home page.
  2. Click on Admin
    Screen Shot 2018-09-20 at 1.54.05 PM
  3. Then hover over Applications, and click on Applications:
    Screen Shot 2018-09-20 at 1.55.31 PM-2
  4. Click Add Application:
    Screen Shot 2018-09-20 at 1.56.24 PM
  5. Search for the Atlassian Cloud application and hit Add:
    Screen Shot 2018-09-20 at 1.57.31 PM
  6. Label the application appropriately, select the appropriate applications to enable SAML for, and hit Next:
    Screen Shot 2018-09-20 at 2.00.24 PM
  7. In the Sign On Options, choose SAML 2.0. Leave the Default Relay State empty, enter the JIRA and Confluence Base URLs, set the Application Username Format to Email, and click on View Setup Instructions
  8. Scroll to somewhere near the bottom of the Instructions where you will see this:
    Screen Shot 2018-09-20 at 2.07.10 PM
  9. Navigate back to https://admin.atlassian.com , click on the SAML single signon tab, and input the information from the Okta Setup Instructions into the Atlassian screen:
    Screen Shot 2018-09-20 at 2.08.24 PM
  10. Hit Save Configuration in the Atlassian screen, and you should now see the SP Entity ID revealed. Copy the string after the https://auth.atlassian.com/saml/ string:
    Screen Shot 2018-09-20 at 2.10.19 PM
  11. Navigate back to Okta, into the Application configuration and paste the Entity ID copied earlier into the Unique ID field:
    Screen Shot 2018-09-20 at 2.12.14 PM
  12. Hit Done, and your application should be created.

 

1.3 User Assignment

  1. You're almost there! But your users will still not be able to login because they are not assigned yet to the application. To do that, navigate back to the Applications panel:
    Screen Shot 2018-09-20 at 1.55.31 PM-2
  2. Then click Assign Applications
  3. You should then see a screen similar to this:
    Screen Shot 2018-09-20 at 2.16.15 PM
  4. Check the application that you just created, and the list of users you wish to be added to the application. You can also filter this by Okta groups.
  5. Hit NextConfirm Assignments (check the usernames are correct). And voila!

 

1.4 Testing the Integration

In order to test this, simply start a new Incognito browser and navigate to JIRA/Confluence Cloud and enter your email address when prompted. You should be then redirected to login into Okta, which will then log you in automatically to JIRA/Confluence Cloud.

Alternatively, you can also login first to Okta, and then click on any of the Confluence/JIRA chiclets in your user home, which should automatically log you into JIRA/Confluence Cloud

 

For more information contact us, we are ready to help you out

Let us help!

Also do watch the recording of how this is done!

 

Topics: Consulting, Atlassian Platinum Partner, Atlassian Services, Cloud

Subscribe To
Our Newsletter

Interested in writing for the Software Adoption Blog?

We love connecting with software leaders and writers who can help us fulfill our mission to create entertaining AND educational resources that people can put to use.

Find Out How ➝

Recent Posts

Posts by Topic

see all