Salesforce
  • 13 Nov 2024
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Salesforce

  • Dark
    Light
  • PDF

Article summary

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

Estimated time to complete: 15 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

No


How to Setup the Connector

Step 1: Log in to Salesforce

Step 2: Click the Gear icon and then Setup

Gear - Setup for current app

Step 3: Search for App Manager

Search bar - app manager

Step 4: Click New Connected App

Lightning Experience App Manager - New connected app

5: Select Create a Connected App

6: Configure the new Connected App

  • Connected App Name: Descriptive Name for the App

  • API Name: Auto-filled

  • Contact Email: Email address

  • Contact Phone: Optional

  • Logo Image URL: Optional

  • Icon URL and Info URL: Optional

  • Description: A helpful description for the application.

Step 7: Configure OAuth Settings

You will need to check the Enable OAuth Settings box to see the following configuration options.

  • Enable OAuth Settings: CHECK

  • Callback URL: https://YOUR_TENANT.claritysecurity.io/application/oauthProcessCode/salesforce

  • Selected OAuth Scopes: Add the following

    • Full access (full)

    • Perform requests at any time (refresh_token, offline_access)

  • Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows: UNCHECK

  • Require Secret for Web Server Flow: UNCHECK

  • Require Secret for Refresh Token Flow: UNCHECK

Click the Save button to complete the App creation

Step 8: Click Continue when prompted

New connected app Continue prompt

Step 9: Retrieve the Consumer Key and Consumer Secret

From the App page, locate and click the Manage Consumer Details button.

On the resulting page, copy and temporarily store the Consumer Key and Consumer Secret for use in later steps.  Then click the Back to Manage Connected Apps button in the top right.

Staged Consumer Details

Do Not click on any of the button at the bottom of this page, you may invalidate the keys you just generated/copied.

Step 10: Log in to Clarity Security

https://your-tenant.claritysecurity.io/

Step 11: Click On Applications and select Marketplace

Applications Marketplace

Step 12: Search for Salesforce and click Connect

Salesforce App Connector

Step 13: Fill out the Connect App form in Clarity

  • client_id: This is the Consumer Key from Step 9.

  • client_secret: This is the Consumer Secret from Step 9.

Common App Configuration Steps - Step 1

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

Step 14: Fill out the App Settings form

Configure App Step 2 - App Settings

Step 15: Fill out the User Settings form

Configure App Step 3 - User Settings

Step 16: 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.