Aggiungere la federazione con i provider di identità SAML/WS-Fed

Si applica a: Cerchio verde con un simbolo di spunta bianco che indica che il contenuto seguente si applica ai tenant della forza lavoro. I tenant della forza lavoro Cerchio verde con un simbolo di spunta bianco che indica che il contenuto seguente si applica ai tenant esterni. 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.

  1. 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.com o https://sts.fabrikam.com/adfs (un host nello stesso dominio), non sono necessarie modifiche DNS.
    • Se l'endpoint di autenticazione passiva è https://fabrikamconglomerate.com/adfs o https://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.
  2. 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

  1. Accedi al centro di amministrazione di Microsoft Entra come almeno un amministratore del provider di identità esterno .

  2. Se avete accesso a più tenant, usate l'icona Impostazioni nel menu in alto per passare al vostro tenant nel menu Directorii.

  3. Passare a Microsoft Entra ID>Identità esterne>Tutti i provider di identità.

  4. Selezionare la scheda Personalizzata e quindi selezionare Aggiungi nuovo>SAML/WS-Fed.

    Schermata che mostra il pulsante per aggiungere un nuovo IdP SAML o WS-Fed.

  5. 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.

    Screenshot che mostra la nuova pagina del provider di identità SAML o WS-Fed.

  6. 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.

    Screenshot che mostra i campi dei metadati.

    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.

  7. Seleziona Salva. Il provider di identità viene aggiunto all'elenco Provider di identità SAML/WS-Fed.

    Screenshot che mostra l'elenco dei fornitori di identità SAML/WS-Fed con la nuova voce.

  8. (Facoltativo) Per aggiungere altri nomi di dominio a questo provider di identità di federazione:

    1. Selezionare il collegamento nella colonna Domini.

      Screenshot che mostra il collegamento per l'aggiunta di domini al provider di identità SAML/WS-Fed.

    2. Accanto a Nome di dominio del provider di identità di federazione digitare il nome di dominio e quindi selezionare Aggiungi. Ripetere questa procedura per ogni dominio che si desidera aggiungere. Al termine selezionare Fine.

      Screenshot che mostra il pulsante Aggiungi nel riquadro dei dettagli del dominio.

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:

  1. Accedi al centro di amministrazione di Microsoft Entra come almeno un amministratore del provider di identità esterno .

  2. Passare a Microsoft Entra ID>Identità esterne>Tutti i provider di identità.

  3. Selezionare la scheda Personalizzata e quindi selezionare Aggiungi nuovo>SAML/WS-Fed.

  4. 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.

    Screenshot che mostra la nuova pagina del provider di identità SAML/WS-Fed con l'opzione Domainless selezionata.

  5. 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.

  6. 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:

  1. Accedi al centro di amministrazione di Microsoft Entra come almeno un amministratore del provider di identità esterno .

  2. Passare a Microsoft Entra ID>Identità esterne>Tutti i provider di identità.

  3. In Tutti i provider di identità selezionare la scheda Personalizzata e individuare il provider di identità SAML.

  4. Selezionare il collegamento nella colonna Domini per aprire il riquadro dei dettagli del dominio.

  5. Selezionare Domainless e quindi Fatto.

    Screenshot del riquadro dei dettagli del dominio con l'opzione Domainless.

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.

  1. 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}
    
  2. 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"
        }
      ]
    }
    
  3. Preparare la richiesta di sostituzione prima di eliminare il provider di identità esistente. Mantenere i valori di configurazione dell'IdP, rimuovere le annotazioni OData id di sola lettura e qualsiasi annotazione OData di sola risposta e sostituire la raccolta domains con una singola voce la cui proprietà id è *. Verifica che il tenant non abbia già un altro IdP wildcard.

  4. 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 Content
    
  5. Creare 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 Created e 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"
    }
    
  6. Recuperare la sostituzione con il nuovo ID e verificare che domains contenga *. 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.

  1. 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 Stop
    
  2. Preparare 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
    
    $body
    
  3. Eliminare 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 *
    
  4. 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 *
    
  5. Aggiornare i flussi utente associati e testare l'accesso.

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:

  1. Nel Interfaccia di amministrazione di Microsoft Entra passare a Identity>Users>Tutti gli utenti.
  2. Selezionare + Nuovo utente e scegliere Invita utente esterno.
  3. Immettere l'indirizzo di posta elettronica dell'utente guest. Il dominio di posta elettronica non deve corrispondere a un dominio verificato nel tenant.
  4. 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.
  5. Completare e inviare l'invito.
  6. 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.
  7. 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.
  8. 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.

  1. Accedi al centro di amministrazione di Microsoft Entra come almeno un amministratore del provider di identità esterno .

  2. Passare a Microsoft Entra ID>Identità esterne>Tutti i provider di identità.

  3. Selezionare la scheda Personalizzato.

  4. Scorrere verso un provider di identità nell'elenco o usare la casella di ricerca.

  5. 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.

    Screenshot dei dettagli della configurazione IDP.

  6. 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.

    Screenshot della pagina di configurazione del dominio.

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:

  1. Accedi al centro di amministrazione di Microsoft Entra come almeno un amministratore del provider di identità esterno .

  2. Passare a Microsoft Entra ID>Identità esterne>Tutti i provider di identità.

  3. Selezionare la scheda Personalizzata, successivamente scorrere fino al fornitore di identità nell'elenco o usare la casella di ricerca.

  4. Selezionare il collegamento nella colonna Domini per visualizzare i dettagli del dominio dell'IdP.

  5. Eliminare tutti i domini meno un nell'elenco Nome di dominio.

  6. Selezionare Elimina configurazione e quindi Operazione completata.

    Screenshot che mostra l’eliminazione di una configurazione.

  7. Scegliere OK per confermare l'eliminazione.

È anche possibile rimuovere la federazione usando il tipo di risorsa samlOrWsFedExternalDomainFederation dell'API di Microsoft Graph.

Passaggi successivi