Configuring Salesforce connected app - Lightning view
Steps
- Login to Salesforce using an administrator account.
-
On the top right, click the cog wheel and select Setup.
-
On the Setup page, navigate to Platform Tools > Apps > App Manager page on the left navigation pane and clickNew Connected App.
-
Configure the following required fields and any optional fields as desired (for example, Logo Image) and click Save.
- Connected App Name: Forcepoint ONE SSE
- API Name: Forcepoint ONE SSE
- Contact Email: <Salesforce Admins Email>
- Enable OAuth Settings: Checked
-
Callback URL:
https://portal.bitglass.com/appapis/salesforce/code/
https://portal.bitglass.com/api/salesforce/authz_result/
-
Important: The ending / must be present for the callback to work correctly.Note:
On Prem deployments will have different URLs:
- https://<Forcepoint ONE SSE Instance Domain>/appapis/salesforce/code/
For example: https://bitglass.contoso.com/appapis/salesforce/code/
- https://<Forcepoint ONE SSE Instance Domain>/api/salesforce/authz_result/
For example: https://bitglass.contoso.com/api/salesforce/authz_result/
- https://<Forcepoint ONE SSE Instance Domain>/appapis/salesforce/code/
-
Selected OAuth Scopes:
- Manage user data via APIs (api)
- Perform requests at any time (refresh_token, offline_access)
As an alternative, the Full Access (full) OAuth scope can be used. However, this may introduce additional security gaps and may not be acceptable depending on a client's risk tolerance.
For a full list of Salesforce OAuth Scopes and their descriptions, see Salesforce OAuth Tokens and Scopes.
- When you are done, click Save to create the new Forcepoint ONE SSE app.
-
Click on the newly created Forcepoint ONE SSE app in the
Connected Apps table. Keep this page open for the next section as you will need the consumer key and secret for authorizing the API in Forcepoint ONE SSE.
-
Advanced (OAuth Token Timeouts)
OAuth token timeouts and refresh settings can also be adjusted by editing the Connected App.
- Click the Edit button while viewing a connected app on the Setup > Platform Tools > Apps > Connected Apps > Manage Connected Apps page.
- Adjust timeouts and refresh token policies as desired and click Save.
- Click the Edit button while viewing a connected app on the Setup > Platform Tools > Apps > Connected Apps > Manage Connected Apps page.