Houses of Parliament
Restoration & Renewal
External IdAM — Federation Guide
Houses of Parliament Restoration & Renewal
External IdAM

B2B Collaboration Non-Entra Identity Providers

A step-by-step guide for configuring new supplier organisations as B2B collaboration partners where they do not use Entra ID as their identity provider. Covers partner IdP validation, SAML/WS-Fed federation setup, and redemption order configuration.

SAML 2.0 · WS-Fed · Custom IdP Federation · Entra External Identities SAML 2.0 / WS-Fed Custom Federation B2B Collaboration External Identities Version 1.0 Author: Koz Georgiou
Completion
0 / 9
Background & Purpose
What is Non-Entra B2B Federation?

When R&R collaborates with external suppliers, those suppliers' users need to access R&R's Microsoft 365 resources. If the supplier uses Entra ID (Azure AD) as their identity provider, federation is straightforward — Entra-to-Entra trust is built in. But many suppliers use other identity systems such as Okta, Ping Identity, ADFS, or Google Workspace.

For these organisations, R&R can configure custom SAML 2.0 or WS-Fed federation in Entra External Identities. This allows the supplier's users to accept B2B collaboration invites and authenticate using their home identity — they sign in with their own company credentials, managed by their own IdP, rather than needing a separate Microsoft account or one-time passcode.

This guide walks through the end-to-end process: validating the partner's IdP compatibility, coordinating the technical configuration with the supplier, setting up the federation in R&R's Entra tenant, and — if needed — adjusting the redemption order so custom federation takes priority over Entra trust.

