PagerDuty
- 03 May 2023
- 2 Minutes to read
- Print
- DarkLight
- PDF
PagerDuty
- Updated on 03 May 2023
- 2 Minutes to read
- Print
- DarkLight
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
This guide will teach you how to set up the connector between PagerDuty and Clarity Security.
Estimated time to complete: 10 minutes
If you encounter any problems, please contact your support team or support@claritysecurity.io.
Supported Connector Capabilities
Below are capabilities supported by the connector at this time.
Method | Supported |
|---|---|
Provision User | Yes* |
List Groups, Policies, and Roles | Yes |
Add User to Groups, Policies, and Roles | Yes |
Remove User from Groups, Policies, and Roles | Yes |
Deactivate User | No |
Delete User | No |
* An invitation is sent to the user(s)
Before you begin:
Create a service account in PagerDuty to manage the API credentials. This account must have all permissions listed under People and Create and Manage Connectors under Connector.
How to Setup the Connector
Step 1: Log in to PagerDuty
https://app.pagerduty.com
Step 2: Click Integrations > Developer Mode
Step 3: Click Create New App
Step 4: Fill out the Build an App form
DO NOT Create a Permanent access token
Step 5: Configure the Application
- Select an available partner app: PagerDuty
- Access via: API
- client_id: Copy and paste your Client ID from Step 4
- client_secret: Copy and paste your Client Secret from Step 4
- serviceName: App\Services\Integrations\PagerDutyService
- Unique Identifier: PagerDuty
If you are connecting Clarity Security to multiple PagerDuty environments, change the Unique Identifier field to reflect the specific environment this connector is communicating with.
- Sync Options: Hourly
We recommend Hourly syncing. This controls how often our platform reaches out to PagerDuty to pull the current state of users and entitlements. More frequent syncing ensures provisioning events outside the Clarity platform are identified and logged.
- What is the provisioning method for this app?: OAuth
- Deactivate users on termination: Optional - selection recommended
- Delete users on termination: Optional - business decision
Deactivation will deprovision the user(s) but retain the user(s) information. Some organizations have audit requirements that prohibit any deletion of account information.
Deletion will completely remove the user account.
- This is our HR Application: Ignore, do not select.
https://YOUR_TENANT.claritysecurity.io/application/oauthProcessCode/PagerDuty
Step 6: Log in to Clarity Security
Step 7: Click On Applications and select Marketplace
Step 8: Search for PagerDuty and click Connect
Step 8: Fill out the Connect App form
Details for fields common to all applications can be found in the following article: Common App Configuration Steps.
Step 9: Fill out the App Settings form
.png?sv=2022-11-02&spr=https&st=2024-07-06T12%3A50%3A10Z&se=2024-07-06T13%3A00%3A10Z&sr=c&sp=r&sig=EWaWUqq4DxvH4HvxsmijMfcaXk8yWtjKWM2JAdvXHj8%3D)
Step 10: Fill out the User Settings form
.png?sv=2022-11-02&spr=https&st=2024-07-06T12%3A50%3A10Z&se=2024-07-06T13%3A00%3A10Z&sr=c&sp=r&sig=EWaWUqq4DxvH4HvxsmijMfcaXk8yWtjKWM2JAdvXHj8%3D)
The table at the top of this article lists this connector's supported and unsupported features.
Step 11: Validate Your Selections and Save
Save
Clicking the Save button will trigger the first full sync for your application (even if you selected Manual syncing). This includes Service Users, Entitlements, Service User Entitlements, Service User Attributes.
Need Help?
If you have any problems, contact your customer success team. You can also get in touch with our general support via email, open a support ticket. Our general support team is available Monday - Friday from 8:00 AM - 6:30 PM CST.
Was this article helpful?
