Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
I tenant della forza lavoro
I tenant esterni (Altre informazioni)
Il tenant di Microsoft Entra può essere federato direttamente con organizzazioni esterne che usano un provider di identità SAML o WS-Fed. Gli utenti dell'organizzazione esterna possono quindi usare i propri account gestiti da IdP per accedere alle app o alle risorse, durante il riscatto dell'invito o l'iscrizione self-service, senza dover creare nuove credenziali di Microsoft Entra. L'utente viene reindirizzato al proprio IdP durante l'iscrizione o l'accesso all'app e quindi viene reindirizzato nuovamente a Microsoft Entra dopo l'accesso effettuato con successo.
Prerequisiti
- Rivedere le considerazioni sulla configurazione nei fornitori di identità SAML/WS-Fed.
- Un locatario della forza lavoro o un locatario esterno.
Nota
Il valore Issuer per IdP deve essere un URI valido dopo il formato RFC 3986 (ad esempio, https://testdev.example.com o http://www.example.com/exk10l6w90DHM0yi). I valori a parola singola o non URI (ad esempio, testdev) non sono supportati e vengono rifiutati dal portale.
Questo approccio è allineato ai modelli di identificatore sicuro di Microsoft Entra ID, come documentato in Restrizioni sugli URI degli identificatori. Per gli ID SAML, l'autorità emittente deve identificare in modo univoco il provider come URI, in base agli standard SAML 2.0 e alle regole di convalida di Microsoft Entra.
Come configurare la federazione SAML/WS-Fed IdP
Passaggio 1: Determinare se il partner deve aggiornare i record di testo DNS
Usare la procedura seguente per determinare se il partner deve aggiornare i record DNS per abilitare la federazione con l'utente.
Controllare l'URL di autenticazione passiva dell'IdP del partner per verificare se il dominio corrisponde al dominio di destinazione o a un host all'interno del dominio di destinazione. In altre parole, quando si configura la federazione per
fabrikam.com:- Se l'endpoint di autenticazione passiva è
https://fabrikam.comohttps://sts.fabrikam.com/adfs(un host nello stesso dominio), non sono necessarie modifiche DNS. - Se l'endpoint di autenticazione passiva è
https://fabrikamconglomerate.com/adfsohttps://fabrikam.co.uk/adfs, il dominio non corrisponde al dominio fabrikam.com, quindi il partner deve aggiungere un record di testo per l'URL di autenticazione alla configurazione DNS.
- Se l'endpoint di autenticazione passiva è
Se sono necessarie modifiche DNS in base al passaggio precedente, chiedere al partner di aggiungere un record TXT ai record DNS del dominio, come nell'esempio seguente:
fabrikam.com. IN TXT DirectFedAuthUrl=https://fabrikamconglomerate.com/adfs
Passaggio 2: Configurare l'IdP dell'organizzazione partner
Successivamente, l'organizzazione partner deve configurare il loro provider di identità con le attestazioni richieste e i trust della relying party. Per il corretto funzionamento della federazione, Microsoft Entra per ID esterno richiede che il provider di identità esterno invii determinati attributi e attestazioni, che devono essere configurati nel provider di identità esterno.
Nota
Per illustrare come configurare un provider di identità SAML/WS-Fed per la federazione, utilizziamo Active Directory Federation Services (AD FS) come esempio. Consulta l'articolo Configurare la federazione IdP SAML/WS-Fed con AD FS, che mostra esempi su come configurare AD FS come IdP SAML 2.0 o WS-Fed in preparazione per la federazione.
Per configurare un provider di identità SAML 2.0
Microsoft Entra per ID esterno richiede la risposta SAML 2.0 dal provider di identità esterno per includere attributi e attestazioni specifici. Gli attributi e le attestazioni necessari possono essere configurati nel provider di identità esterno in uno dei seguenti modi:
- Collegamento al file XML del servizio token di sicurezza online o
- Immissione manuale dei valori
Per i valori obbligatori, vedere le tabelle seguenti.
Nota
Assicurarsi che il valore corrisponda al cloud per cui si sta configurando la federazione esterna.
Tabella 1. Attributi obbligatori per la risposta SAML 2.0 dall'IdP.
| Attributo | Valore per un'entità della forza lavoro | Valore per un tenant esterno |
|---|---|---|
| AssertionConsumerService | https://login.microsoftonline.com/login.srf |
https://<tenantID>.ciamlogin.com/login.srf Aggiungere https://<tenantID>.ciamlogin.com/login.srf come URL di callback/ACS sul provider esterno, se richiesto dal provider. |
| Destinatari |
https://login.microsoftonline.com/<tenant ID>/ (Scelta consigliata) Sostituire <tenant ID> con l'ID tenant del tenant di Microsoft Entra con cui si sta configurando la federazione.Nella richiesta SAML inviata da Microsoft Entra ID per le federazioni esterne, l'URL dell'autorità di certificazione è un endpoint tenant (ad esempio, https://login.microsoftonline.com/<tenant ID>/). Per qualsiasi nuova federazione, consigliamo che tutti i partner impostino l'audience del provider di identità basato su SAML o WS-Fed su un endpoint tenant. Tutte le federazioni esistenti configurate con l'endpoint globale (ad esempio, urn:federation:MicrosoftOnline) continuano a funzionare, ma le nuove federazioni smettono di funzionare se il provider di identità esterno prevede un URL dell'autorità di certificazione globale nella richiesta SAML inviata da Microsoft Entra ID. |
https://login.microsoftonline.com/<tenant ID>/Sostituire <tenant ID> con l'ID tenant del tenant di Microsoft Entra con cui si sta configurando la federazione. |
| Emittente | URI dell'emittente dell'IdP del partner, ad esempio http://www.example.com/exk10l6w90DHM0yi... |
URI dell'emittente dell'IdP del partner, ad esempio http://www.example.com/exk10l6w90DHM0yi... |
Tabella 2. Attestazioni necessarie per il token SAML 2.0 rilasciato dall'IdP.
| Il nome dell'attributo | valore |
|---|---|
| Formato NameID | urn:oasis:names:tc:SAML:2.0:nameid-format:persistent |
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress |
L'indirizzo di posta elettronica dell'utente |
Per configurare un provider di identità WS-Fed
Microsoft Entra per ID esterno richiede che il messaggio di WS-Fed dall'IdP esterno includa attributi e richieste specifici. Gli attributi e le attestazioni necessari possono essere configurati nel provider di identità esterno in uno dei seguenti modi:
- Collegamento al file XML del servizio token di sicurezza online o
- Immissione manuale dei valori
Nota
Attualmente, i due provider di WS-Fed testati per la compatibilità con Microsoft Entra ID sono AD FS e Shibboleth.
Attributi e attestazioni WS-Fed necessari
Le tabelle seguenti illustrano i requisiti per attributi e asserzioni specifici che devono essere configurati nel provider di identità di terze parti WS-Fed. Per configurare la federazione, gli attributi seguenti devono essere ricevuti nel messaggio WS-Fed dal provider di identità. Questi attributi possono essere configurati tramite il collegamento al file XML del servizio token di sicurezza online o mediante immissione manuale.
Per i valori obbligatori, vedere le tabelle seguenti.
Nota
Assicurarsi che il valore corrisponda al cloud per cui si sta configurando la federazione esterna.
Tabella 3. Attributi obbligatori nel messaggio WS-Fed dall'IdP.
| Attributo | Valore per un'entità della forza lavoro | Valore per un tenant esterno |
|---|---|---|
| PuntoFinaleDiRichiestaPassiva | https://login.microsoftonline.com/login.srf |
https://<tenantID>.ciamlogin.com/login.srf |
| Destinatari |
https://login.microsoftonline.com/<tenant ID>/ (Scelta consigliata) Sostituire <tenant ID> con l'ID tenant del tenant di Microsoft Entra con cui si sta configurando la federazione.Nella richiesta SAML inviata da Microsoft Entra ID per le federazioni esterne, l'URL dell'autorità di certificazione è un endpoint tenant (ad esempio, https://login.microsoftonline.com/<tenant ID>/). Per qualsiasi nuova federazione, consigliamo che tutti i partner impostino l'audience del provider di identità basato su SAML o WS-Fed su un endpoint tenant. Tutte le federazioni esistenti configurate con l'endpoint globale (ad esempio, urn:federation:MicrosoftOnline) continuano a funzionare, ma le nuove federazioni smettono di funzionare se il provider di identità esterno prevede un URL dell'autorità di certificazione globale nella richiesta SAML inviata da Microsoft Entra ID. |
https://login.microsoftonline.com/<tenant ID>/ Sostituire <tenant ID> con l'ID tenant del tenant di Microsoft Entra con cui si sta configurando la federazione. |
| Emittente | URI dell'emittente dell'IdP del partner, ad esempio http://www.example.com/exk10l6w90DHM0yi... |
URI dell'emittente dell'IdP del partner, ad esempio http://www.example.com/exk10l6w90DHM0yi... |
Tabella 4. Attestazioni necessarie per il token WS-Fed rilasciato dall'Identity Provider.
| Attributo | valore |
|---|---|
| ImmutableID | http://schemas.microsoft.com/LiveID/Federation/2008/05/ImmutableID |
| indirizzo email | http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress |
Passaggio 3: Configurare la federazione SAML/WS-Fed IdP in Microsoft Entra per ID esterno
Dopo che il tuo partner ha configurato il provider di identità nel passaggio 2, configurare la federazione in Microsoft Entra per ID esterno. È possibile usare Interfaccia di amministrazione di Microsoft Entra, Microsoft Graph o Microsoft Graph PowerShell. Potrebbero essere necessari da 5 a 10 minuti prima che i criteri di federazione abbiano effetto. Durante questo periodo di tempo, non tentare di completare la registrazione self-service o riscattare un invito per il dominio federato. Gli attributi seguenti sono obbligatori:
- URI dell'emittente del provider di identità del partner.
- Endpoint di autenticazione passiva del provider di identità del partner. È supportato solo HTTPS.
- Parte pubblica del certificato di firma token del provider di identità.
Per aggiungere l'IdP (provider di identità) al tenant nell'interfaccia di amministrazione di Microsoft Entra
Accedi al centro di amministrazione di Microsoft Entra come almeno un amministratore del provider di identità esterno .
Se avete accesso a più tenant, usate l'icona Impostazioni
nel menu in alto per passare al vostro tenant nel menu Directorii.Passare a Microsoft Entra ID>Identità esterne>Tutti i provider di identità.
Selezionare la scheda Personalizzata e quindi selezionare Aggiungi nuovo>SAML/WS-Fed.
Nella sezione Nuovo provider di identità SAML/WS-Fed, immettere quanto segue:
- Nome visualizzato: inserisci un nome che ti aiuti a identificare il provider di identità del partner.
- Protocollo del provider di identità: selezionare SAML o WS-Fed.
- Domainless : per la federazione basata su dominio, lasciare deselezionata questa opzione. Per configurare un IdP SAML senza che corrisponda al dominio email dell'utente, vedere Configurare la federazione IdP SAML senza dominio.
- Nome di dominio del provider di identità federativo : immettere il nome di dominio di destinazione IdP del partner per la federazione. Durante questa configurazione iniziale immettere un solo nome di dominio. È possibile aggiungere altri domini in un secondo momento.
Selezionare un metodo per il popolamento dei metadati. Se si dispone di un file che contiene i metadati, è possibile popolare automaticamente i campi selezionando Analizza file di metadati e ricercando il file. In alternativa, è possibile selezionare Immetti metadati manualmente e immettere le informazioni seguenti:
- L'URI dell'emittente del provider di identità SAML del partner o l'ID dell'entità del provider di identità WS-Fed del partner.
- L’endpoint di autenticazione passiva dell'IdP SAML del partner o l’endpoint passivo del richiedente dell'IdP WS-Fed del partner.
- Certificato : immettere la parte pubblica con codifica Base64 del certificato usato per la firma dei token dell'IdP.
- URL dei metadati: percorso dei metadati del provider di identità per il rinnovo automatico del certificato di firma.
Nota
L'URL dei metadati è facoltativo. Tuttavia, lo consigliamo vivamente. Se si specifica l'URL dei metadati, Microsoft Entra ID può rinnovare automaticamente il certificato di firma alla scadenza. Se il certificato viene ruotato per qualsiasi motivo prima della scadenza o se non si specifica un URL di metadati, Microsoft Entra ID non è in grado di rinnovarlo. In questo caso, sarà necessario aggiornare manualmente il certificato di firma.
Seleziona Salva. Il provider di identità viene aggiunto all'elenco Provider di identità SAML/WS-Fed.
(Facoltativo) Per aggiungere altri nomi di dominio a questo provider di identità di federazione:
Per configurare la federazione tramite l'API di Microsoft Graph
Usare la risorsa samlOrWsFedExternalDomainFederation Microsoft Graph v1.0 per recuperare o creare configurazioni di federazione. Gli esempi in questa sezione usano SAML. Per configurare un provider di identità di WS-Fed, usare le impostazioni di WS-Fed del partner e impostare preferredAuthenticationProtocol su wsFed.
Per l'accesso delegato, accedere con un account che abbia almeno il ruolo di amministratore del provider di identità esterno. Il token di accesso deve disporre delle autorizzazioni necessarie per l'operazione:
| Operation | autorizzazione Microsoft Graph |
|---|---|
| Elencare o recuperare le configurazioni della federazione. | Domain.Read.All |
| Creare una configurazione di federazione. | IdentityProvider.ReadWrite.All |
| Eliminare una configurazione di federazione. |
Domain.ReadWrite.All oppure IdentityProvider.ReadWrite.All |
Sostituire {token} con un token di accesso per Microsoft Graph. Le risposte di esempio sono illustrative e abbreviate per la leggibilità. Gli ID e i valori di configurazione differiscono nel tuo tenant e il segnaposto del certificato non è un certificato utilizzabile.
Elencare le federazioni SAML/WS-Fed IdP
Usare la richiesta seguente per elencare le configurazioni di federazione SAML/WS-Fed nel tenant:
GET https://graph.microsoft.com/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation
Authorization: Bearer {token}
Una richiesta riuscita restituisce 200 OK e una raccolta in value:
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.samlOrWsFedExternalDomainFederation",
"id": "11111111-2222-3333-4444-555555555555",
"displayName": "Contoso SAML IdP",
"issuerUri": "https://idp.contoso.com/saml",
"passiveSignInUri": "https://idp.contoso.com/sso/saml",
"metadataExchangeUri": "https://idp.contoso.com/metadata",
"preferredAuthenticationProtocol": "saml",
"signingCertificate": "<Base64-encoded-signing-certificate>",
"domains": [
{
"id": "contoso.com"
}
]
}
]
}
Se la risposta include @odata.nextLink, inviare una richiesta a quell'URL per recuperare la pagina successiva. Continuare fino a quando non viene restituito alcun collegamento successivo. Per altre informazioni, vedere impaginazione dei dati di Microsoft Graph.
Trovare una federazione per dominio
Usare un domains/any filtro per trovare la configurazione della federazione per un dominio specifico. La seguente richiesta filtra per contoso.com.
GET https://graph.microsoft.com/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation?$filter=domains/any(x:x/id%20eq%20'contoso.com')
Authorization: Bearer {token}
La risposta è ancora una raccolta, anche quando una sola federazione corrisponde:
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.samlOrWsFedExternalDomainFederation",
"id": "11111111-2222-3333-4444-555555555555",
"displayName": "Contoso SAML IdP",
"issuerUri": "https://idp.contoso.com/saml",
"passiveSignInUri": "https://idp.contoso.com/sso/saml",
"metadataExchangeUri": "https://idp.contoso.com/metadata",
"preferredAuthenticationProtocol": "saml",
"signingCertificate": "<Base64-encoded-signing-certificate>",
"domains": [
{
"id": "contoso.com"
}
]
}
]
}
Se nessuna federazione corrisponde al dominio, value è un array vuoto.
Ottieni una federazione tramite ID
Per recuperare una configurazione federativa, usa il relativo id da una risposta di elenco o di filtro di dominio:
GET https://graph.microsoft.com/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation/11111111-2222-3333-4444-555555555555
Authorization: Bearer {token}
La risposta contiene un singolo oggetto federation anziché una raccolta value:
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.samlOrWsFedExternalDomainFederation",
"id": "11111111-2222-3333-4444-555555555555",
"displayName": "Contoso SAML IdP",
"issuerUri": "https://idp.contoso.com/saml",
"passiveSignInUri": "https://idp.contoso.com/sso/saml",
"metadataExchangeUri": "https://idp.contoso.com/metadata",
"preferredAuthenticationProtocol": "saml",
"signingCertificate": "<Base64-encoded-signing-certificate>",
"domains": [
{
"id": "contoso.com"
}
]
}
Creare un IdP SAML basato su dominio
Usare la richiesta seguente per creare una configurazione di federazione SAML per contoso.com:
POST https://graph.microsoft.com/v1.0/directory/federationConfigurations/microsoft.graph.samlOrWsFedExternalDomainFederation
Authorization: Bearer {token}
Content-Type: application/json
{
"@odata.type": "microsoft.graph.samlOrWsFedExternalDomainFederation",
"displayName": "Contoso SAML IdP",
"issuerUri": "https://idp.contoso.com/saml",
"passiveSignInUri": "https://idp.contoso.com/sso/saml",
"metadataExchangeUri": "https://idp.contoso.com/metadata",
"preferredAuthenticationProtocol": "saml",
"signingCertificate": "<Base64-encoded-signing-certificate>",
"domains": [
{
"@odata.type": "microsoft.graph.externalDomainName",
"id": "contoso.com"
}
]
}
Sostituire i valori di esempio con le impostazioni IdP del partner:
| Proprietà | Valore e scopo di esempio |
|---|---|
displayName |
Contoso SAML IdP, un nome che consente di identificare il provider. |
issuerUri |
https://idp.contoso.com/saml, l'URI dell'emittente che identifica il provider di identità del partner. |
passiveSignInUri |
https://idp.contoso.com/sso/saml, l'endpoint HTTPS per l'accesso basato su browser. |
metadataExchangeUri |
https://idp.contoso.com/metadata, l'URL dei metadati IdP. |
preferredAuthenticationProtocol |
saml per un SAML IdP. |
signingCertificate |
Parte pubblica con codifica Base64 del certificato di firma del token idP, non un ID certificato o una chiave privata. |
domains |
Domini esterni associati al provider di identità, ad esempio contoso.com. |
Una richiesta con esito positivo restituisce 201 Created e l'oggetto federation risultante. La risposta seguente mostra l'ID e il nome visualizzato:
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "11111111-2222-3333-4444-555555555555",
"displayName": "Contoso SAML IdP"
}
Per creare un IDP SAML che non corrisponde agli utenti per dominio di posta elettronica, vedere Creare un IdP SAML senza dominio con Microsoft Graph.
Configurare la federazione con Microsoft Graph PowerShell
Installare SDK PowerShell di Microsoft Graph. Questi esempi usano Invoke-MgGraphRequest dal Microsoft.Graph.Authentication modulo per chiamare gli stessi endpoint v1.0.
Usare un account con almeno il ruolo Di amministratore del provider di identità esterno. Sostituire l'ID tenant di esempio, il dominio, l'ID federazione, gli URL e il certificato con i propri valori.
Elencare le federazioni con PowerShell
Connettersi al tenant in cui si vuole configurare la federazione con Domain.Read.All. L'esempio seguente recupera tutte le pagine delle configurazioni di federazione SAML/WS-Fed:
Connect-MgGraph -TenantId "<tenant-id>" -Scopes "Domain.Read.All"
$uri = "https://graph.microsoft.com/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation"
do {
$result = Invoke-MgGraphRequest -Method GET -Uri $uri
$result.value | Format-List *
$uri = $result.'@odata.nextLink'
} while ($uri)
Trovare una federazione per dominio con PowerShell
Nell'esempio seguente si codifica URL il filtro e si recupera la configurazione associata a contoso.com:
Connect-MgGraph -TenantId "<tenant-id>" -Scopes "Domain.Read.All"
$domain = "contoso.com"
$filter = [Uri]::EscapeDataString("domains/any(x:x/id eq '$domain')")
$uri = "https://graph.microsoft.com/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation?`$filter=$filter"
$result = Invoke-MgGraphRequest -Method GET -Uri $uri
$result.value | Format-List *
Ottenere una federazione in base all'ID con PowerShell
Usare l'ID federazione da una risposta di elenco o di filtro del dominio:
Connect-MgGraph -TenantId "<tenant-id>" -Scopes "Domain.Read.All"
$federationId = "11111111-2222-3333-4444-555555555555"
$uri = "https://graph.microsoft.com/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation/$federationId"
$result = Invoke-MgGraphRequest -Method GET -Uri $uri
$result | Format-List *
Creare un IDP SAML basato su dominio con PowerShell
Connettersi con IdentityProvider.ReadWrite.All, preparare il corpo della richiesta e creare la configurazione della federazione:
Connect-MgGraph -TenantId "<tenant-id>" -Scopes "IdentityProvider.ReadWrite.All"
$body = @{
"@odata.type" = "microsoft.graph.samlOrWsFedExternalDomainFederation"
displayName = "Contoso SAML IdP"
issuerUri = "https://idp.contoso.com/saml"
passiveSignInUri = "https://idp.contoso.com/sso/saml"
metadataExchangeUri = "https://idp.contoso.com/metadata"
preferredAuthenticationProtocol = "saml"
signingCertificate = "<Base64-encoded-signing-certificate>"
domains = @(
@{
"@odata.type" = "microsoft.graph.externalDomainName"
id = "contoso.com"
}
)
} | ConvertTo-Json -Depth 10
$result = Invoke-MgGraphRequest `
-Method POST `
-Uri "https://graph.microsoft.com/v1.0/directory/federationConfigurations/microsoft.graph.samlOrWsFedExternalDomainFederation" `
-Body $body `
-ContentType "application/json"
$result | Format-List *
Per creare invece un IDP SAML senza dominio, vedere Creare un IdP SAML senza dominio con PowerShell.
Passaggio 4: Configurare l'ordine di riscossione (Collaborazione B2B nei tenant per la gestione della forza lavoro)
Se stai configurando la federazione nel tenant della forza lavoro per la collaborazione B2B con un dominio verificato, assicurati che l'IdP federato sia utilizzato per primo durante il riscatto dell'invito. Configura le impostazioni dell'ordine di riscatto nelle impostazioni di accesso tra tenant per la collaborazione B2B in ingresso. Spostare i provider di identità SAML/WS-Fed all'inizio dell'elenco Provider di identità primari per dare priorità alla riscossione con l'IdP federato.
È possibile testare la configurazione della federazione invitando un nuovo utente guest B2B. Per informazioni dettagliate, vedere Aggiungere utenti di Collaborazione B2B di Microsoft Entra nell’Interfaccia di amministrazione di Microsoft Entra.
Nota
È possibile configurare l'ordine di riscatto dell'invito usando l'API REST Microsoft Graph (versione beta). Vedere Esempio 2: Aggiornare la configurazione del riscatto dell'invito predefinito nella documentazione di riferimento di Microsoft Graph.
Federazione SAML IdP senza dominio
La federazione tradizionale in Microsoft Entra ID richiede di verificare un dominio personalizzato (ad esempio, contoso.com) e configurarlo per reindirizzare le richieste di autenticazione a un provider di identità SAML esterno. In questa configurazione, il dominio del claim e-mail fornito dall'IdP esterno dopo l'autenticazione viene convalidato rispetto al dominio associato all'IdP SAML configurato in Microsoft Entra ID.
Se il dominio di posta elettronica dell'utente è diverso dal dominio configurato nel provider di identità SAML (ad esempio, yahoo.com o gmail.com), gli utenti potrebbero riscontrare il seguente errore durante l'accesso:
AADSTS5000819: asserzione SAML non valida. Il claim dell'indirizzo e-mail è mancante o non corrisponde al dominio di un realm esterno.
Questo problema si verifica in genere quando:
- Il provider di identità SAML esterno non invia un claim e-mail oppure
- Il dominio dell'indirizzo e-mail fornito dall'IdP non corrisponde al dominio configurato nell'IdP esterno in Microsoft Entra ID
Anche quando è presente un'attestazione di posta elettronica, l'autenticazione potrebbe comunque non riuscire se il dominio di posta elettronica non è allineato al dominio IdP configurato a causa di requisiti di corrispondenza basati su dominio.
La federazione SAML senza dominio con un provider di identità SAML consente agli utenti esterni di eseguire l'autenticazione nelle app o nelle risorse della forza lavoro usando le credenziali gestite da IdP, indipendentemente dal dominio di posta elettronica. La federazione senza dominio rimuove la necessità di corrispondenza del dominio tra il messaggio di posta elettronica dell'utente e i domini IdP preconfigurato durante l'accesso o il riscatto dell'invito.
Configurare la federazione SAML IdP senza dominio
Per ovviare alla limitazione della corrispondenza del dominio, è possibile configurare l'IdP SAML come privo di dominio. Quando la federazione senza dominio è abilitata:
- Microsoft Entra ID indirizza le richieste di autenticazione all'IdP SAML configurato in base all'associazione dell'URI dell'emittente.
- Il dominio dell'indirizzo email dell'utente non viene confrontato con il dominio configurato per l'IdP.
Gli utenti possono quindi eseguire correttamente l'autenticazione usando indirizzi di posta elettronica da qualsiasi dominio (ad esempio, yahoo.com o gmail.com) durante l'accesso con il provider di identità SAML esterno.
Importante
È possibile configurare un solo IDP con caratteri jolly per ogni tenant. In Microsoft Graph un IdP SAML senza dominio include una domains raccolta contenente una singola voce la cui id proprietà è *. Non combinare il carattere jolly con nomi di dominio specifici.
Creare un nuovo IdP SAML senza dominio nel Interfaccia di amministrazione di Microsoft Entra
Per creare un nuovo IdP SAML senza dominio:
Accedi al centro di amministrazione di Microsoft Entra come almeno un amministratore del provider di identità esterno .
Passare a Microsoft Entra ID>Identità esterne>Tutti i provider di identità.
Selezionare la scheda Personalizzata e quindi selezionare Aggiungi nuovo>SAML/WS-Fed.
Nella pagina Nuovo IdP SAML/WS-Fed immettere un nome visualizzato, ad esempio
Contoso SAML IdP, selezionare SAML per Protocollo provider di identità e selezionare Domainless. Non è necessario immettere un dominio federativo specifico.Analizzare un file di metadati o immettere manualmente l'URI dell'autorità emittente, l'endpoint di autenticazione passiva, il certificato di firma e l'URL dei metadati, come descritto in Per aggiungere il provider di identità al tenant nel Interfaccia di amministrazione di Microsoft Entra.
Seleziona Salva.
Creare un IdP SAML senza dominio con Microsoft Graph
Usare lo stesso endpoint di creazione e IdentityProvider.ReadWrite.All autorizzazione per un IdP SAML basato su dominio. Impostare il id della voce di dominio su *:
POST https://graph.microsoft.com/v1.0/directory/federationConfigurations/microsoft.graph.samlOrWsFedExternalDomainFederation
Authorization: Bearer {token}
Content-Type: application/json
{
"@odata.type": "microsoft.graph.samlOrWsFedExternalDomainFederation",
"displayName": "Contoso SAML IdP",
"issuerUri": "https://idp.contoso.com/saml",
"passiveSignInUri": "https://idp.contoso.com/sso/saml",
"metadataExchangeUri": "https://idp.contoso.com/metadata",
"preferredAuthenticationProtocol": "saml",
"signingCertificate": "<Base64-encoded-signing-certificate>",
"domains": [
{
"@odata.type": "microsoft.graph.externalDomainName",
"id": "*"
}
]
}
Una richiesta con esito positivo restituisce 201 Created e il nuovo oggetto federativo. La risposta seguente è abbreviata:
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "66666666-7777-8888-9999-000000000000",
"displayName": "Contoso SAML IdP"
}
Recupera la configurazione in base all'ID restituito e conferma che domains contiene la voce con caratteri jolly.
Crea un IdP SAML senza dominio con PowerShell
Usare il modulo Microsoft.Graph.Authentication e un account con almeno il ruolo Amministratore provider di identità esterno, come descritto in Configurare la federazione con Microsoft Graph PowerShell. Nell'esempio seguente viene creato direttamente un IdP SAML senza dominio. Non eseguire né questo esempio né l'esempio di creazione basata sul dominio per lo stesso provider.
Connect-MgGraph -TenantId "<tenant-id>" -Scopes "IdentityProvider.ReadWrite.All"
$body = @{
"@odata.type" = "microsoft.graph.samlOrWsFedExternalDomainFederation"
displayName = "Contoso SAML IdP"
issuerUri = "https://idp.contoso.com/saml"
passiveSignInUri = "https://idp.contoso.com/sso/saml"
metadataExchangeUri = "https://idp.contoso.com/metadata"
preferredAuthenticationProtocol = "saml"
signingCertificate = "<Base64-encoded-signing-certificate>"
domains = @(
@{
"@odata.type" = "microsoft.graph.externalDomainName"
id = "*"
}
)
} | ConvertTo-Json -Depth 10
$result = Invoke-MgGraphRequest `
-Method POST `
-Uri "https://graph.microsoft.com/v1.0/directory/federationConfigurations/microsoft.graph.samlOrWsFedExternalDomainFederation" `
-Body $body `
-ContentType "application/json"
$result | Format-List *
Aggiornare la federazione SAML basata su dominio alla federazione senza dominio
È possibile modificare un IdP SAML basato su dominio in domainless usando il Interfaccia di amministrazione di Microsoft Entra, Microsoft Graph o Microsoft Graph PowerShell. Dopo qualsiasi conversione, aggiornare i flussi utente associati.
Importante
Se un guest esistente non riesce ad accedere dopo la modifica o se l'URI dell'emittente IdP è cambiato, reimpostare lo stato di riscatto.
Convertire un IdP SAML esistente nel Interfaccia di amministrazione di Microsoft Entra
Per modificare un IDP SAML basato su dominio in domainless nell'interfaccia di amministrazione:
Accedi al centro di amministrazione di Microsoft Entra come almeno un amministratore del provider di identità esterno .
Passare a Microsoft Entra ID>Identità esterne>Tutti i provider di identità.
In Tutti i provider di identità selezionare la scheda Personalizzata e individuare il provider di identità SAML.
Selezionare il collegamento nella colonna Domini per aprire il riquadro dei dettagli del dominio.
Selezionare Domainless e quindi Fatto.
Converti un IdP SAML basato su dominio con Microsoft Graph
Per convertire un IDP SAML basato su dominio in uno senza dominio con Microsoft Graph, recuperare e salvare le impostazioni, eliminare la configurazione esistente e creare una sostituzione con il dominio con caratteri jolly.
Importante
L'eliminazione di una configurazione federativa può impedire agli utenti guest federati esistenti di accedere. Pianificare e testare la modifica prima di usarla nell'ambiente di produzione e salvare le impostazioni esistenti prima dell'eliminazione in modo da poter ricreare la configurazione originale, se necessario. Il provider di identità sostitutivo ha un nuovo ID. Registra le associazioni dei flussi utente prima dell'eliminazione. In un tenant esterno aggiungere il provider di identità sostitutivo al flusso utente appropriato.
Usare Domain.Read.All per recuperare la configurazione e IdentityProvider.ReadWrite.All per creare la sostituzione. Quest'ultima autorizzazione consente anche l'eliminazione. Per l'accesso delegato, l'amministratore deve avere almeno il ruolo External Identity Provider Administrator.
Ottenere l'IDP SAML esistente in base al relativo ID:
GET https://graph.microsoft.com/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation/11111111-2222-3333-4444-555555555555 Authorization: Bearer {token}Salvare la risposta e verificare che descriva l'IDP SAML che si intende sostituire. La risposta seguente mostra un IdP associato a
contoso.com:HTTP/1.1 200 OK Content-Type: application/json { "@odata.type": "#microsoft.graph.samlOrWsFedExternalDomainFederation", "id": "11111111-2222-3333-4444-555555555555", "displayName": "Contoso SAML IdP", "issuerUri": "https://idp.contoso.com/saml", "passiveSignInUri": "https://idp.contoso.com/sso/saml", "metadataExchangeUri": "https://idp.contoso.com/metadata", "preferredAuthenticationProtocol": "saml", "signingCertificate": "<Base64-encoded-signing-certificate>", "domains": [ { "id": "contoso.com" } ] }Preparare la richiesta di sostituzione prima di eliminare il provider di identità esistente. Mantenere i valori di configurazione dell'IdP, rimuovere le annotazioni OData
iddi sola lettura e qualsiasi annotazione OData di sola risposta e sostituire la raccoltadomainscon una singola voce la cui proprietàidè*. Verifica che il tenant non abbia già un altro IdP wildcard.Eliminare la configurazione della federazione esistente. Includi il relativo ID nell'URL della richiesta; non inviare DELETE all'URL della raccolta.
DELETE https://graph.microsoft.com/v1.0/directory/federationConfigurations/11111111-2222-3333-4444-555555555555 Authorization: Bearer {token}Un'eliminazione riuscita restituisce:
HTTP/1.1 204 No ContentCreare il provider di identità sostitutivo con le impostazioni salvate e il dominio con caratteri jolly:
POST https://graph.microsoft.com/v1.0/directory/federationConfigurations/microsoft.graph.samlOrWsFedExternalDomainFederation Authorization: Bearer {token} Content-Type: application/json { "@odata.type": "microsoft.graph.samlOrWsFedExternalDomainFederation", "displayName": "Contoso SAML IdP", "issuerUri": "https://idp.contoso.com/saml", "passiveSignInUri": "https://idp.contoso.com/sso/saml", "metadataExchangeUri": "https://idp.contoso.com/metadata", "preferredAuthenticationProtocol": "saml", "signingCertificate": "<Base64-encoded-signing-certificate>", "domains": [ { "@odata.type": "microsoft.graph.externalDomainName", "id": "*" } ] }Una richiesta con esito positivo restituisce
201 Createde l'oggetto federation sostitutivo. La risposta seguente è abbreviata:HTTP/1.1 201 Created Content-Type: application/json { "id": "66666666-7777-8888-9999-000000000000", "displayName": "Contoso SAML IdP" }Recuperare la sostituzione con il nuovo ID e verificare che
domainscontenga*. Ripristinare le associazioni dei flussi utente e testare l'accesso con l'URI dell'emittente configurato, come descritto in Flusso utente per la federazione SAML IdP senza dominio.
Convertire un IDP SAML basato su dominio con PowerShell
Usare il Microsoft.Graph.Authentication modulo e un account con almeno il ruolo Amministratore provider di identità esterno. Questa procedura elimina e ricrea la configurazione della federazione. Esaminare le linee guida per la conversione Microsoft Graph, inclusi l'impatto sull'eliminazione e l'ID di sostituzione, prima di eseguirlo.
Connettersi al tenant di destinazione con autorizzazioni di lettura e scrittura, recuperare l'IdP SAML esistente e salvare la configurazione. Sostituire l'ID tenant di esempio e l'ID federazione con i propri valori.
Connect-MgGraph -TenantId "<tenant-id>" -Scopes "Domain.Read.All", "IdentityProvider.ReadWrite.All" $federationId = "11111111-2222-3333-4444-555555555555" $readUri = "https://graph.microsoft.com/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation/$federationId" $federation = Invoke-MgGraphRequest -Method GET -Uri $readUri -ErrorAction Stop if ($federation.preferredAuthenticationProtocol -ne "saml") { throw "Select a SAML federation configuration." } $federation | ConvertTo-Json -Depth 10 | Set-Content -Path ".\contoso-saml-idp-backup.json" -Encoding utf8 -ErrorAction StopPreparare la sostituzione con le impostazioni IdP salvate e un dominio con caratteri jolly. Non includere l'ID federazione esistente nella richiesta di creazione. Esaminare il backup e il corpo della richiesta prima di continuare e verificare che il tenant non abbia già un altro IDP con caratteri jolly.
$body = @{ "@odata.type" = "microsoft.graph.samlOrWsFedExternalDomainFederation" displayName = $federation.displayName issuerUri = $federation.issuerUri passiveSignInUri = $federation.passiveSignInUri metadataExchangeUri = $federation.metadataExchangeUri preferredAuthenticationProtocol = $federation.preferredAuthenticationProtocol signingCertificate = $federation.signingCertificate domains = @( @{ "@odata.type" = "microsoft.graph.externalDomainName" id = "*" } ) } | ConvertTo-Json -Depth 10 $bodyEliminare la configurazione esistente e quindi creare la configurazione sostitutiva. Questi comandi interrompono la federazione fino a quando non viene creato l'elemento sostitutivo. Se la creazione non riesce dopo l'eliminazione, usare le impostazioni salvate per ricreare la configurazione originale basata su dominio.
$deleteUri = "https://graph.microsoft.com/v1.0/directory/federationConfigurations/$federationId" Invoke-MgGraphRequest -Method DELETE -Uri $deleteUri -ErrorAction Stop $result = Invoke-MgGraphRequest ` -Method POST ` -Uri "https://graph.microsoft.com/v1.0/directory/federationConfigurations/microsoft.graph.samlOrWsFedExternalDomainFederation" ` -Body $body ` -ContentType "application/json" ` -ErrorAction Stop $result | Format-List *Recuperare la sostituzione in base al nuovo ID e verificare che la voce di dominio sia
*:$newFederationId = $result.id $uri = "https://graph.microsoft.com/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation/$newFederationId" Invoke-MgGraphRequest -Method GET -Uri $uri -ErrorAction Stop | Format-List *
Flusso utente per la federazione SAML IdP senza dominio
Dopo aver configurato la federazione senza dominio, è possibile invitare gli utenti guest dell'organizzazione partner seguendo questa procedura:
- Nel Interfaccia di amministrazione di Microsoft Entra passare a Identity>Users>Tutti gli utenti.
- Selezionare + Nuovo utente e scegliere Invita utente esterno.
- Immettere l'indirizzo di posta elettronica dell'utente guest. Il dominio di posta elettronica non deve corrispondere a un dominio verificato nel tenant.
- Nell'URL di reindirizzamento dell'invito, includi un parametro domain_hint per garantire che l'utente venga indirizzato all'IdP appropriato in base all'URI dell'emittente configurato. Il valore domain_hint deve corrispondere all'URI dell'autorità di certificazione definita nella configurazione SAML IdP.
- Completare e inviare l'invito.
- Quando l'utente invitato riscatta l'invito, Microsoft Entra ID instrada la richiesta di autenticazione all'IdP SAML configurato utilizzando l'URI emittente nel parametro
domain_hint. - L'utente esegue l'autenticazione con l'IdP SAML esterno. Il dominio dell'indirizzo email dell'utente non viene verificato rispetto al dominio configurato per l'IdP e l'utente può accedere al tenant di risorsa.
- Per gli accessi successivi, l'utente può accedere direttamente all'applicazione del tenant di risorsa autenticandosi con l'IdP SAML esterno, perché l'oggetto utente viene aggiornato con l'associazione con l'IdP esterno.
Problemi noti
Quando si configura la federazione IDP SAML senza dominio, considerare i problemi noti seguenti:
- La configurazione IdP viene eliminata se viene immesso un nome di dominio non valido anche quando la configurazione IdP non viene salvata.
- Ogni volta che si converte un IdP SAML da basato su dominio a senza dominio, aggiornare i flussi utente associati. Se si elimina e si ricrea l'IdP, aggiungere prima di tutto il provider di identità sostitutivo a ogni flusso utente. Disabilitare quindi l'IdP nel flusso utente, salvare, riabilitare l'IdP e salvare di nuovo. Per la procedura di aggiornamento del flusso utente, vedere Limitazioni note.
Come aggiornare i dettagli del certificato o della configurazione
Nella pagina Tutti i provider di identità è possibile visualizzare l'elenco dei provider di identità SAML/WS-Fed configurati e le relative date di scadenza del certificato. Da questo elenco è possibile rinnovare i certificati e modificare altri dettagli della configurazione.
Accedi al centro di amministrazione di Microsoft Entra come almeno un amministratore del provider di identità esterno .
Passare a Microsoft Entra ID>Identità esterne>Tutti i provider di identità.
Selezionare la scheda Personalizzato.
Scorrere verso un provider di identità nell'elenco o usare la casella di ricerca.
Per aggiornare il certificato o modificare i dettagli della configurazione:
- Nella colonna Configurazione corrispondente al provider di identità selezionare il collegamento Modifica.
- Nella pagina di configurazione modificare uno dei dettagli seguenti:
- Nome visualizzato: nome visualizzato dell'organizzazione del partner.
- Protocollo del provider di identità: selezionare SAML o WS-Fed.
- Endpoint di autenticazione passiva: endpoint per richieste passive del provider di identità del partner.
- Certificato - La parte pubblica con codifica Base64 del certificato usato dall'IdP per la firma dei token. Per rinnovarlo, immettere il nuovo certificato di firma.
- URL dei metadati: URL contenente i metadati del partner, usato per il rinnovo automatico del certificato di firma.
- Seleziona Salva.
Per modificare i domini associati al partner, selezionare il collegamento nella colonna Domini. Nel riquadro dei dettagli del dominio:
- Per aggiungere un dominio, digitare il nome di dominio accanto a Nome di dominio del provider di identità di federazione e quindi selezionare Aggiungi. Ripetere questa procedura per ogni dominio che si desidera aggiungere.
- Per eliminare un dominio, selezionare l'icona di eliminazione accanto al dominio.
- Al termine selezionare Fine.
Per passare alla federazione senza dominio, seguire Convertire un provider di identità SAML esistente nel centro di amministrazione di Microsoft Entra.
Nota
Per rimuovere la federazione con un partner, eliminare prima tutti i domini tranne uno e quindi seguire la procedura descritta in Come rimuovere la federazione.
Come rimuovere la federazione
È possibile rimuovere la configurazione della federazione. In tal caso, gli utenti federati esterni che hanno già riscattato gli inviti non potranno più accedere. Tuttavia, è possibile concedere loro di nuovo l'accesso alle risorse reimpostando lo stato di riscatto. Per rimuovere una configurazione di un provider di identità nell'Interfaccia di amministrazione di Microsoft Entra:
Accedi al centro di amministrazione di Microsoft Entra come almeno un amministratore del provider di identità esterno .
Passare a Microsoft Entra ID>Identità esterne>Tutti i provider di identità.
Selezionare la scheda Personalizzata, successivamente scorrere fino al fornitore di identità nell'elenco o usare la casella di ricerca.
Selezionare il collegamento nella colonna Domini per visualizzare i dettagli del dominio dell'IdP.
Eliminare tutti i domini meno un nell'elenco Nome di dominio.
Selezionare Elimina configurazione e quindi Operazione completata.
Scegliere OK per confermare l'eliminazione.
È anche possibile rimuovere la federazione usando il tipo di risorsa samlOrWsFedExternalDomainFederation dell'API di Microsoft Graph.
Passaggi successivi
- Tenant esterni:Aggiungere il provider di identità SAML/WS-Fed a un flusso utente.
- Tenant della forza lavoro: Altre informazioni sull'esperienza di riscatto dell'invito quando gli utenti esterni accedono con diversi provider di identità.