Private Integration Setup
How to set up a private Okta integration with Salesbricks
Supported features
- Single Sign-On (OpenID Connect, IdP-initiated only)
- Automatically creates user accounts in Salesbricks when Single Sign-On is initiated by a member of an organization with an active Okta integration
To enable this feature on your company’s Salesbricks account, you will need to work with Salesbricks Support to activate your instance.
Overview
The following steps ensure that your users can login to Salesbricks with Okta:
Set up the Salesbricks application in Okta manually.
Gather information from Okta.
Send the information to Salesbricks.
Prerequisites
Sign up for a seller account on Salesbricks.
The Okta Single Sign-On integration is only available to Salesbricks users as a paid feature.
Verify that the email addresses of your existing Salesbricks users match their Okta accounts exactly.
Setup
Set up the Salesbricks application in Okta manually
Log in to your Okta Admin dashboard.
Click Applications -> Applications from the left navigation tree.
Click "Create App Integration."
In the "Create a new app integration" dialog, select "OIDC - OpenID Connect" as the Sign-in method, and "Web Application" as the Application type.
Click "Next."
You will be directed to a page titled “New Web App Integration.”
- For the “App integration name,” enter
Salesbricks
- For the “Sign-in redirect URI,” enter
https://api.salesbricks.com/sso/okta/callback
- For the “Sign-out redirect URI,” delete the default value so that the field is blank.
- For “Assignments,” determine your company’s level of controlled access and immediate access (Note: Federation Broker Mode would disable your Okta End User Dashboard, so we would want to keep immediate access disabled).
- Click “Save.”
You will be directed to the config settings page for your Salesbricks app integration.
- Under the “General Settings,” click “Edit.”
- Update “Login initiated by” to
Either Okta or App
. - For “Application visibility,” check the box for
Display application icon to users
. This will make the Salesbricks application icon visible in the end user dashboard. - For “Initiate login URI,” enter the Salesbricks Okta login URL (
https://api.salesbricks.com/sso/okta/login?client_id=
) followed by your client ID at the top of the Settings page. It should look like:https://api.salesbricks.com/sso/okta/login?client_id=0ob8xfou2vZPZCbDk5d7
- Click “Save.”
After installing the application, you will need to obtain some information to send to Salesbricks.
Gather information from Okta
In the Okta admin page, go to Applications -> Applications.
Click on the Salesbricks application.
Under the "General" tab, copy the values for Client ID and Client secret.
Click the eye button to toggle the visibility.
Under the user dropdown menu in the top right corner of the page, copy your Okta organization's issuer URL.
This is usually located under the admin’s email address, e.g. salesbricks.okta.com.
Send the information to Salesbricks
Once you have all the required information (summarized below), email them to integration-support@salesbricks.com.
- Client ID
- Client Secret
- Issuer URL
Salesbricks Integration Support will handle your request and follow up with you once the integration is configured.