Take the community feedback survey now.

K Khan
Jul 26, 2024
  2756
(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
OptiId: What is it and why now is a good time to use it

If you’ve been hearing the term  OptiID floating around and wondering what the fuss is about, let’s break it down in plain English. What is OptiID ...

Jon Williams | Nov 12, 2025

Using Serilog in DXP

TL;DR  Use Serilog.Sinks.Console for DXP apps — or skip Serilog entirely and rely on default logging. It’s common during investigations that all th...

Karl Stålenheim | Nov 12, 2025

Handling Multiple OpenID Connect Providers in Optimizely CMS with .NET 8

When you need to authenticate against more than one OpenID Connect provider in the same ASP.NET Core app – say IdentityServer  for the public site...

Eric Herlitz | Nov 12, 2025 |

New Certification Alert: Become a Certified Optimizely CMS PaaS Administrator

If you’ve ever managed an Optimizely CMS environment, you already know it’s not just about deployments and settings. It’s about keeping everything...

Satata Satez | Nov 10, 2025

Algolia Search with Optimizely SAAS

Algolia + Optimizely SAAS (Remko Next.js) Integration Guide This guide explains how to integrate Algolia Search with your Optimizely SaaS CMS proje...

PuneetGarg | Nov 10, 2025

Optimizely CMS platform bug in ErrorsController (EPiServer.CMS.Core 12.22.9 fix)

While checking  Application Insights earlier this year, I stumbled upon a strange exception in my Optimizely site. At first, I thought it might be ...

David Drouin-Prince | Nov 9, 2025 |