Import employees and groups from Microsoft Entra ID over SCIM and set up single sign-on, step by step, with an enterprise application you create in Entra.
Entra sends Cimento the people and groups you assign to a Cimento enterprise application and keeps them up to date over SCIM. The same application sets up SAML single sign-on, so assigned employees can sign in to Cimento through Entra.
Before you start
An Entra Application Administrator, Cloud Application Administrator or Global Administrator, to create the application and set up provisioning and single sign-on.
A Cimento user with the Admin role, to reveal the secret token in step 4. Integrations admins can do every other step.
An email address on everyone you’ll assign. Cimento matches people by email, so each person needs the Email field set on their Entra account.
Microsoft Entra ID P1 or P2 if you want to assign groups. With Microsoft Entra ID Free, you assign people one at a time.
Your organization’s email domains registered with Cimento. Single sign-on only covers those domains, so ask your Cimento contact to add any that are missing.
Your organization connects one directory, and switching to another later needs Cimento support. As soon as you click Begin Setup, employees come from Entra: you can no longer add or upload employees in Cimento, or edit their names, email addresses, status or departments.
Steps
1
Start setup in Cimento
Go to Admin → Integrations → Employee data. Under Directory provider, choose Microsoft Entra ID and click Begin Setup. The setup guide opens at Before you start. Read it, then click Next.
2
Create the application
Click Open the Microsoft Entra admin center. Go to Entra ID › Enterprise apps (Enterprise applications in the Azure portal) and click New application, then Create your own application. Name it Cimento, choose Integrate any other application you don’t find in the gallery (Non-gallery) and click Create. The application’s Overview page opens after a few seconds. Back in Cimento, click Next.
Enterprise applications › New application
Name the application, choose Non-gallery and click Create
3
Assign people
In the Cimento application, open Users and groups and click Add user/group. Choose the people and groups who should use Cimento, then click Select and Assign. Assign yourself too, so you can sign in to Cimento through Entra. Entra only sends direct members of a group you assign, not members of groups nested inside it. Back in Cimento, click Next.
Users and groups › Add user/group
Pick the people to assign, then click Select and Assign
4
Connect provisioning
In the Cimento application, open Provisioning and click Connect your application. If you see Get started instead, click it and set Provisioning Mode to Automatic. Keep Bearer authentication. From Cimento’s Provisioning step, copy the Tenant URL into Entra, then click Copy next to Secret Token and paste it into Entra’s Secret token field. Click Test connection, and when it succeeds, click Create or Save. You don’t need to change the attribute mappings.
Open Provisioning from the application's menu
Bearer authentication, the Tenant URL and the Secret Token, shown in the older Provisioning layout
5
Start provisioning
On the provisioning Overview, click Start provisioning. In the older layout, set Provisioning Status to On and click Save. Keep the scope at Sync only assigned users and groups. Entra syncs about every 40 minutes. To check it right away, use Provision on demand with your own account. Back in Cimento, click Next.
6
Set up single sign-on
In the Cimento application, open Single sign-on and choose SAML. Click Edit in Basic SAML Configuration. Click Add identifier and paste the Identifier (Entity ID) from Cimento’s Single sign-on step. Click Add reply URL and paste the Reply URL from the same Cimento step. It ends in /auth/v1/sso/saml/acs. Leave the Index box next to it empty: Cimento has a single reply URL, so Entra doesn’t need an index to choose between them. Leave Default as it is. Leave Sign on URL, Relay State and Logout Url empty, and click Save.
Single sign-on › SAML
Add the Identifier and the Reply URL; leave the optional fields empty
7
Send email addresses as the user identifier
In Attributes & Claims, click Edit, then the Unique User Identifier (Name ID) claim. Set Name identifier format to Email address, Source to Attribute and Source attribute to user.mail, and click Save. Back in Cimento, click Next.
Click the Unique User Identifier (Name ID) claim
Email address format, Attribute source, user.mail
8
Turn on single sign-on
Single sign-on adds a way to sign in; it doesn’t replace email sign-in links. Everyone can still sign in with a link sent to their work email. Signing in through Entra works only for people assigned to the Cimento application who are already in Cimento, so finish steps 3 to 5 first.
On Entra’s Single sign-on page, copy the App Federation Metadata Url from SAML Certificates. Paste it into Cimento’s Metadata URL step and click Save configuration. When Cimento shows SSO configured, people with an address in your domains can click Sign in with SSO on Cimento’s sign-in page to sign in through Entra, or Email me a sign-in link instead.
Copy the App Federation Metadata Url from SAML Certificates
9
Verify
In Cimento’s Verify step, click Test connection. It checks that single sign-on is connected to your Entra tenant and activates the integration. Then try it yourself: open My Apps and select Cimento, or enter your work email on Cimento’s sign-in page and click Sign in with SSO. Entra’s Test connection in step 4 is the check for provisioning, and Entra’s Provisioning logs show each person it sent.
If something goes wrong
Cimento shows
What to do
That isn’t the App Federation Metadata Url
Copy the App Federation Metadata Url from SAML Certificates on the Cimento application’s Single sign-on page. It starts with https://login.microsoftonline.com/ and ends with ?appid= and the application’s ID.
Microsoft didn’t return a SAML signing certificate for that app
Check that you copied the URL from the Cimento application and that its SAML Certificates section has an active certificate, then save the URL again.
The Cimento app’s SAML signing certificate has expired
In SAML Certificates, create a new certificate and make it active, then save the URL again.
The Cimento app’s SAML signing certificate isn’t valid yet
In SAML Certificates, make a certificate that’s valid today active, or wait until the new one starts, then save the URL again.
We couldn’t read that metadata from Microsoft
Check the URL, wait a minute, then save it again.
Single sign-on could not be set up from that URL
Copy the App Federation Metadata Url again from SAML Certificates and save it. If the message comes back, contact Cimento support.
Your organization has no email domains set up yet
Ask your Cimento contact to add your email domains, then save the metadata URL again.
Your organization’s domains or this identity provider are already connected to single sign-on in a way Cimento can’t change automatically
Contact Cimento support to move the connection.
Single sign-on is not connected for your organization yet
Go back to the Metadata URL step and save it again.
Single sign-on for your organization’s domains is connected to a different identity provider or Microsoft Entra tenant
Contact Cimento support to switch it.
You don’t have permission to view this value
Ask a Cimento user with the Admin role to copy the secret token for you.
If single sign-on is already working and you replace the Cimento application’s SAML signing certificate in Entra, contact Cimento support so Cimento starts using the new certificate. Saving the same App Federation Metadata Url again doesn’t pick it up.
What Entra sends
Cimento uses each employee’s primary email, name, title, department, manager and phone numbers, and mirrors the groups you assign. See What Okta and Microsoft Entra ID send for how each attribute maps and what happens when someone leaves.
Stop provisioning
The secret token lets Entra create, update and deactivate employees in Cimento, so store it like a password. To stop Entra from updating Cimento, click Stop provisioning on the provisioning Overview (in the older layout, set Provisioning Status to Off), or delete the enterprise application.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Cimento","description":"Setup documentation for security administrators deploying Cimento phishing simulation and security training.","colors":{"primary":"#ef7025","light":"#eec9bc","dark":"#4fa1ab"},"logo":{"light":"https://mintcdn.com/cimento/v0wi2YRA3DkT313c/logo/light.svg?fit=max\u0026auto=format\u0026n=v0wi2YRA3DkT313c\u0026q=85\u0026s=7a3436b9d20a014e858cd2d35957fd63","dark":"https://mintcdn.com/cimento/v0wi2YRA3DkT313c/logo/dark.svg?fit=max\u0026auto=format\u0026n=v0wi2YRA3DkT313c\u0026q=85\u0026s=bff2e924b88020e33c963684ca2925ae"},"favicon":"https://mintcdn.com/cimento/v0wi2YRA3DkT313c/favicon.svg?fit=max\u0026auto=format\u0026n=v0wi2YRA3DkT313c\u0026q=85\u0026s=2f138a61172e2852f8157e6332119c75","navbar":{"links":[{"href":"https://cimento.ai","label":"cimento.ai"}]},"footer":{"links":[{"header":"Legal","items":[{"label":"Privacy policy","href":"https://cimento.ai/privacy-policy"}]}]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cimento","hasAudioNarration":false,"actualSubdomain":"cimento","customDomains":["docs.cimento.ai"],"gitSource":{"type":"github","owner":"cimento-ai","repo":"cimento-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe24f316d36d907c4230cd","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Agent Hub","count":7},{"language":"default","tag":"Integrations","count":7},{"language":"default","tag":"Phishing","count":7},{"language":"default","tag":"Webhooks","count":7},{"language":"default","tag":"Training","count":5},{"language":"default","tag":"Deploy with your MDM","count":4},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"Event reference","count":3},{"language":"default","tag":"Updates","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"integrations/microsoft-entra-id","slug":"/integrations/microsoft-entra-id","pageMetadata":{"title":"Connect Microsoft Entra ID","sidebarTitle":"Microsoft Entra ID","description":"Import employees and groups from Microsoft Entra ID over SCIM and set up single sign-on, step by step, with an enterprise application you create in Entra.","href":"/integrations/microsoft-entra-id"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Import employees and groups from Microsoft Entra ID over SCIM and set up single sign-on, step by step, with an enterprise application you create in Entra.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,Note,OptimizedImage,Step,Steps,Table}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Entra sends Cimento the people and groups you assign to a Cimento enterprise application and keeps them up to date over SCIM. The same application sets up SAML single sign-on, so assigned employees can sign in to Cimento through Entra.`}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`An Entra Application Administrator, Cloud Application Administrator or Global Administrator, to create the application and set up provisioning and single sign-on.`}),`\n`,_jsx(_components.li,{children:`A Cimento user with the Admin role, to reveal the secret token in step 4. Integrations admins can do every other step.`}),`\n`,_jsxs(_components.li,{children:[`An email address on everyone you’ll assign. Cimento matches people by email, so each person needs the `,_jsx(_components.strong,{children:`Email`}),` field set on their Entra account.`]}),`\n`,_jsx(_components.li,{children:`Microsoft Entra ID P1 or P2 if you want to assign groups. With Microsoft Entra ID Free, you assign people one at a time.`}),`\n`,_jsx(_components.li,{children:`Your organization’s email domains registered with Cimento. Single sign-on only covers those domains, so ask your Cimento contact to add any that are missing.`}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Your organization connects one directory, and switching to another later needs Cimento support. As soon as you click `,_jsx(_components.strong,{children:`Begin Setup`}),`, employees come from Entra: you can no longer add or upload employees in Cimento, or edit their names, email addresses, status or departments.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`steps`,children:`Steps`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Start setup in Cimento`,children:_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Admin → Integrations → Employee data`}),`. Under `,_jsx(_components.strong,{children:`Directory provider`}),`, choose Microsoft Entra ID and click `,_jsx(_components.strong,{children:`Begin Setup`}),`. The setup guide opens at `,_jsx(_components.strong,{children:`Before you start`}),`. Read it, then click `,_jsx(_components.strong,{children:`Next`}),`.`]})}),_jsxs(Step,{title:`Create the application`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Open the Microsoft Entra admin center`}),`. Go to `,_jsx(_components.strong,{children:`Entra ID › Enterprise apps`}),` (`,_jsx(_components.strong,{children:`Enterprise applications`}),` in the Azure portal) and click `,_jsx(_components.strong,{children:`New application`}),`, then `,_jsx(_components.strong,{children:`Create your own application`}),`. Name it Cimento, choose `,_jsx(_components.strong,{children:`Integrate any other application you don’t find in the gallery (Non-gallery)`}),` and click `,_jsx(_components.strong,{children:`Create`}),`. The application’s `,_jsx(_components.strong,{children:`Overview`}),` page opens after a few seconds. Back in Cimento, click `,_jsx(_components.strong,{children:`Next`}),`.`]}),_jsx(Frame,{caption:`Enterprise applications › New application`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/new-application.png?fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=3d1a16ae4a93a02899054ec58921f0a4`,alt:`The Enterprise applications page in Microsoft Entra, with the New application button highlighted`,\"data-og-width\":`1201`,width:`1201`,\"data-og-height\":`430`,height:`430`,\"data-path\":`images/integrations/microsoft-entra-id/new-application.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/new-application.png?w=280\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=ea5844e0c1e421fac6105d0f4da6e54f 280w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/new-application.png?w=560\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=36f000ee0105c0b9443fd184c7f63aeb 560w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/new-application.png?w=840\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=2111c1f76ad70880f883b43abc48d179 840w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/new-application.png?w=1100\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=ad0d3f6019fc6795516a05ed7eb86b55 1100w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/new-application.png?w=1650\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=b2063bec82e58bf885169a8f3ab9cb55 1650w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/new-application.png?w=2500\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=5719d2d21e7f8820927c46950adc2d2c 2500w`})}),_jsx(Frame,{caption:`Name the application, choose Non-gallery and click Create`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/create-your-own-application.png?fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=031f8129b5b5701d91deba20e75e3b30`,alt:`The Create your own application panel, with the name field empty and the Non-gallery option selected`,\"data-og-width\":`1040`,width:`1040`,\"data-og-height\":`658`,height:`658`,\"data-path\":`images/integrations/microsoft-entra-id/create-your-own-application.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/create-your-own-application.png?w=280\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=430c745fedb6b076ace9cbc40afc0b01 280w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/create-your-own-application.png?w=560\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=673171f4f69533f770ff41fdf41ce81a 560w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/create-your-own-application.png?w=840\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=fb26abe365289f536d07e8a570def145 840w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/create-your-own-application.png?w=1100\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=6907774364b39b8651fc3d23d343461a 1100w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/create-your-own-application.png?w=1650\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=b6e0be20240cddaa10bb407876e5b508 1650w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/create-your-own-application.png?w=2500\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=b1e7a90e4c1913b2019120075982ef3a 2500w`})})]}),_jsxs(Step,{title:`Assign people`,children:[_jsxs(_components.p,{children:[`In the Cimento application, open `,_jsx(_components.strong,{children:`Users and groups`}),` and click `,_jsx(_components.strong,{children:`Add user/group`}),`. Choose the people and groups who should use Cimento, then click `,_jsx(_components.strong,{children:`Select`}),` and `,_jsx(_components.strong,{children:`Assign`}),`. Assign yourself too, so you can sign in to Cimento through Entra. Entra only sends direct members of a group you assign, not members of groups nested inside it. Back in Cimento, click `,_jsx(_components.strong,{children:`Next`}),`.`]}),_jsx(Frame,{caption:`Users and groups › Add user/group`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/add-user-group.png?fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=74d358ad8c90d10d9b3955bc314bc183`,alt:`The Users and groups page of the application, with the Add user/group button highlighted`,\"data-og-width\":`768`,width:`768`,\"data-og-height\":`544`,height:`544`,\"data-path\":`images/integrations/microsoft-entra-id/add-user-group.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/add-user-group.png?w=280\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=62241e78b534144f5421d637f78ff889 280w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/add-user-group.png?w=560\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=cde172e2cb5dab88b9af03559e140898 560w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/add-user-group.png?w=840\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=a71806e12f062eed7e911a4367541ca8 840w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/add-user-group.png?w=1100\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=d3861df75b9b9351954dde43c641ce3e 1100w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/add-user-group.png?w=1650\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=3a222f606ada8f972e470a112942f55c 1650w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/add-user-group.png?w=2500\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=7e81c736598625bfb155b99b4f4a2b25 2500w`})}),_jsx(Frame,{caption:`Pick the people to assign, then click Select and Assign`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/select-users.png?fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=7b2a6a06f57ddb76fe83d281a9080c56`,alt:`The Add Assignment page with the Users panel open and one user checked`,\"data-og-width\":`1301`,width:`1301`,\"data-og-height\":`828`,height:`828`,\"data-path\":`images/integrations/microsoft-entra-id/select-users.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/select-users.png?w=280\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=145cb038b0367605ae5797a95aab67e5 280w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/select-users.png?w=560\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=9ef8ae80d4eb0c613dd4277198f2f1be 560w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/select-users.png?w=840\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=39913a4f0d8c26f6a9656226fc72d655 840w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/select-users.png?w=1100\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=7e507535531dc9c855020d9d88dd335e 1100w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/select-users.png?w=1650\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=13c7e499413efa4b2497e2511d7d496d 1650w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/select-users.png?w=2500\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=d0f8e14bee1ea60babaa41baa3a607b2 2500w`})})]}),_jsxs(Step,{title:`Connect provisioning`,children:[_jsxs(_components.p,{children:[`In the Cimento application, open `,_jsx(_components.strong,{children:`Provisioning`}),` and click `,_jsx(_components.strong,{children:`Connect your application`}),`. If you see `,_jsx(_components.strong,{children:`Get started`}),` instead, click it and set `,_jsx(_components.strong,{children:`Provisioning Mode`}),` to `,_jsx(_components.strong,{children:`Automatic`}),`. Keep `,_jsx(_components.strong,{children:`Bearer authentication`}),`. From Cimento’s `,_jsx(_components.strong,{children:`Provisioning`}),` step, copy the `,_jsx(_components.strong,{children:`Tenant URL`}),` into Entra, then click `,_jsx(_components.strong,{children:`Copy`}),` next to `,_jsx(_components.strong,{children:`Secret Token`}),` and paste it into Entra’s `,_jsx(_components.strong,{children:`Secret token`}),` field. Click `,_jsx(_components.strong,{children:`Test connection`}),`, and when it succeeds, click `,_jsx(_components.strong,{children:`Create`}),` or `,_jsx(_components.strong,{children:`Save`}),`. You don’t need to change the attribute mappings.`]}),_jsx(Frame,{caption:`Open Provisioning from the application's menu`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/open-provisioning.png?fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=7cd357a75d39e5e330bebfc2fd8a4fb7`,alt:`The application's Overview page, with Provisioning highlighted in the left menu`,\"data-og-width\":`570`,width:`570`,\"data-og-height\":`630`,height:`630`,\"data-path\":`images/integrations/microsoft-entra-id/open-provisioning.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/open-provisioning.png?w=280\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=183d322f7ee98a54ecd60067314f95a6 280w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/open-provisioning.png?w=560\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=1f821cf24e09dd8a04965b21d241025e 560w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/open-provisioning.png?w=840\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=6b99088d23a497c1c55edc750f9c7f31 840w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/open-provisioning.png?w=1100\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=85ec7c9919fd60247eb661747511f28d 1100w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/open-provisioning.png?w=1650\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=dc017aa80f1a6e6b1edd4b0eb4a6162d 1650w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/open-provisioning.png?w=2500\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=74ea18e72d06b40598fda06ae1d415e8 2500w`})}),_jsx(Frame,{caption:`Bearer authentication, the Tenant URL and the Secret Token, shown in the older Provisioning layout`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/provisioning-credentials.png?fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=e7b93d730411186c7ab94e5ab86c60ba`,alt:`The Provisioning page with Provisioning Mode set to Automatic and the Admin Credentials section expanded, showing Bearer Authentication, the Tenant URL, a masked Secret Token and the Test Connection button`,\"data-og-width\":`750`,width:`750`,\"data-og-height\":`826`,height:`826`,\"data-path\":`images/integrations/microsoft-entra-id/provisioning-credentials.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/provisioning-credentials.png?w=280\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=d559399912e916aa55d690dd0a9647e7 280w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/provisioning-credentials.png?w=560\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=0522c49d249e4b549d33ab429631c432 560w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/provisioning-credentials.png?w=840\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=022cf44dbc89b56720e5d04d2f306b68 840w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/provisioning-credentials.png?w=1100\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=77a56e39325698088a13d311983e3d04 1100w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/provisioning-credentials.png?w=1650\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=ca469b1abe628494812abfe6b238d4c6 1650w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/provisioning-credentials.png?w=2500\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=76636690a40597f3484737065ce7e5a1 2500w`})})]}),_jsx(Step,{title:`Start provisioning`,children:_jsxs(_components.p,{children:[`On the provisioning `,_jsx(_components.strong,{children:`Overview`}),`, click `,_jsx(_components.strong,{children:`Start provisioning`}),`. In the older layout, set `,_jsx(_components.strong,{children:`Provisioning Status`}),` to `,_jsx(_components.strong,{children:`On`}),` and click `,_jsx(_components.strong,{children:`Save`}),`. Keep the scope at `,_jsx(_components.strong,{children:`Sync only assigned users and groups`}),`. Entra syncs about every 40 minutes. To check it right away, use `,_jsx(_components.strong,{children:`Provision on demand`}),` with your own account. Back in Cimento, click `,_jsx(_components.strong,{children:`Next`}),`.`]})}),_jsxs(Step,{title:`Set up single sign-on`,children:[_jsxs(_components.p,{children:[`In the Cimento application, open `,_jsx(_components.strong,{children:`Single sign-on`}),` and choose `,_jsx(_components.strong,{children:`SAML`}),`. Click `,_jsx(_components.strong,{children:`Edit`}),` in `,_jsx(_components.strong,{children:`Basic SAML Configuration`}),`. Click `,_jsx(_components.strong,{children:`Add identifier`}),` and paste the `,_jsx(_components.strong,{children:`Identifier (Entity ID)`}),` from Cimento’s `,_jsx(_components.strong,{children:`Single sign-on`}),` step. Click `,_jsx(_components.strong,{children:`Add reply URL`}),` and paste the `,_jsx(_components.strong,{children:`Reply URL`}),` from the same Cimento step. It ends in `,_jsx(_components.code,{children:`/auth/v1/sso/saml/acs`}),`. Leave the `,_jsx(_components.strong,{children:`Index`}),` box next to it empty: Cimento has a single reply URL, so Entra doesn’t need an index to choose between them. Leave `,_jsx(_components.strong,{children:`Default`}),` as it is. Leave `,_jsx(_components.strong,{children:`Sign on URL`}),`, `,_jsx(_components.strong,{children:`Relay State`}),` and `,_jsx(_components.strong,{children:`Logout Url`}),` empty, and click `,_jsx(_components.strong,{children:`Save`}),`.`]}),_jsx(Frame,{caption:`Single sign-on › SAML`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/choose-saml.png?fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=54f270d08d74b5fce10d0c9eaddce5bd`,alt:`The Select a single sign-on method page, with the SAML option highlighted`,\"data-og-width\":`1358`,width:`1358`,\"data-og-height\":`564`,height:`564`,\"data-path\":`images/integrations/microsoft-entra-id/choose-saml.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/choose-saml.png?w=280\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=8a04d8d5e188289d34034c6769e0c618 280w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/choose-saml.png?w=560\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=ab9443ef2f2409e63f4e062aec6d961e 560w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/choose-saml.png?w=840\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=a8b13b87527977bfac70389fea167003 840w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/choose-saml.png?w=1100\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=3c2477d130a35a5a37fe2b227ae76fed 1100w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/choose-saml.png?w=1650\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=7016cfac6e3bf53b3db70edf5d56a62a 1650w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/choose-saml.png?w=2500\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=239c609e56c81baadd72ac9ea38af8a0 2500w`})}),_jsx(Frame,{caption:`Add the Identifier and the Reply URL; leave the optional fields empty`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/basic-saml-configuration.png?fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=3237082874e589780e214406054797eb`,alt:`The Basic SAML Configuration panel, with Add identifier and Add reply URL links and empty optional fields`,\"data-og-width\":`850`,width:`850`,\"data-og-height\":`817`,height:`817`,\"data-path\":`images/integrations/microsoft-entra-id/basic-saml-configuration.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/basic-saml-configuration.png?w=280\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=5c933c2ca1ee92cf0cbdb5e5a7b8fe7b 280w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/basic-saml-configuration.png?w=560\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=c7a05a96268681d3aac3ba384141dc4d 560w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/basic-saml-configuration.png?w=840\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=23f5b4f574316ec49fd9bb034edb229d 840w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/basic-saml-configuration.png?w=1100\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=a333488a96a35ff7405914cd052ead97 1100w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/basic-saml-configuration.png?w=1650\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=df0fa08e6f0fdeebcb7da255c1073cf2 1650w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/basic-saml-configuration.png?w=2500\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=167df8a99c9b8c9079006970bc0f48e8 2500w`})})]}),_jsxs(Step,{title:`Send email addresses as the user identifier`,children:[_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Attributes \u0026 Claims`}),`, click `,_jsx(_components.strong,{children:`Edit`}),`, then the `,_jsx(_components.strong,{children:`Unique User Identifier (Name ID)`}),` claim. Set `,_jsx(_components.strong,{children:`Name identifier format`}),` to `,_jsx(_components.strong,{children:`Email address`}),`, `,_jsx(_components.strong,{children:`Source`}),` to `,_jsx(_components.strong,{children:`Attribute`}),` and `,_jsx(_components.strong,{children:`Source attribute`}),` to `,_jsx(_components.code,{children:`user.mail`}),`, and click `,_jsx(_components.strong,{children:`Save`}),`. Back in Cimento, click `,_jsx(_components.strong,{children:`Next`}),`.`]}),_jsx(Frame,{caption:`Click the Unique User Identifier (Name ID) claim`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/attributes-and-claims.png?fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=79f918604432380b730c1930061d1cca`,alt:`The Attributes \u0026 Claims page, listing the required Unique User Identifier (Name ID) claim with the value user.userprincipalname`,\"data-og-width\":`863`,width:`863`,\"data-og-height\":`232`,height:`232`,\"data-path\":`images/integrations/microsoft-entra-id/attributes-and-claims.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/attributes-and-claims.png?w=280\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=203f21ea238aad4991156adbaf9da126 280w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/attributes-and-claims.png?w=560\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=c8020ad1a89b7bfd2ddcb12799d84280 560w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/attributes-and-claims.png?w=840\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=9ca29440097b370a79dd1638603d881d 840w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/attributes-and-claims.png?w=1100\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=13fd09a083b7cfa37a2daebe316fa624 1100w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/attributes-and-claims.png?w=1650\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=a8eb31120c9a0bc48e39a0ab04a46c54 1650w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/attributes-and-claims.png?w=2500\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=0b6e8ae06015d918409dbcf8a244899c 2500w`})}),_jsx(Frame,{caption:`Email address format, Attribute source, user.mail`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/manage-claim-user-mail.png?fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=c0b133f193fafb7b5b48ad3cd7d70332`,alt:`The Manage claim page, with Name identifier format set to Email address, Source set to Attribute and Source attribute set to user.mail`,\"data-og-width\":`683`,width:`683`,\"data-og-height\":`463`,height:`463`,\"data-path\":`images/integrations/microsoft-entra-id/manage-claim-user-mail.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/manage-claim-user-mail.png?w=280\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=15316240e5f621ff1bb3035ccb1516bd 280w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/manage-claim-user-mail.png?w=560\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=3973b2860df7e54d6be701548e154a5b 560w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/manage-claim-user-mail.png?w=840\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=569fa7f3bc3d5e942fd8f7229507716c 840w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/manage-claim-user-mail.png?w=1100\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=f1b90784012d5828e3cee66a9655be4b 1100w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/manage-claim-user-mail.png?w=1650\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=d899bd1348eed1f9658b140d5c1821da 1650w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/manage-claim-user-mail.png?w=2500\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=95a9568cf6c79c63ce436cccbdbde9b4 2500w`})})]}),_jsxs(Step,{title:`Turn on single sign-on`,children:[_jsx(Note,{children:_jsx(_components.p,{children:`Single sign-on adds a way to sign in; it doesn’t replace email sign-in links. Everyone can still sign in with a link sent to their work email. Signing in through Entra works only for people assigned to the Cimento application who are already in Cimento, so finish steps 3 to 5 first.`})}),_jsxs(_components.p,{children:[`On Entra’s `,_jsx(_components.strong,{children:`Single sign-on`}),` page, copy the `,_jsx(_components.strong,{children:`App Federation Metadata Url`}),` from `,_jsx(_components.strong,{children:`SAML Certificates`}),`. Paste it into Cimento’s `,_jsx(_components.strong,{children:`Metadata URL`}),` step and click `,_jsx(_components.strong,{children:`Save configuration`}),`. When Cimento shows `,_jsx(_components.strong,{children:`SSO configured`}),`, people with an address in your domains can click `,_jsx(_components.strong,{children:`Sign in with SSO`}),` on Cimento’s sign-in page to sign in through Entra, or `,_jsx(_components.strong,{children:`Email me a sign-in link`}),` instead.`]}),_jsx(Frame,{caption:`Copy the App Federation Metadata Url from SAML Certificates`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/app-federation-metadata-url.png?fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=6a5ee750d187c40d23238e5720aa4ec1`,alt:`The SAML Certificates section, with the copy button next to App Federation Metadata Url highlighted`,\"data-og-width\":`764`,width:`764`,\"data-og-height\":`378`,height:`378`,\"data-path\":`images/integrations/microsoft-entra-id/app-federation-metadata-url.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/app-federation-metadata-url.png?w=280\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=c50ae93443d401fb4ac47e3228813b4b 280w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/app-federation-metadata-url.png?w=560\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=235e4e055d027cc2579539f86f618565 560w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/app-federation-metadata-url.png?w=840\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=e9096bf11392d0f87996e0330621418c 840w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/app-federation-metadata-url.png?w=1100\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=0e657e667f5d0e74a79187d8cc0e077a 1100w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/app-federation-metadata-url.png?w=1650\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=78864ae0768e8138b15cb1935ac1e581 1650w, https://mintcdn.com/cimento/kKBfkqUDeQkrYoIW/images/integrations/microsoft-entra-id/app-federation-metadata-url.png?w=2500\u0026fit=max\u0026auto=format\u0026n=kKBfkqUDeQkrYoIW\u0026q=85\u0026s=8011313bd8c5651d8f115ed020b0a4a8 2500w`})})]}),_jsx(Step,{title:`Verify`,children:_jsxs(_components.p,{children:[`In Cimento’s `,_jsx(_components.strong,{children:`Verify`}),` step, click `,_jsx(_components.strong,{children:`Test connection`}),`. It checks that single sign-on is connected to your Entra tenant and activates the integration. Then try it yourself: open `,_jsx(_components.a,{href:`https://myapps.microsoft.com`,children:`My Apps`}),` and select Cimento, or enter your work email on Cimento’s sign-in page and click `,_jsx(_components.strong,{children:`Sign in with SSO`}),`. Entra’s `,_jsx(_components.strong,{children:`Test connection`}),` in step 4 is the check for provisioning, and Entra’s `,_jsx(_components.strong,{children:`Provisioning logs`}),` show each person it sent.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`if-something-goes-wrong`,children:`If something goes wrong`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Cimento shows`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`That isn’t the App Federation Metadata Url`}),_jsxs(_components.td,{children:[`Copy the `,_jsx(_components.strong,{children:`App Federation Metadata Url`}),` from `,_jsx(_components.strong,{children:`SAML Certificates`}),` on the Cimento application’s `,_jsx(_components.strong,{children:`Single sign-on`}),` page. It starts with `,_jsx(_components.code,{children:`https://login.microsoftonline.com/`}),` and ends with `,_jsx(_components.code,{children:`?appid=`}),` and the application’s ID.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Microsoft didn’t return a SAML signing certificate for that app`}),_jsxs(_components.td,{children:[`Check that you copied the URL from the Cimento application and that its `,_jsx(_components.strong,{children:`SAML Certificates`}),` section has an active certificate, then save the URL again.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The Cimento app’s SAML signing certificate has expired`}),_jsxs(_components.td,{children:[`In `,_jsx(_components.strong,{children:`SAML Certificates`}),`, create a new certificate and make it active, then save the URL again.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The Cimento app’s SAML signing certificate isn’t valid yet`}),_jsxs(_components.td,{children:[`In `,_jsx(_components.strong,{children:`SAML Certificates`}),`, make a certificate that’s valid today active, or wait until the new one starts, then save the URL again.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`We couldn’t read that metadata from Microsoft`}),_jsx(_components.td,{children:`Check the URL, wait a minute, then save it again.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Single sign-on could not be set up from that URL`}),_jsxs(_components.td,{children:[`Copy the `,_jsx(_components.strong,{children:`App Federation Metadata Url`}),` again from `,_jsx(_components.strong,{children:`SAML Certificates`}),` and save it. If the message comes back, contact Cimento support.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Your organization has no email domains set up yet`}),_jsx(_components.td,{children:`Ask your Cimento contact to add your email domains, then save the metadata URL again.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Your organization’s domains or this identity provider are already connected to single sign-on in a way Cimento can’t change automatically`}),_jsx(_components.td,{children:`Contact Cimento support to move the connection.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Single sign-on is not connected for your organization yet`}),_jsxs(_components.td,{children:[`Go back to the `,_jsx(_components.strong,{children:`Metadata URL`}),` step and save it again.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Single sign-on for your organization’s domains is connected to a different identity provider or Microsoft Entra tenant`}),_jsx(_components.td,{children:`Contact Cimento support to switch it.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`You don’t have permission to view this value`}),_jsx(_components.td,{children:`Ask a Cimento user with the Admin role to copy the secret token for you.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`If single sign-on is already working and you replace the Cimento application’s SAML signing certificate in Entra, contact Cimento support so Cimento starts using the new certificate. Saving the same `,_jsx(_components.strong,{children:`App Federation Metadata Url`}),` again doesn’t pick it up.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-entra-sends`,children:`What Entra sends`}),`\n`,_jsxs(_components.p,{children:[`Cimento uses each employee’s primary email, name, title, department, manager and phone numbers, and mirrors the groups you assign. See `,_jsx(_components.a,{href:`/getting-started/employee-directory#what-okta-and-microsoft-entra-id-send`,children:`What Okta and Microsoft Entra ID send`}),` for how each attribute maps and what happens when someone leaves.`]}),`\n`,_jsx(Heading,{level:`2`,id:`stop-provisioning`,children:`Stop provisioning`}),`\n`,_jsxs(_components.p,{children:[`The secret token lets Entra create, update and deactivate employees in Cimento, so store it like a password. To stop Entra from updating Cimento, click `,_jsx(_components.strong,{children:`Stop provisioning`}),` on the provisioning `,_jsx(_components.strong,{children:`Overview`}),` (in the older layout, set `,_jsx(_components.strong,{children:`Provisioning Status`}),` to `,_jsx(_components.strong,{children:`Off`}),`), or delete the enterprise application.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Connect Microsoft Entra ID","sidebarTitle":"Microsoft Entra ID","description":"Import employees and groups from Microsoft Entra ID over SCIM and set up single sign-on, step by step, with an enterprise application you create in Entra.","href":"/integrations/microsoft-entra-id"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Steps","slug":"steps","depth":2,"children":[]},{"title":"If something goes wrong","slug":"if-something-goes-wrong","depth":2,"children":[]},{"title":"What Entra sends","slug":"what-entra-sends","depth":2,"children":[]},{"title":"Stop provisioning","slug":"stop-provisioning","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"cimento","siteName":"Cimento","title":"Connect Microsoft Entra ID - Cimento","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T20:07:01.226Z","originalFileLocation":"integrations/microsoft-entra-id.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Import employees and groups from Microsoft Entra ID over SCIM and set up single sign-on, step by step, with an enterprise application you create in Entra.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cimento\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cimento/qgeEwfTN-9uV7GQH/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cimento/qgeEwfTN-9uV7GQH/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cimento/qgeEwfTN-9uV7GQH/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cimento/qgeEwfTN-9uV7GQH/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cimento/qgeEwfTN-9uV7GQH/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cimento/qgeEwfTN-9uV7GQH/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cimento/qgeEwfTN-9uV7GQH/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cimento/qgeEwfTN-9uV7GQH/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cimento/qgeEwfTN-9uV7GQH/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect Microsoft Entra ID - Cimento\">\u003cmeta data-mint-head property=\"og:description\" content=\"Import employees and groups from Microsoft Entra ID over SCIM and set up single sign-on, step by step, with an enterprise application you create in Entra.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cimento\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cimento.ai/integrations/microsoft-entra-id\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cimento.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=Connect+Microsoft+Entra+ID\u0026amp;description=Import+employees+and+groups+from+Microsoft+Entra+ID+over+SCIM+and+set+up+single+sign-on%2C+step+by+step%2C+with+an+enterprise+application+you+create+in+Entra.\u0026amp;theme=252e6b1e81af8d9b3946c939\u0026amp;signature=982dbd79b14adfc6ed5c5b96317c370e16fc23f3a9a776ee63da46c4724d40d8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Connect Microsoft Entra ID - Cimento\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Import employees and groups from Microsoft Entra ID over SCIM and set up single sign-on, step by step, with an enterprise application you create in Entra.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cimento.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=Connect+Microsoft+Entra+ID\u0026amp;description=Import+employees+and+groups+from+Microsoft+Entra+ID+over+SCIM+and+set+up+single+sign-on%2C+step+by+step%2C+with+an+enterprise+application+you+create+in+Entra.\u0026amp;theme=252e6b1e81af8d9b3946c939\u0026amp;signature=982dbd79b14adfc6ed5c5b96317c370e16fc23f3a9a776ee63da46c4724d40d8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cimento/qgeEwfTN-9uV7GQH/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cimento\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ef7025\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cimento.ai/integrations/microsoft-entra-id\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/integrations/microsoft-entra-id.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cimento.ai/#organization\",\"name\":\"Cimento\",\"url\":\"https://docs.cimento.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cimento/v0wi2YRA3DkT313c/logo/light.svg?fit=max\u0026auto=format\u0026n=v0wi2YRA3DkT313c\u0026q=85\u0026s=7a3436b9d20a014e858cd2d35957fd63\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cimento.ai#website\",\"name\":\"Cimento\",\"url\":\"https://docs.cimento.ai\",\"publisher\":{\"@id\":\"https://docs.cimento.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cimento.ai/integrations/microsoft-entra-id#webpage\",\"url\":\"https://docs.cimento.ai/integrations/microsoft-entra-id\",\"name\":\"Connect Microsoft Entra ID\",\"description\":\"Import employees and groups from Microsoft Entra ID over SCIM and set up single sign-on, step by step, with an enterprise application you create in Entra.\",\"dateModified\":\"2026-10-22T20:07:01.226Z\",\"isPartOf\":{\"@id\":\"https://docs.cimento.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cimento.ai/integrations/microsoft-entra-id#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cimento.ai/integrations/microsoft-entra-id#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Integrations\",\"item\":\"https://docs.cimento.ai/integrations/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect Microsoft Entra ID\",\"item\":\"https://docs.cimento.ai/integrations/microsoft-entra-id\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cimento.ai/integrations/microsoft-entra-id#article\",\"headline\":\"Connect Microsoft Entra ID\",\"name\":\"Connect Microsoft Entra ID\",\"description\":\"Import employees and groups from Microsoft Entra ID over SCIM and set up single sign-on, step by step, with an enterprise application you create in Entra.\",\"url\":\"https://docs.cimento.ai/integrations/microsoft-entra-id\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cimento.ai/integrations/microsoft-entra-id#webpage\"},\"dateModified\":\"2026-10-22T20:07:01.226Z\",\"publisher\":{\"@id\":\"https://docs.cimento.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cimento.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cimento\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cimento\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/integrations/microsoft-entra-id.md","siteName":"Cimento","nav":{"global":null,"groups":[{"group":"Getting Started","icon":"rocket","pages":[{"title":"Cimento Documentation","sidebarTitle":"Welcome","icon":"house","href":"/index"},{"title":"Before you begin","href":"/getting-started/before-you-begin"},{"title":"Connect your employee directory","sidebarTitle":"Employee directory","href":"/getting-started/employee-directory"}]},{"group":"Integrations","icon":"plug","pages":[{"title":"Integrations","sidebarTitle":"Overview","href":"/integrations/overview"},{"title":"Connect Okta","sidebarTitle":"Okta","description":"Import employees and groups from Okta over SCIM and set up single sign-on, step by step, using the Cimento AI app from the Okta Integration Network.","href":"/integrations/okta"},{"title":"Connect Microsoft Entra ID","sidebarTitle":"Microsoft Entra ID","href":"/integrations/microsoft-entra-id"},{"title":"Connect Google Workspace","sidebarTitle":"Google Workspace","description":"Import your Google Workspace directory and place phishing simulations directly in Gmail inboxes, step by step, using domain-wide delegation.","href":"/integrations/google-workspace"},{"title":"Connect Microsoft 365","sidebarTitle":"Microsoft 365","href":"/integrations/microsoft-365"},{"title":"Phish Alert Button for Outlook","sidebarTitle":"Phish Alert Button for Outlook","href":"/integrations/outlook-phish-alert-button"},{"title":"Connect Slack","sidebarTitle":"Slack","href":"/integrations/slack"}]},{"group":"Webhooks","icon":"webhook","pages":[{"title":"Webhooks","sidebarTitle":"Overview","href":"/webhooks/overview"},{"title":"Receiving events","href":"/webhooks/receiving-events"},{"title":"Verifying signatures","href":"/webhooks/verifying-signatures"},{"title":"Delivery and retries","href":"/webhooks/delivery-and-retries"},{"group":"Event reference","pages":[{"title":"Phishing events","href":"/webhooks/phishing-events"},{"title":"Training events","href":"/webhooks/training-events"},{"title":"Agent Hub events","href":"/webhooks/agent-hub-events"}]}]},{"group":"Phishing","icon":"fish","pages":[{"title":"Phishing simulation overview","sidebarTitle":"Overview","href":"/phishing/overview"},{"title":"AutoPhish","sidebarTitle":"AutoPhish","href":"/phishing/autophish"},{"title":"AutoPhish review and results","sidebarTitle":"AutoPhish results","href":"/phishing/autophish-results"},{"title":"Connect email delivery","sidebarTitle":"Email delivery","href":"/phishing/email-delivery"},{"title":"Mailbox permissions for direct delivery","sidebarTitle":"Mailbox permissions","href":"/phishing/mailbox-permissions"},{"title":"SMS and voice simulations","sidebarTitle":"SMS and voice","href":"/phishing/sms-and-voice"},{"title":"Templates and campaigns","sidebarTitle":"Campaigns","href":"/phishing/campaigns"}]},{"group":"Training","icon":"graduation-cap","pages":[{"title":"Training overview","sidebarTitle":"Overview","href":"/training/overview"},{"title":"Training content","sidebarTitle":"Content","href":"/training/content"},{"title":"Training campaigns","sidebarTitle":"Campaigns","href":"/training/campaigns"},{"title":"Send training emails from your domain","sidebarTitle":"Sending from your domain","href":"/training/sending-domain"},{"title":"Policy acknowledgments","sidebarTitle":"Policies","href":"/training/policies"}]},{"group":"Agent Hub","icon":"bot","pages":[{"title":"Agent Hub overview","sidebarTitle":"Overview","href":"/agent-hub/overview"},{"title":"How the Agent Hub endpoint agent works","sidebarTitle":"How it works","href":"/agent-hub/how-it-works"},{"title":"What data Agent Hub collects","sidebarTitle":"Data collected","href":"/agent-hub/data-collected"},{"group":"Deploy with your MDM","pages":[{"title":"Deploy Agent Hub with Jamf Pro","sidebarTitle":"Jamf Pro","href":"/agent-hub/deploy/jamf"},{"title":"Deploy Agent Hub with Iru","sidebarTitle":"Iru","href":"/agent-hub/deploy/iru"},{"title":"Deploy Agent Hub with SimpleMDM","sidebarTitle":"SimpleMDM","href":"/agent-hub/deploy/simplemdm"},{"title":"Deploy Agent Hub with Microsoft Intune","sidebarTitle":"Microsoft Intune","href":"/agent-hub/deploy/intune"}]}]},{"group":"Updates","icon":"clock-rotate-left","pages":[{"title":"Changelog","icon":"clock-rotate-left","href":"/changelog"}]}]},"basePath":"","title":"Connect Microsoft Entra ID - Cimento","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BRsfsIIG.js","DynamicMarkdown-NFqqduU7.js","zoom-image-lightbox-BguUeq2N.js","lightbox-handle-r17bVUz3.js"]}