This guide explains how to integrate your identity provider with ShareBuilders’ Single Sign-On (SSO) system using OpenID Connect (OIDC). Once configured, SSO will work seamlessly for both ShareBuilder CRM and ShareBuilder Pricing.
Overview
-
What: You’ll create an OIDC application in your identity provider (e.g., Okta) to handle user authentication.
-
Why: This allows your users to sign in to ShareBuilders using their existing login credentials, improving security and user convenience.
-
Result: Users see a login page branded with your logo and app name, or they are automatically signed in if they already have an active session in your identity provider.
Step 1: Create an App Registration in Your Identity Provider
Configure an OIDC - OpenID Connect application with the following settings:
Sign-in type: OIDC - OpenID Connect
Application type: Web Application
Grant types: Authorization Code & Refresh Token
Sign-in redirect URL: https://login.share-builders.com/sharebuildersb2c.onmicrosoft.com/oauth2/authresp
Step 2: Provide ShareBuilders Configuration Details
To finalize the integration, please provide your ShareBuilders contact with::
-
Identity Provider URL (e.g.,
https://dev-70264317.okta.com
) -
Client ID
-
Client Secret
- Identity Provider Claims Mappings
- User ID
- Display name
- Given name
- Surname
If possible, include a temporary test user account for validation. If your security policies don’t allow this, you will need to perform the final validation on your end once setup in ShareBuilders
Support & Troubleshooting
For assistance, contact ShareBuilders support at helpdesk@share-builders.com