Set Up SSO Commerce for Adobe Commerce

Before You Start

  • You must be using at least version 2.25.2 of our Magento 2 Plugin.
  • You have completed the process of migrating customer accounts to Bolt. See Customer Account Migration for a step-by-step guide.
  • Contacted Bolt and requested SSO Commerce to be enabled for your account.
  • Made a copy of your active theme as a backup.
  • If you are upgrading SSO, instead of installing SSO for the first time, please see the section below on upgrading SSO.

For instructions on enabling SSO with Magento versions 2.25.1 and below, see Set up SSO for Adobe Commerce (Legacy)

Install SSO

Contact Bolt

Before you can configure Adobe / Magento 2 Commerce for SSO, Bolt must first enable the feature in our internal systems.

Reach out to your Bolt representative to turn on this feature flag. Your Bolt representative may ask you for:

  • Your site url.
  • A link to your Terms of Service (TOS).
  • A link to your Privacy Policy.

Then, you can configure your admin account for SSO.

Configure for SSO

1. Enable Bolt SSO in Magento / Adobe Account

  1. Log in to the M2 Admin Console.
  2. Navigate to Stores > Configuration > Sales > Payment Methods > Bolt.
  3. Enable Bolt SSO Commerce.

2. Ensure All User Flows Now Use the Bolt SSO Flow

All links and buttons that previously pointed to your store login, register, and logout pages should now open the Bolt SSO login.

In the event that they do not properly point to the Bolt SSO login page, you may need to consult Bolt or a developer to resolve any issues blocking the flow.

3. Configure Additional Configurations for Buttons

If you are using any custom buttons, pop-up windows or modals, or need a custom destination page after Bolt SSO login, use the additional configuration field in your Magento 2 Admin account.

  1. Log in to the M2 Admin Console.
  2. Navigate to Stores > Configuration > Sales > Payment Methods > Bolt.
  3. Under Additional Configuration find Additional options.
  4. Find customSSOSelectors and insert properly formatted JSON strings to configure custom buttons based on your desired selectors.
CustomSSOSelectors Example
{
  "customSSOSelectors": {
    "selector1": {},
    "selector2": {"option1": "value"},
    "selector3": {"option2": false}
  }
}

Logout Selector Option



Redirect Selector Option


Test

Work with your Bolt representative to create a testing plan that works for you.

Bolt recommends setting up a sandbox environment first before making any changes in production. Preview mode does not work for testing Bolt SSO Commerce.

  1. Test the Login/Register button. This action should populate the SSO Modal. Try going all the way through the login flow with your own Bolt account.
  2. Test any Icons or Elements with the id=”bolt-sso-custom” attribute. This action should populate the SSO modal.

Upgrade SSO

If SSO was previously set up using a previous version of the plugin (see Set Up SSO Commerce For Adobe Commerce (Legacy)), the Bolt SSO JS Widget and the Bolt SSO JS Block need to be disabled or deleted in Magento 2 admin account.

Then, we recommend

Disable Bolt SSO JS Block

  1. In your Magento 2 admin account, go to Content > Blocks.
  2. Click Bolt SSO JS in the table.
  3. Click Delete in the Actions menu (found in the last column of the table). Block Table with Actions menu shown.

Disable Bolt SSO JS Widget

  1. In your Magento 2 Admin account, go to Content > Widgets. Magento 2 Admin Account navigation to widgets.
  2. Click Bolt SSO JS in the table. Bolt SSO JS Widget Location.
  3. Click Delete in the menu at the top. Deletion action in top menu.
πŸ“–On This Page