Federation Setup Flow
Validate Partner
IdP ReadinessProtocol & domain
Partner Configures
Their IdPClaims & attributes
Configure Federation
in R&R EntraSAML/WS-Fed setup
Adjust Redemption
Order (if needed)Priority config
Partner Users
AuthenticateHome identity
🔐
Prerequisites & Required Permissions
Federation SetupExternal Identity Provider Administrator (minimum), activated via PIM using a PRV account
Redemption OrderSecurity Administrator (minimum), activated via PIM using a PRV account
PortalEntra Admin Centre — entra.microsoft.com
Partner InformationPartner IdP protocol (SAML 2.0 or WS-Fed), passive authentication URL, signing certificate, and optionally a metadata file
Partner CoordinationContact at the supplier's IT/identity team who can configure claims on their IdP
Phase A — Validate Partner IdP Readiness
1
Confirm SAML 2.0 or WS-Fed Compatibility
Partner check
💡 Why is this step needed?
Entra ID External Identities only supports SAML 2.0 and WS-Federation protocols for custom identity provider federation. If the partner's IdP uses a different protocol (e.g. OAuth-only, LDAP, or proprietary), federation cannot be established through this method. Confirming protocol compatibility first avoids wasted effort on both sides.
#ActionNotes
1Ask the partner organisation to confirm their identity provider and which federation protocols it supportsSAML 2.0 or WS-Fed required
2Confirm the partner's IdP can provide a passive authentication endpointThis is the URL Entra will redirect users to for authentication
ℹ Common Compatible IdPs
Identity providers that typically support SAML 2.0 or WS-Fed include: ADFS, Okta, Ping Identity, Google Workspace, OneLogin, ForgeRock, and Shibboleth. Most enterprise IdPs support at least SAML 2.0.
2
Validate the Passive Authentication URL Against User UPNs
Domain check
💡 Why is this step needed?
Entra ID requires that the partner's passive authentication endpoint URL domain matches the domain portion of their users' UPNs (email addresses). This is a security measure — it ensures R&R's tenant is redirecting authentication to a URL that is verifiably controlled by the same organisation that owns the users' email domain. A mismatch will cause federation to fail.
#ActionNotes
1Obtain the partner's passive authentication endpoint URLe.g. https://idp.example.com/adfs/ls
2Identify the domain portion of their users' UPNse.g. users signing in as user@example.com
3Verify the endpoint URL falls within the same domain as the UPNsSee examples below
Domain Alignment Examples — users authenticating as user@version1.com
✓ Validhttps://version1.com — exact domain match
✓ Validhttps://sso.version1.com — subdomain of matching domain
✓ Validhttps://sso.version1.com/adfs/ls — subdomain with path
✗ Invalidhttps://version1.co.uk — different TLD, domain does not match version1.com
✗ Invalidhttps://otherprovider.com/version1 — entirely different domain
3
Configure a DNS TXT Record (If Domain Mismatch Exists)
Partner DNS
💡 Why is this step needed?
If the partner's passive authentication endpoint is hosted on a different domain to their users' UPNs (e.g. users are @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.
#ActionNotes
1If Step 2 identified a domain mismatch, request the partner adds a DNS TXT record to their UPN domainThe partner's DNS admin will need to do this
2The TXT record format is shown belowThis declares the authorised authentication URL
3Verify the TXT record has been published before proceedingUse nslookup -type=TXT domain.com to verify
# DNS TXT record format for cross-domain federation
# Added to the UPN domain's DNS zone (e.g. version1.com)

version1.com.  IN  TXT  "DirectFedAuthUrl=https://version1.co.uk"
⚠ Conditional Step
This step is only required when there is a domain mismatch between the user UPNs and the passive authentication endpoint. If the domains align (as validated in Step 2), skip this step and proceed to Phase B.
Phase B — Partner IdP Configuration
4
Provide the Partner with the R&R Onboarding Document
Coordination
💡 Why is this step needed?
For federation to work, the partner's IdP must be configured to issue SAML assertions or WS-Fed tokens containing the specific attributes and claims that R&R's Entra ID expects. The onboarding document (External IdAM – Onboarding Document (For Suppliers)) provides the partner's IT team with the exact technical requirements — including the claims schema, expected issuer URI format, and signing certificate requirements. Without this, the partner's IdP tokens will be rejected by Entra.
#ActionNotes
1Send the partner the "External IdAM – Onboarding Document (For Suppliers)"This document specifies the required claims and attributes
2Ask the partner to configure their IdP according to the documentTheir identity/SSO team will need to create a relying party trust or SAML application
3Request the partner provides their IdP metadata file (if available)An XML file containing their endpoint, issuer URI, and signing certificate — simplifies Step 6
ℹ Metadata File
If the partner can provide an IdP metadata XML file or a metadata URL, this dramatically simplifies the Entra configuration in Step 6 — Entra can parse all required values automatically rather than requiring manual input. Always request this upfront.
5
Collect Partner IdP Metadata & Signing Certificate
Coordination
💡 Why is this step needed?
Before configuring federation in Entra, you need the partner's technical IdP details. These are the cryptographic and endpoint values that allow R&R's Entra to verify that incoming authentication tokens are genuinely issued by the partner's IdP and have not been tampered with. Without these, Entra cannot establish a trust relationship.

Required information from the partner:

Issuer URI
The unique identifier the partner's IdP uses when issuing tokens — must match what they configure in their IdP
✦ Required
Passive Authentication Endpoint
The URL where Entra will redirect guest users to sign in at the partner's IdP
✦ Required
Signing Certificate
The X.509 public certificate Entra uses to verify the digital signature on tokens from the partner's IdP
✦ Required
Metadata URL
A URL to the partner's IdP metadata — allows Entra to automatically renew the signing certificate when it expires
◇ Optional but recommended
⚡ Shortcut — Metadata File
If the partner provides a metadata file (XML), all of the above values can be extracted automatically in Step 6 using the "Parse metadata file" option. You don't need to collect them individually.
Phase C — Configure Federation in R&R Entra
6
Sign In & Navigate to External Identity Providers
entra.microsoft.com
💡 Why is this step needed?
Custom federation partners are managed under Entra ID → External Identities → All Identity Providers. You must sign in with a PRV account elevated to External Identity Provider Administrator — this role specifically governs the ability to create and manage federation trusts with non-Microsoft identity providers.
#ActionNotes
1Navigate to Entra Admin Centreentra.microsoft.com
2Sign in with your PRV accountElevate to External Identity Provider Administrator via PIM
3Navigate to Entra ID → External Identities → All identity providers
7
Add New Custom SAML/WS-Fed Identity Provider
External Identities
💡 Why is this step needed?
This is the core configuration step — you are creating a federation trust between R&R's Entra ID tenant and the partner's identity provider. Once saved, Entra will recognise the partner's IdP as a trusted authentication source, meaning guest users from that organisation can accept B2B invites and authenticate with their home identity rather than needing a Microsoft account or one-time passcode. Every field links back to a cryptographic or routing requirement that ensures tokens are verified and users are directed to the correct authentication endpoint.
#ActionNotes
1Click the Custom tab
2Click Add new → select SAML/WS-Fed
3Enter Display nameA friendly name for the partner (e.g. "Version1 SSO")
4Select Identity provider protocolSAML or WS-Fed — as confirmed in Step 1
5Enter the Domain name of federating IdPThe domain that matches the partner's user UPNs

Configure metadata:

#ActionNotes
6Choose metadata population method"Parse metadata file" (if partner provided one) or "Input metadata manually"
7Enter or parse: Issuer URIUnique identifier for the partner's IdP
8Enter or parse: Passive authentication endpointURL where users are redirected to authenticate
9Upload or parse: Signing certificateX.509 certificate for token signature verification
10Enter Metadata URL (if available)Enables automatic certificate renewal — highly recommended
11Click Save
✔ What happens next?
The partner's IdP now appears in the Custom identity providers list. Users from the federated organisation can now accept B2B collaboration invites and authenticate with R&R's tenant using their home identity. No Microsoft account or one-time passcode is required.
ℹ Metadata URL Benefit
If you provided a Metadata URL, Entra will periodically check it for updated signing certificates. This means when the partner rotates their signing certificate, the federation trust is updated automatically — avoiding an outage that would otherwise require manual certificate replacement.
Phase D — Configure Redemption Order (Conditional)
8
Determine If Redemption Order Change Is Required
Conditional
💡 Why is this step needed?
When a partner organisation does not use Entra as their IdP but has an Entra-verified domain (e.g. they own the domain in an Entra tenant they don't actively use for authentication), a conflict arises. By default, Entra tries Entra-to-Entra federation first — which would fail because the partner doesn't actually authenticate users through their Entra tenant. The redemption order must be updated so that custom SAML/WS-Fed providers are evaluated before Entra trust, ensuring users are routed to the correct IdP.
⚠ Conditional Step
This is only required if Entra displayed a warning prompt when saving the custom IdP in Step 7, indicating that the partner's domain is already verified in an Entra tenant. If no warning appeared, the redemption order does not need to change — skip to Step 9.
9
Update Cross-Tenant Redemption Order
entra.microsoft.com
💡 Why is this step needed?
The redemption order defines the priority sequence Entra follows when determining how an invited guest user should authenticate. By moving SAML/WS-Fed Identity Providers higher in the order, you ensure custom federation is evaluated before Entra-to-Entra trust — correctly routing users to their actual IdP. This is a one-off, tenant-wide configuration that only needs to be done once, and it applies to all future B2B invitations.
#ActionNotes
1Sign in with a PRV account elevated to Security AdministratorDifferent role than Phase C — re-elevate if needed
2Navigate to Entra ID → External Identities → External collaboration settings
3Under Default settings, click Edit inbound defaults
4Under B2B collaboration, click Redemption order
5Tick SAML/WS-Fed Identity ProvidersIf not already ticked
6Click Move up to raise the priority above EntraCustom federation should be evaluated before Entra-to-Entra trust
7Click Save
🛑 Tenant-Wide Impact
This change affects all B2B collaboration invitations across the entire R&R tenant, not just the partner you are currently configuring. Once custom federation is prioritised, it will be checked first for all future guest invitations. This is normally the correct configuration, but verify with the Identity team if this is the first time the change is being made.
✔ Configuration Complete
The partner organisation is now fully configured as a B2B collaboration partner. Their users can accept invitations and sign in using their home identity provider. Authentication tokens are verified using the signing certificate and federation trust established in this guide. For future suppliers, Phases A and B still apply, but the redemption order in Phase D only needs to be configured once.
Additional Resources
Further Guidance & Reference Material

For advanced scenarios such as removing a federation trust, manually updating signing certificates, or troubleshooting token validation issues, refer to the official Microsoft documentation:

Microsoft Learn: Add a SAML/WS-Fed identity provider — Microsoft Entra External ID