ServiceNow
  • 03 May 2023
  • 3 Minutes to read
  • Dark
    Light
  • PDF

ServiceNow

  • Dark
    Light
  • PDF

Article summary

This guide will teach you how to set up the connector between ServiceNow and Clarity Security.

Estimated time to complete: 30 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
Yes
Delete User
Yes

How to Setup the Connector

Step 1. Log into ServiceNow.

Note: Copy this URL, Which will be used when connecting the application to Clarity.

Step 2. Click the All dropdown > search for the word 'organization' > click on Users.

Step 3. Click New to create a new user.

Step 4. Fill in the form to create the service user account.

User ID: clarity_service_account

First name: Clarity 

Last name: Service Account

Verify that the Active box is checked.

Check the box for Web services access only.

Once completed, click Submit.

Copy the User ID, which will be used when connecting the application to Clarity.


Step 5. After creating the service account, you'll be redirected back to the Users table.

Step 6. Search for the created service account clarity_service_account by User ID and click the User ID.

Step 7. Click Set Password to generate a password for the service account.

Step 8. Generate a new password. 

Click the Generate button to generate a unique password.

Click the copy icon button to copy the password to your clipboard.

Click the Save Password button.

Click the Close button once done.

Copy the Password, which will be used when connecting the application to Clarity.

Step 9. At the bottom of the service accounts profile, there will be a table with tabs. Verify that you're in the Roles tab, then click the Edit button.

Step 10. In the Collection search box, search for the role user_admin. Click the right arrow button to add the role to the user. Once completed, click Save.

Step 11. After saving the user_admin role to the service account, you'll be redirected to the profile page. 

Step 12. Click the user_admin role link in the Roles tab to access the role settings.

Step 12. Click on the Modules with Role tab and verify that the following tables are accessible, as shown in the image below. 

Step 13. Log into Clarity Security.

Step 14. Click on Applications and select Marketplace.

Applications > Marketplace

Step 15. Scroll to find ServiceNow and click Connect.

Step 16. Fill out the Connect App form with the proper credentials. 

Complete the App Settings form.  Details for fields common to all applications can be found in the following article: Common App Configuration Steps.

api_url: Paste the URL that was copied from Step 1.

username: Paste the username from Step 4.

Password: Paste the password from Step 8.

Step 17. Fill out the App Settings form.

Complete the App Settings form.  Details for each field can be found in the following article: Common App Configuration Steps.

Configure App Step 2 - App Settings

Step 18. Fill out the User Settings form.

Complete the User Settings form, and check the table at the top to see if any features are unsupported.  Details for each field can be found in the following article: Common App Configuration Steps.

Configure App Step 3 - User Settings

Step 19. 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.