Skip to content

Bizzkit single sign on

To work with the CMS, you need a Builder.io account that serves as a central place to manage organisations, spaces, users, etc.
To authenticate with your Builder.io spaces in the same way as with other Bizzkit applications, you need to configure SSO with your Auth/IAM in Bizzkit Commerce Cloud.

For the best experience, we recommend configuring SSO in Builder.io at the organisation level.

If you have multiple Auth/IAM deployments in Bizzkit Commerce Cloud, you are free to choose any of them for SSO.
However, we recommend using your production deployment of Auth/IAM for SSO, as it has the highest availability.

To configure SSO in Builder, navigate to the organisation settings and click "Edit" under "Single Sign-On":

Configuring SSO in your Builder.io organisation

Configuring SSO in your Builder.io organisation

You are free to choose a display name of your liking.

The SSO name should follow the format oidc.bizzkit-CompanyName, where CompanyName is the name you chose when signing up for Bizzkit Commerce Cloud.

The remaining fields must be retrieved by calling the IAM REST API: POST /api/builder endpoint.
The easiest way to do this is to visit the IAM Swagger UI for your solution. Alternatively, you can use the Bizzkit.Sdk.Iam to retrieve the required information.

In Builder.io, the login used MUST be an administrator of the space.

In IAM, the login used MUST have the "Manage System Configuration" permission.

Configuring SSO in your Builder.io organisation

Configuring SSO in your Builder.io organisation

Please contact your Bizzkit representative for more information on obtaining your Builder.io account.

Page designer and website authentication

In some cases, the webpage used for previewing and editing content within Builder.io may be behind authentication, which might not work out of the box due to restrictions related to iframes.

To resolve this, we recommend setting up authentication using "popup mode", which is not subject to the same iframe restrictions. An example can be found here using the oidc-client-ts library.

Additionally, it is necessary to enable form submission for all Builder.io page and section models to allow login forms to be submitted properly.
This can be done by navigating to the settings for a given model and toggling "Enable Preview Iframe form submission" in the "Advanced" tab.