Okta SSO Integration Guide

Okta is a single-sign on provider, which makes it easy to manage your SAAS application logins and permissions. PagerDuty is available within the Okta app catalog, making it easy to manage access to your PagerDuty account. Follow this simple guide to get your Okta account tied to your PagerDuty account.

 

Note

You must be the Account Owner of your PagerDuty account in order to make these changes. Additionally, SSO capabilities within PagerDuty are only available on our Standard and Enterprise plans. Please contact our sales team if you are interested in upgrading your plan.

This integration requires use of our v1 REST API which is currently in a decommissioning period, please contact support to gain access to a v1 REST API key to configure this integration.

For more information about the v1 REST API deprecation take a look at our FAQ here: https://v2.developer.pagerduty.com/v2/docs/v1-rest-api-decommissioning-faq

We are working with partners to upgrade integrations to use our v2 REST API.

 

Start in Okta

      1. You will require Admin access in Okta to set this up. To begin, go to the Applications tab in the Okta Admin dashboard and click Add Application.
      2. Enter PagerDuty in the search box, then click the Add button for PagerDuty on the search results list.
      3. Enter your PagerDuty subdomain in the Organization Subdomain field and click Next.
      4. Click the SAML 2.0 radio button, then click View Setup Instructions. Follow the instructions in the guide that opens, which includes steps to perform in PagerDuty. Make sure the Application username format is set to Okta username. Click Next once you’ve completed the Setup Instructions.
      5. Optional: If you wish to enable Okta’s provisioning features, navigate to the Provisioning tab and then click Configure API Integration. Then check enable API Integration and enter in your V1 REST API key and login email.If you do not have a v1 REST API key, please see the note at the top of this integration guide. Click the button to test the credentials and then click Save when you are done. Okta provides further instructions on Provisioning Users in Okta.

      6. Click on the Assignments tab and then click the Assign button to assign the PagerDuty app to users or groups in Okta.
      7. You’re done! Users that have been given access to PagerDuty will now see the the PagerDuty app in the Okta dashboard and will be able to log in with just one click. Alternatively, users can go to the login page for their PagerDuty subdomain and sign in using Okta by clicking Sign in with your Identity Provider.

    Congratulations! You should now be able to use your Okta to login to PagerDuty!

    FAQ

    Why don’t I see the Single Sign-on option when I go to Account Settings?

    You must be the Account Owner of your PagerDuty account in order to make these changes. Additionally, SSO capabilities within PagerDuty are only available on our Standard and Enterprise plans. Please contact our sales team if you are interested in upgrading your plan.

    I assigned the PagerDuty app to a new user in Okta, but the user can’t log in. Why was their user not created in PagerDuty?

    The most likely cause of this is your Sign On settings. In the Sign On tab in Okta, make sure that the Application username format has Okta username selected, as shown in step 4 of this guide. This will ensure that the user’s login email is filled in as the username when assigning PagerDuty to a new Okta user, as shown below: