SAML (security assertion markup language) for SSO (single sign-on) makes it possible for users to authenticate through a company’s identity provider when they log-in to the Bizible app. SSO allows a user to authenticate just once, without needing to authenticate separate apps. SAML is a necessity for enterprise customers because not all users will have a Salesforce or Google account within their organization. In order to scale, Bizible has developed an SAML solution that can support company identity providers.
This article outlines Single Sign On (SSO) and advanced CRM User Management. If your account was provisioned after 9/10/2020, please disregard this article, as SSO and Identity Management will be set up within the Adobe Admin Console for your Bizible integration.
It’s likely that companies use different Identity Providers (e.g., Ping Identity, Okta). The terms used in the following set-up instructions and in the UI may not directly match those used by your Identity Provider.
To get started, navigate to Settings > Security > Authentication page in the Bizible application. Then switch the Login Type to Custom SSO to see the configuration options. Changes will not take effect until you test your authentication and click the Save button at the bottom of the page.
Bizible Single Sign On requires configuring your Authentication settings in a series of steps that is important to follow so that you don’t risk getting locked out of your Bizible account.
Set up the Bizible Application in your Identity Provider. See external documentation listed below for walkthroughs.
a. When prompted for the Single Sign On URL or Recipient URL or Destination URL, SAML Assertion Customer Service (ACS) URL, use [https://apps.bizible.com/BizibleSAML2/ReceiveSSORequest](https://apps.bizible.com/BizibleSAML2/ReceiveSSORequest) b. When prompted for the Audience Restriction URL or application-defined unique identifier, use [https://BizibleLPM](https://biziblelpm/)
Switch to Custom SSO in the Bizible Application
a. Once the Billing Group has been enabled for your Account, you can now navigate to Settings >> Security >> Authentication b. By default, your Login Type will be set to “CRM Users.” c. Switch the Login Type to “Custom SSO” to begin the configuration process.
Fill in the connection settings for your Identity Provider configuration
a. Your Identity Provider might give an IdP metadata .xml document which will pull out the required configuration fields. Either load in the content of the .xml document or fill out the three fields below from the output obtained during the Identity Provider configuration process. **You do not need to complete both.** i. IdP URL: The URL that Bizible needs to point to in order to authenticate your users into the Bizible application. Sometimes referred to as the “Redirect URL.” ii. IdP Issuer: A unique identifier of the Identity Provider. Sometimes referred to as the “External Key.” iii. IdP Certificate: A public key that allows Bizible to verify and validate the signature of all Identity Provider responses.
Set the token expiration for your users in minutes.
a. Bizible allows a whole number from 1 to 1440 minutes. After a user’s session time has been exceeded, the user will get logged off once they navigate to a new page.
Set up and map your User Attribute settings to the respective First Name, Last Name, and Email Address.
a. By entering the SAML attributes, Bizible will be able to recognize your users by the information passed through. i. Email Attribute: Provide the attribute name that your Identity Provider uses for the user’s email address. ii. First Name Attribute: Provide the attribute name that your Identity Provider uses for the user’s first name. iii. Last Name Attribute: Provide the attribute name that your Identity Provider uses for the user’s last name. b. Hint: If you test your SAML configuration now, we will parse out the Email, First Name, and Last Name attributes that you can use for this section.
Set up and map your User Role settings to the respective roles or groups classified from your IdP.
a. Customers have the option of assigning Bizible user roles based on groups defined in their Identity Provider. By entering your SAML attributes, Bizible will be able to map your user’s roles and groups to Bizible user permissions. We highly recommend that you set up these roles so that your Bizible administrator has sufficient rights to update your account. b. If no roles or groups are mapped, the default setting is that all employees in the Identity Provider will have Standard user access. i. Bizible Standard User: Provide the role or group value (from your SSO provider) for users that should have read-only access to the Bizible application. ii. Bizible Account Admin User: Provide the role or group value (from your SSO provider) for users that should have administrative access to the Bizible application. This means that the role has access to change configurations and settings related to your Account. iii. You must have an attribute in your IdP with the exact name of “groups” that houses the values you put in the “Bizible Standard User" or “Bizible Account Admin User” attributes. c. If multiple roles or groups should be mapped to a role, enter each value separated by a comma.
Test the Single Sign On configuration
a. Before you can hit Save, you will be required to click the Test SAML Authentication button to verify that your settings were configured properly. b. If you see a “failure” error, please follow the message and attempt again.
Save your settings and direct your colleagues to use Single Sign On with your new custom Sign In URL.
a. Important: Once you Save your new Authentication settings, it is possible your session will end once you navigate to a new page because you have disabled login by CRM Users and enabled Custom SSO.
Try it out!
a. Use your new custom Sign In URL and attempt to log back in to the Bizible Application with your Identity Provider credentials. b. The format will look like `https://apps.bizible.com/business/[accountName]` c. Congratulations! You’ve successfully set up Single Sign On into the Bizible Application for your account!
After you configure SSO, you’ll no longer need to add users within the Bizible application. User provisioning should be handled directly within your Identity Provider.
By default, all accounts can access the Bizible application using their CRM credentials. Sometimes, account owners need to limit access to certain roles and not open it to all users with an active CRM license. The Advanced setup will allow you to map your CRM roles and groups to Bizible user permissions.
If no roles or groups are mapped, the default setting is that all active licenses in your CRM will have Standard user access.
If multiple roles or groups should be mapped to a role, enter each value separated by a comma.
For Salesforce Roles, use the name of each Role. All Roles can be found under the Setup > Manage Users > Roles menu.
For Dynamics Roles, use the name of each Security Role. All Security Roles can be found under the Settings > Security > Security Roles menu.
Once Custom SSO has been set up, the Users page will be updated to only show external users that have been added with Google logins. Because all users with access are defined through the SSO configuration, additional external users are listed here.
Only valid Google accounts can be added and must have a User Role defined.