SSO Client Setup Guide, OIDC

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
    • Email

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