Back to blog

New IdP Role Mapping in Contentstack Single Sign-On..

idp-role-mapping(1).png

If you have a well-established way of managing users and roles within your SAML Identity Provider (IdP), there’s good news. Contentstack now supports mapping your IdP roles to Contentstack roles, enabling you to keep using your existing role management (on the IdP side) for your SSO-enabled Contentstack organizations.

How IdP Role Mapping Works with Contentstack SSO

By mapping your IdP roles to Contentstack roles, you define the organization-level and stack-level permissions that the users of your IdP roles would have in Contentstack. The users of your mapped IDP roles can then directly log into your SSO-enabled Contentstack organization with the assigned permissions.

This role mapping eases the process of managing users and roles for your IdP as well as Contentstack admins. Here are some of the other advantages of enabling IdP Role Mapping for your SSO-enabled Contentstack organization:

Direct login for IdP users

If your IdP roles are mapped to Contentstack roles, all users of the mapped roles can log into your SSO-enabled Contentstack organization directly. You do not have to invite them separately. This saves a lot of time and effort for the IdP admin.

User management from one central location

Managing users from your SSO-enabled organization becomes easier as the user management for both IdP and Contentstack can now be done from the IdP. As an admin, it eliminates the need to maintain separate lists of users for different accounts.

Sécurité renforcée

If ‘Strict Mode’ is enabled for your SSO-enabled organization, inviting, updating or removing users from Contentstack is not allowed. This ensures that admins, members or developers of your Contentstack organization or stack cannot manage users or roles unless they have such rights in your SAML IdP.

How to enable IdP Role Mapping for your Organization

To enable IdP Role Mapping for your SSO-enabled organization, follow these simple steps:

  1. For the initial set up, refer our general guide on Single Sign-On.
  2. Go to the User Management section of your Organization’s Single Sign-On (SSO) settings page.
  3. Click on the Advanced Settings option to expand the IdP Role Mapping section.
  4. Dans Add role mapping , cliquez sur le lien ADD NEW MAPPING link and add the following details:
    • IdP Role: Enter the unique identifier (name or UID) of the IdP group/role for which you want to create the mapping.
    • Organization Role: Assign an Organization-specific role to the IdP group/role, for example, ‘Admin’ or ‘Member.’
    • Stack Roles: Assign stack-specific roles to the mapped IdP group or role.
    • Finally, enter the Role Delimiter your IdP uses to delimit the users of the role.
  5. Likewise, you can add multiple mappings to map various roles of your IdP.
  6. Switch on the Enable Role Mapping toggle button to activate the Role Mapping feature for your organization.

Once you do this, and save your settings, all users of your IdP roles (that are mapped) will be able to login to your Contentstack organization via SSO Login, and access the stacks with assigned rights.

Read more about SSO and IdP Role Mapping in our SSO guide.

Share on:

À propos de Contentstack

The Contentstack team comprises highly skilled professionals specializing in product marketing, customer acquisition and retention, and digital marketing strategy. With extensive experience holding senior positions at renowned technology companies across Fortune 500, mid-size, and start-up sectors, our team offers impactful solutions based on diverse backgrounds and extensive industry knowledge.

Contentstack is on a mission to deliver the world’s best digital experiences through a fusion of cutting-edge content management, customer data, personalization, and AI technology. Iconic brands, such as AirFrance KLM, ASICS, Burberry, Mattel, Mitsubishi, and Walmart, depend on the platform to rise above the noise in today's crowded digital markets and gain their competitive edge.

In January 2025, Contentstack proudly secured its first-ever position as a Visionary in the 2025 Gartner® Magic Quadrant™ for Digital Experience Platforms (DXP). Further solidifying its prominent standing, Contentstack was recognized as a Leader in the Forrester Research, Inc. March 2025 report, “The Forrester Wave™: Content Management Systems (CMS), Q1 2025.” Contentstack was the only pure headless provider named as a Leader in the report, which evaluated 13 top CMS providers on 19 criteria for current offering and strategy.

Follow Contentstack on LinkedIn.

Published: Mar 15, 2019


Contexte.png