To reconfigure any of the General Settings or Sign-On Options, uncheck the Enable provisioning features box, and use the Previous and Next buttons to navigate through the configuration screens.
This guide provides the steps required to configure Provisioning for PagerDuty and includes the following sections:
Push New Users
New users created through OKTA will also be created in the third party application.
Push User Deactivation
Deactivating the user or disabling the user's access to the application through OKTA will deactivate the user in the third party application.
Push Profile Updates
Updates made to the user's profile through OKTA will be pushed to the third party application.
Import New Users
New users created in the third party application will be downloaded and turned in to new AppUser objects, for matching against existing OKTA users.
You need to complete the following before you can configure provisioning for PagerDuty:
Generate a new API key from PagerDuty:
Login to your PagerDuty account as an Administrator.
Select API Access from the Configuration menu:
Click Create New API Key:
In Create API Key, enter a description, then click Create Key:
Configure your Provisioning settings for PagerDuty as follows:
Check the Enable API Integration box.
Enter your PagerDuty API Credentials:
API Key: Enter the API Key you generated earlier, see Requirements above, for details.
Admin Username: Enter an admin username with admin or owner permissions.
Select To App in the left panel, then select the Provisioning Features you want to enable:
You can now assign people to the app, if needed (see below).
To assign users to the PagerDuty app:
PagerDuty supports the following 2 attributes with schema discovery:
PagerDuty requires the country code to be a separate value. The PagerDuty integration expects phone numbers and SMS numbers to be in the following format:
For example: +1-202-555-0103 must be provided as +1 2025550103
To use provide mastering you need to convert phone/SMS numbers during mapping, as described below:
To convert the number +1-202-555-0103 to the correct format +1 2025550103, you can use the following mapping:
String.join(" ", String.substring(String.replace(String.replace(user.mobilePhone, "-",""), "+",""), 0,1), String.substring(String.replace(String.replace(user.mobilePhone, "-",""), "+",""), 1,String.len(String.replace(String.replace(user.mobilePhone, "-",""), "+",""))))
Without Schema Discovery
To OKTA: Import the first mobile phone or first SMS as mobilePhone randomly.
To application: Set mobile phone as mobile phone and SMS number on PagerDuty side.
With Schema Discovery
To OKTA: Import phone or SMS numbers as arrays.
To application: Set phone or SMS numbers as array.