Integrate Atlassian Access with Zero Trust Network Access

In this topic, you will find general instructions on how to integrate Atlassian Access products with Portnox™ Zero Trust Network Access.

In this example, we configured Atlassian Access with Jira and Confluence, but the procedure is the same with other Enterprise apps linked to your Atlassian Access organization.

If this is a new Atlassian installation, before setting up the integration, make sure to do the following:

  • Verify your company domain
  • Claim the accounts for the domain
  • Configure authentication policies for single sign-on

Consult the Atlassian documentation for information on how to perform these tasks, since they are not related to Zero Trust Network Access.

Create a Portnox Cloud application configuration

In this step, you will create a configuration in Portnox Cloud that will contain all the information necessary to integrate with Atlassian Access.

  1. In a new tab of your browser, open your Portnox Cloud account by accessing the following URL: https://clear.portnox.com/

    From now on, we will call this tab the Portnox tab.

  2. In the Cloud portal top menu, click on the Zero Trust Resources option.

  3. On the Resources screen, click on the Create resource button.

    1. In the What type of resource is this? section, select the SSO web application option.
    2. In the Authentication protocol section, select the SAML option.
    3. Click on the Next button.

  4. Optional: If you have more than one SAML identity provider configured, select the identity provider in the Select an identity provider to use for this resource section.
  5. In the Resource details section, enter a Resource name and optionally a Description.

    In this example, we used the name Atlassian for the new application configuration but you can use any name you like.

  6. Keep this browser tab open. You will need it later.

Open the Atlassian Administration portal

In this section, you will access the Atlassian Administration portal and find the settings for identity provider integration.

  1. In another tab of your browser, open your Atlassian Administration portal by accessing the following URL: https://admin.atlassian.com/

    From now on, we will call this tab the Atlassian tab.

  2. In the Atlassian Administration top menu, click on the Security option.

  3. In the left-hand side menu, click on the Identity providers option.

  4. In the Identity providers pane, click on the Choose link in the Other provider tile.

  5. In the Add identity provider directory pane, type the name for the identity provider in the Directory name field, and then click on the Add button.

    In this example, we used the name Portnox Conditional Access but you can use any name you like.

  6. In the Connect your identity provider pane, click on the Set up SAML single sign-on button.

  7. In the Before you begin step, click on the Next button.

Copy configuration values from the Portnox tab to the Atlassian tab

In this section, you will copy the values displayed by Portnox Cloud and paste them in the relevant fields in the Atlassian Administration portal.

  1. In the Portnox tab, in the Service details section, click on the  ⧉  icon next to the Identity Provider Entity ID / Audience URI field to copy the value.

  2. In the Atlassian tab, in the Add SAML details step, click on the empty field next to the Identity provider Entity ID label and paste the value copied from Portnox Cloud.

  3. In the Portnox tab, in the Service details section, click on the  ⧉  icon next to the Sign-In URL / SSO URL field to copy the value.

  4. In the Atlassian tab, in the Add SAML details step, click on the empty field next to the Identity provider SSO URL label and paste the value copied from Portnox Cloud.

  5. In the Portnox tab, in the Certificates > Signing certificates section, click on the  ⋮  icon next to the Active certificate and select the Copy certificate option to copy the certificate.

  6. In the Atlassian tab, in the Add SAML details step, click on the empty field next to the Public x509 certificate label and paste the value copied from Portnox Cloud.

  7. In the Atlassian tab, in the Add SAML details step, click on the Next button.

Copy configuration values from the Atlassian tab to the Portnox tab

In this section, you will copy the values displayed in the Atlassian Administration portal, and paste them in the relevant fields in Portnox Cloud.

  1. In the Atlassian tab, in the Copy URLs to your identity provider step, click on the Copy button next to the Service provider entity URL field to copy the value.

  2. In the Portnox tab, in the Resource properties section, click on the empty field under the Entity ID / Service Provider Entity URL heading and paste the value copied from Atlassian.

  3. In the Atlassian tab, in the Copy URLs to your identity provider step, click on the Copy button next to the Service provider assertion consumer service URL field to copy the value.

  4. In the Portnox tab, in the Resource properties section, click on the empty field under the Assertion Consumer Service (ACS) URL / Reply URL heading and paste the value copied from Atlassian.

Finalize the configuration

In this section, you will finalize the configuration in Portnox Cloud and the Atlassian Administration portal.

  1. Finalize the configuration in the Portnox tab.
    1. Optional: Click on the Next button, and in the Policy enforcement section, in the Device risk assessment section, change the setting to Override with custom policy and then select a risk assessment policy if you want to assess risk with this application using a custom risk assessment policy, and in the Access control section, change the setting to Override with custom policy and then select an access control policy if you want to control access to this application using a custom access control policy.
    2. Scroll all the way down to the end of the page, and then click on the Add resource button.

  2. Finalize the configuration in the Atlassian tab.
    1. In the Copy URLs step, click on the Next button.

    2. In the Link domain step, select your domain in the Link domain field, and then click on the Next button.

    3. In the Save and continue step, click on the Set up provisioning button.

    4. In the Set up provisioning wizard, accept the default choices or configure provisioning as needed, depending on your Atlassian configuration.

Result: You have configured Atlassian to be accessible using Portnox Zero Trust Network Access.