PagerDuty
  • 03 May 2023
  • 2 Minutes to read
  • Dark
    Light
  • PDF

PagerDuty

  • Dark
    Light
  • PDF

Article summary

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

PagerDuty landing page

Step 3: Click Create New App
My Apps - Create New App

Step 4: Fill out the Build an App form

Build an App

DO NOT Create a Permanent access token

Step 5: Configure the Application

Configure App form

  • 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

Oauth 2.0 Redirect URL

New client secret

Step 6: Log in to Clarity Security

Step 7: Click On Applications and select Marketplace

Applications Marketplace

Step 8: Search for PagerDuty and click Connect

PagerDuty App Connector

Step 8: Fill out the Connect App form

Common App Configuration Steps - Configure App

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

Configure App Step 2 - App Settings

Step 10: Fill out the User Settings form

Configure App Step 3 - User Settings

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?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.