K Khan
Jul 26, 2024
  3585
(1 votes)

Opti ID overview

Opti ID allows you to log in once and switch between Optimizely products using Okta, Entra ID, or a local account. You can also manage all your users from one place. you can watch an interactive demo here.  The Optimizely platform offers:

  • A single login (Single Sign-On or SSO) with support for multi-factor authentication (MFA), using your own MFA setup and directory authentication provider.
  • The ability to switch between apps without having to log in again.
  • The option to manage users, groups, and roles with Opti ID.
  • A dashboard for managing account information, usage, and billing.

Opti ID is currently available for the following Optimizely products:

  • Commerce Connect
  • Configured Commerce
  • Content Management System (CMS 12) 
  • Optimizely CMS SaaS
  • Content Marketing Platform (CMP)
  • Digital Experience Platform (DXP)
  • Experimentation
  • Experiment Collaboration
  • Optimizely Data Platform (ODP)
  • Product Information Management (PIM)
  • Product Recommendations

It is easy to set up Opti ID in your solution with the following steps:

  1. Install the NuGet Package: 

    dotnet add package EPiServer.OptimizelyIdentity
  2. Enable Opti ID: In your Startup.cs file, add the following line in the ConfigureServices method to enable Opti ID globally

    services.AddOptimizelyIdentity(useAsDefault: true);
    This makes Opti ID, active throughout the application, including in shell modules, preview, and edit modes. You can customize authentication schemes using AuthenticationOptions if needed. 
  3. Remove Unnecessary Services: If you're not using ASP.NET Identity, remove any calls to services.AddCmsAspNetIdentity().

  4. Virtual Roles: Opti ID automatically maps the virtual roles CmsEditors and CmsAdmins. If you already have these mappings, you'll need to remove them.

  5. Testing: Ensure your user is assigned to at least one built-in system role for the CMS before testing. Deploy your changes to DXP or run the application locally with Opti ID set up.

  6. Running Opti ID Locally: To configure local usage, add these settings in your appsettings.json file. These are automatically provided when deploying to the Optimizely Digital Experience Platform (DXP) or can be found in the DXP Management Portal under API > Opti ID dev key

    {
      "EPiServer": {
        "Cms": {
          "OptimizelyIdentity": {
            "InstanceId": "xxx",
            "ClientId": "xxx",
            "ClientSecret": "xxx"
          }
        }
      }
    }

    Opti ID will work locally with the following ports:

    https://localhost:5000
    https://localhost:5096
    https://localhost:6921
    https://localhost:7595


    References: https://support.optimizely.com/hc/en-us/articles/12613241464461-Get-started-with-Opti-ID

Jul 26, 2024

Comments

Mark Stott
Mark Stott Jul 26, 2024 12:40 PM

Thank you for sharing this today.  

If you want to know more, please note that in today's happy hour (26th July 2024), Graham Carr will be presenting a guide to Opti Id: Happy Hour | Optimizely Developer Community

K Khan
K Khan Jul 26, 2024 01:34 PM

Thanks :), There is always something to learn, especially if it is Graham Carr

Patrick Lam
Patrick Lam Jul 26, 2024 02:49 PM

Thanks for the overview!


Don't forget to add the newly launched Optimizely CMS SaaS to that list of products!

K Khan
K Khan Jul 26, 2024 03:08 PM

Thanks, Patrick for the feedback, done!

Anders Venold
Anders Venold Aug 5, 2024 12:02 PM

Great intro for adding Opti Id! Any trick to get it to work with Commerce? When switching from CMS to Commerce we get Access Denied...

K Khan
K Khan Aug 5, 2024 12:20 PM

I haven't tried with commerce, but my first check will be to confirm if Opti ID is enabled for the product, by looking into the Admin Center > Product Access > Product > cms/commerce.

Please login to comment.
Latest blogs
Removing Unused Properties in Optimizely CMS 13

Learn how to remove orphaned property definitions in Optimizely CMS 13. Explore API updates for IContentTypeRepository and how to safely use...

Stuart | Apr 17, 2026 |

How to Remove the "Paste formatting options" Dialog in Optimizely CMS 12

If you've upgraded from an older Optimizely CMS solution lately, you may have noticed a dialog popping up every time an editor pastes content from...

Henning Sjørbotten | Apr 17, 2026 |

Creating an admin tool - unused assets

Let's make an admin tool to clean unused assets and see how to extend your favorite CMS with custom tools and menues! We will build a tool step by...

Daniel Ovaska | Apr 15, 2026

Running Optimizely CMS on .NET 11 Preview

Learn how to run Optimizely CMS on the .NET 11 preview with a single-line change. Explore performance gains, PGO improvements, and future-proofing...

Stuart | Apr 15, 2026 |