Managing external identities to enable secure access for partners, customers, and other non-employees
- The supported way to replace
*.ciamlogin.comwith a branded domain is to configure a custom URL domain for the external tenant and then use that custom domain in the application sign-in URLs and user flows. A verified custom URL domain lets the sign-in endpoints use the branded domain instead of<tenant-name>.ciamlogin.com, so users stay on the branded domain during sign-in. - The documentation explicitly states that custom URL domains now support Google and Facebook in addition to Apple for external tenants. This means social identity providers (Google, Facebook, Apple) are supported with custom URL domains. The in-portal warning that says “configured social identity providers will not be supported in the user flows via a Custom URL domain” is inconsistent with the documentation and is effectively outdated relative to the documented capability. Users can still sign up and sign in with their social identities when a custom URL domain is configured; the sign-in experience is branded with the custom domain instead of
ciamlogin.com. - At a high level, the steps to configure this correctly are:
- Configure and verify a custom URL domain for the external tenant (External Identities → Custom URL domains) so that the tenant has a branded domain available instead of
<tenant-name>.ciamlogin.com. - Test the custom URL domain with a user flow:
- In the Microsoft Entra admin center, switch to the external tenant.
- Go to External Identities → User flows.
- Select the relevant user flow and choose Run user flow.
- Select a web application (for example,
webapp1with reply URLhttps://jwt.ms). - Copy the Run user flow endpoint URL.
- In that URL, replace the domain segment
(<tenant-name>.ciamlogin.com)with the custom URL domain.- Example from the documentation:
- Default:
https://contoso.ciamlogin.com/contoso.onmicrosoft.com/oauth2/v2.0/authorize?... - Custom domain:
https://login.contoso.com/contoso.onmicrosoft.com/oauth2/v2.0/authorize?...
- Default:
- Example from the documentation:
- Open the modified URL in a browser and verify that the sign-in page loads correctly and that sign-in (including social identity providers such as Google and Facebook) works.
- Update application configurations and any integration points to use the custom URL domain instead of
*.ciamlogin.comin their authority/issuer or sign-in URLs, so that all sign-in flows go through the branded domain. - Optionally, after confirming that the custom URL domain works end-to-end, request blocking of the default
*.ciamlogin.comdomain via a support ticket, as recommended for security. Before blocking, ensure all features and apps that previously used*.ciamlogin.comare updated to use the custom URL domain.
- Configure and verify a custom URL domain for the external tenant (External Identities → Custom URL domains) so that the tenant has a branded domain available instead of
References: