| # | Action | Notes |
|---|---|---|
| 1 | Ask the partner organisation to confirm their identity provider and which federation protocols it supports | SAML 2.0 or WS-Fed required |
| 2 | Confirm the partner's IdP can provide a passive authentication endpoint | This is the URL Entra will redirect users to for authentication |
| # | Action | Notes |
|---|---|---|
| 1 | Obtain the partner's passive authentication endpoint URL | e.g. https://idp.example.com/adfs/ls |
| 2 | Identify the domain portion of their users' UPNs | e.g. users signing in as user@example.com |
| 3 | Verify the endpoint URL falls within the same domain as the UPNs | See examples below |
https://version1.com — exact domain matchhttps://sso.version1.com — subdomain of matching domainhttps://sso.version1.com/adfs/ls — subdomain with pathhttps://version1.co.uk — different TLD, domain does not match version1.comhttps://otherprovider.com/version1 — entirely different domain@example.com but the IdP endpoint is at example.co.uk), a DNS TXT record must be added to the UPN domain's DNS zone. This record tells Entra ID that the domain owner has explicitly authorised the cross-domain authentication endpoint — it is a domain ownership verification mechanism that prevents spoofing.| # | Action | Notes |
|---|---|---|
| 1 | If Step 2 identified a domain mismatch, request the partner adds a DNS TXT record to their UPN domain | The partner's DNS admin will need to do this |
| 2 | The TXT record format is shown below | This declares the authorised authentication URL |
| 3 | Verify the TXT record has been published before proceeding | Use nslookup -type=TXT domain.com to verify |
version1.com. IN TXT "DirectFedAuthUrl=https://version1.co.uk"
| # | Action | Notes |
|---|---|---|
| 1 | Send the partner the "External IdAM – Onboarding Document (For Suppliers)" | This document specifies the required claims and attributes |
| 2 | Ask the partner to configure their IdP according to the document | Their identity/SSO team will need to create a relying party trust or SAML application |
| 3 | Request the partner provides their IdP metadata file (if available) | An XML file containing their endpoint, issuer URI, and signing certificate — simplifies Step 6 |
Required information from the partner:
| # | Action | Notes |
|---|---|---|
| 1 | Navigate to Entra Admin Centre | entra.microsoft.com |
| 2 | Sign in with your PRV account | Elevate to External Identity Provider Administrator via PIM |
| 3 | Navigate to Entra ID → External Identities → All identity providers |
| # | Action | Notes |
|---|---|---|
| 1 | Click the Custom tab | |
| 2 | Click Add new → select SAML/WS-Fed | |
| 3 | Enter Display name | A friendly name for the partner (e.g. "Version1 SSO") |
| 4 | Select Identity provider protocol | SAML or WS-Fed — as confirmed in Step 1 |
| 5 | Enter the Domain name of federating IdP | The domain that matches the partner's user UPNs |
Configure metadata:
| # | Action | Notes |
|---|---|---|
| 6 | Choose metadata population method | "Parse metadata file" (if partner provided one) or "Input metadata manually" |
| 7 | Enter or parse: Issuer URI | Unique identifier for the partner's IdP |
| 8 | Enter or parse: Passive authentication endpoint | URL where users are redirected to authenticate |
| 9 | Upload or parse: Signing certificate | X.509 certificate for token signature verification |
| 10 | Enter Metadata URL (if available) | Enables automatic certificate renewal — highly recommended |
| 11 | Click Save |
| # | Action | Notes |
|---|---|---|
| 1 | Sign in with a PRV account elevated to Security Administrator | Different role than Phase C — re-elevate if needed |
| 2 | Navigate to Entra ID → External Identities → External collaboration settings | |
| 3 | Under Default settings, click Edit inbound defaults | |
| 4 | Under B2B collaboration, click Redemption order | |
| 5 | Tick SAML/WS-Fed Identity Providers | If not already ticked |
| 6 | Click Move up to raise the priority above Entra | Custom federation should be evaluated before Entra-to-Entra trust |
| 7 | Click Save |