Hinzufügen eines Partnerverbunds mit SAML/WS-Fed Identitätsanbietern

Gilt für: Grüner Kreis mit einem weißen Häkchensymbol, das angibt, dass der folgende Inhalt für Mitarbeitermandanten gilt. Mitarbeitermandanten grüner Kreis mit einem weißen Häkchensymbol, das angibt, dass der folgende Inhalt für externe Mandanten gilt. Externe Mandanten (weitere Informationen)

Ihr Microsoft Entra-Mandant kann direkt mit externen Organisationen verbunden werden, die einen SAML- oder WS-Verbund-Identitätsanbieter (IDP) verwenden. Benutzer aus der externen Organisation können dann ihre eigenen idP-verwalteten Konten verwenden, um sich bei Ihren Apps oder Ressourcen anzumelden, entweder während der Einladungseinlösung oder der Self-Service-Registrierung, ohne neue Microsoft Entra-Anmeldeinformationen erstellen zu müssen. Der Benutzer wird beim Registrieren oder Anmelden bei Ihrer App zu ihrem IdP umgeleitet und nach der erfolgreichen Anmeldung an Microsoft Entra zurückgegeben.

Voraussetzungen

Hinweis

Der Ausstellerwert für den IdP muss ein gültiger URI sein, der dem RFC 3986-Format folgt (zum Beispiel https://testdev.example.com oder http://www.example.com/exk10l6w90DHM0yi). Einzelwort- oder Nicht-URI-Werte (z. B. testdev) werden nicht unterstützt und vom Portal abgelehnt. Dies entspricht den Sicheren Bezeichnermustern der Microsoft Entra-ID, wie in Einschränkungen für Bezeichner-URIs dokumentiert. Für SAML-IdPs muss der Aussteller den Anbieter eindeutig als URI, gemäß SAML 2.0-Standards und Microsoft Entra-Validierungsregeln identifizieren.

So konfigurieren Sie den SAML/WS-Fed IdP-Verbund

Schritt 1: Ermitteln, ob der Partner seine DNS-Textdatensätze aktualisieren muss

Führen Sie die folgenden Schritte aus, um zu ermitteln, ob der Partner seine DNS-Einträge aktualisieren muss, um den Partnerverbund mit Ihnen zu aktivieren.

  1. Überprüfen Sie die passive IdP-Authentifizierungs-URL des Partners, um festzustellen, ob die Domäne mit der Zieldomäne oder einem Host innerhalb der Zieldomäne übereinstimmt. Anders ausgedrückt: Beim Einrichten eines Verbunds für fabrikam.com gilt Folgendes:

    • Wenn der passive Authentifizierungsendpunkt https://fabrikam.com oder https://sts.fabrikam.com/adfs (ein Host in derselben Domäne) lautet, sind keine DNS-Änderungen erforderlich.
    • Wenn der passive Authentifizierungsendpunkt https://fabrikamconglomerate.com/adfs oder https://fabrikam.co.uk/adfs lautet, stimmt die Domäne nicht mit der fabrikam.com-Domäne überein. Der Partner muss seiner DNS-Konfiguration daher einen Texteintrag für die Authentifizierungs-URL hinzufügen.
  2. Wenn gemäß dem vorherigen Schritt DNS-Änderungen erforderlich sind, bitten Sie den Partner, den DNS-Einträgen seiner Domäne einen TXT-Eintrag hinzuzufügen, wie im folgenden Beispiel gezeigt:

    fabrikam.com.  IN   TXT   DirectFedAuthUrl=https://fabrikamconglomerate.com/adfs

Schritt 2: Konfigurieren des IdPs des Partnerunternehmens

Als Nächstes muss Ihr Partnerunternehmen ihren IdP mit den erforderlichen Ansprüchen und Vertrauensstellungen der vertrauenden Seite konfigurieren. Damit eine Föderation ordnungsgemäß funktioniert, erfordert Microsoft Entra External ID, dass der externe IdP bestimmte Attribute und Ansprüche sendet, die am externen IdP konfiguriert werden müssen.

Hinweis

Um zu veranschaulichen, wie ein SAML/WS-Fed IdP für den Partnerverbund konfiguriert wird, verwenden wir Active Directory-Verbunddienste (AD FS) als Beispiel. Lesen Sie den Artikel Konfigurieren von SAML/WS-Fed IdP-Partnerverbund mit AD FS, der Beispiele zum Konfigurieren von AD FS als SAML 2.0 oder WS-Fed IdP in Vorbereitung auf den Partnerverbund enthält.

So konfigurieren Sie einen SAML 2.0-Identitätsanbieter

Microsoft Entra External ID erfordert, dass die SAML 2.0-Antwort des externen IdP bestimmte Attribute und Claims enthält. Die erforderlichen Attribute und Ansprüche können im externen IdP entweder konfiguriert werden:

  • Verknüpfung mit der XML-Datei des Online-Sicherheitstokens-Dienstes oder
  • Manuelles Eingeben der Werte

In den folgenden Tabellen finden Sie die erforderlichen Werte.

Hinweis

Stellen Sie sicher, dass der Wert mit der Cloud übereinstimmt, für die Sie einen externen Verbund einrichten.

Tabelle 1: Erforderliche Attribute für die SAML 2.0-Antwort vom IdP.

Attribut Wert für einen Mitarbeitermandanten Wert für einen externen Mandanten
AssertionConsumerService https://login.microsoftonline.com/login.srf https://<tenantID>.ciamlogin.com/login.srf Fügen Sie https://<tenantID>.ciamlogin.com/login.srf als Rückruf-/ACS-URL beim externen IdP hinzu, falls von diesem Anbieter erforderlich.
Zielgruppe https://login.microsoftonline.com/<tenant ID>/ (Empfohlen) Ersetzen Sie <tenant ID> durch die Mandanten-ID des Microsoft Entra-Mandanten, mit dem Sie einen Verbund einrichten.

In der SAML-Anforderung, die von Microsoft Entra ID für externe Verbunde gesendet wird, ist die Aussteller-URL ein Mandantenendpunkt (zum Beispiel https://login.microsoftonline.com/<tenant ID>/). Für alle neuen Verbunde wird empfohlen, dass alle unsere Partner die Zielgruppe des SAML- oder WS-Fed-basierten IdP auf einen mandantenbasierten Endpunkt festlegen. Alle vorhandenen Partnerverbunde, die mit dem globalen Endpunkt konfiguriert sind (z. B. urn:federation:MicrosoftOnline), funktionieren weiterhin, aber neue Partnerverbunde funktionieren nicht mehr, wenn Ihr externer IdP eine globale Aussteller-URL in der SAML-Anforderung erwartet, die von Microsoft Entra ID gesendet wird.
https://login.microsoftonline.com/<tenant ID>/
Ersetzen Sie <tenant ID> durch die Mandanten-ID des Microsoft Entra-Mandanten, mit dem Sie eine Föderation einrichten.
Issuer Der Aussteller-URI des Partneridentitätsanbieters, z. B. http://www.example.com/exk10l6w90DHM0yi... Der Aussteller-URI des Partneridentitätsanbieters, z. B. http://www.example.com/exk10l6w90DHM0yi...

Tabelle 2: Erforderliche Ansprüche für das VOM IDP ausgestellte SAML 2.0-Token.

Attributname value
NameID-Format urn:oasis:names:tc:SAML:2.0:nameid-format:persistent
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress Die E-Mail-Adresse des Benutzers

So konfigurieren Sie einen WS-Fed Identitätsanbieter

Microsoft Entra External ID erfordert, dass die WS-Fed-Nachricht des externen IdP bestimmte Attribute und Ansprüche enthält. Die erforderlichen Attribute und Ansprüche können im externen IdP entweder konfiguriert werden:

  • Verknüpfung mit der XML-Datei des Online-Sicherheitstokens-Dienstes oder
  • Manuelles Eingeben der Werte

Hinweis

Derzeit sind die beiden WS-Fed Anbieter, die auf Kompatibilität mit Microsoft Entra ID getestet wurden, AD FS und Shibboleth.

Erforderliche WS-Verbund-Attribute und -Ansprüche

In den folgenden Tabellen sind die Anforderungen für bestimmte Attribute und Ansprüche aufgeführt, die bei dem Drittanbieter WS-Fed-IdP konfiguriert werden müssen. Die folgenden Attribute müssen in der WS-Fed-Nachricht vom Identitätsanbieter empfangen werden, um einen Verbund einzurichten. Diese Attribute können durch Verlinkung mit der XML-Datei des Online-Sicherheitstokendiensts oder durch manuelle Eingabe konfiguriert werden.

In den folgenden Tabellen finden Sie die erforderlichen Werte.

Hinweis

Stellen Sie sicher, dass der Wert mit der Cloud übereinstimmt, für die Sie einen externen Verbund einrichten.

Tabelle 3: Erforderliche Attribute in der WS-Verbund-Nachricht vom Identitätsanbieter

Attribut Wert für einen Mitarbeitermandanten Wert für einen externen Mandanten
PassiveRequestorEndpoint https://login.microsoftonline.com/login.srf https://<tenantID>.ciamlogin.com/login.srf
Zielgruppe https://login.microsoftonline.com/<tenant ID>/ (Empfohlen) Ersetzen Sie <tenant ID> durch die Mandanten-ID des Microsoft Entra-Mandanten, mit dem Sie einen Verbund einrichten.

In der SAML-Anforderung, die von Microsoft Entra ID für externe Verbunde gesendet wird, ist die Aussteller-URL ein Mandantenendpunkt (zum Beispiel https://login.microsoftonline.com/<tenant ID>/). Für alle neuen Verbunde wird empfohlen, dass alle unsere Partner die Zielgruppe des SAML- oder WS-Fed-basierten IdP auf einen mandantenbasierten Endpunkt festlegen. Alle vorhandenen Partnerverbunde, die mit dem globalen Endpunkt konfiguriert sind (z. B. urn:federation:MicrosoftOnline), funktionieren weiterhin, aber neue Partnerverbunde funktionieren nicht mehr, wenn Ihr externer IdP eine globale Aussteller-URL in der SAML-Anforderung erwartet, die von Microsoft Entra ID gesendet wird.
https://login.microsoftonline.com/<tenant ID>/
Ersetzen Sie <tenant ID> durch die Mandanten-ID des Microsoft Entra-Mandanten, mit dem Sie eine Föderation einrichten.
Issuer Der Aussteller-URI des Partneridentitätsanbieters, z. B. http://www.example.com/exk10l6w90DHM0yi... Der Aussteller-URI des Partneridentitätsanbieters, z. B. http://www.example.com/exk10l6w90DHM0yi...

Tabelle 4: Erforderliche Ansprüche für das vom IdP ausgestellte WS-Fed-Token.

Attribut value
Unveränderliche ID http://schemas.microsoft.com/LiveID/Federation/2008/05/ImmutableID
E-Mail-Adresse http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress

Schritt 3: Konfigurieren des SAML/WS-Fed IdP-Verbunds in Microsoft Entra External ID

Nachdem Ihr Partner seinen IdP in Schritt 2 konfiguriert hat, konfigurieren Sie den Verbund in Microsoft Entra External ID. Sie können das Microsoft Entra Admin Center, Microsoft Graph oder Microsoft Graph PowerShell verwenden. Es kann 5–10 Minuten dauern, bis die Verbundrichtlinie wirksam wird. Versuchen Sie während dieses Zeitraums nicht, die Self-Service-Registrierung abzuschließen oder eine Einladung für die Verbunddomäne einzulösen. Die folgenden Attribute sind erforderlich:

  • Aussteller-URI des IdP des Partners.
  • Passiver Authentifizierungsendpunkt des IdP des Partners. Nur HTTPS wird unterstützt.
  • Der öffentliche Teil des Tokensignaturzertifikats des IdP.

So fügen Sie den IdP zu Ihrem Mandanten im Microsoft Entra Admin Center hinzu

  1. Melden Sie sich mindestens in der Rolle eines Administrators für externe Identitätsanbieter im Microsoft Entra Admin Center an.

  2. Wenn Sie Zugriff auf mehrere Mandanten haben, verwenden Sie das Symbol "Einstellungen" im oberen Menü, um über das Menü "Verzeichnisse" zu Ihrem Mandanten zu wechseln.

  3. Navigieren Sie zu Microsoft Entra ID>Externe Identitäten>alle Identitätsanbieter.

  4. Wählen Sie die Registerkarte "Benutzerdefiniert " und dann " Neue>SAML/WS-Fed hinzufügen" aus.

    Screenshot der Schaltfläche zum Hinzufügen eines neuen SAML- oder WS-Verbund-Identitätsanbieters.

  5. Geben Sie auf der Seite "Neues SAML/WS-Fed IdP " Folgendes ein:

    • Anzeigename – Geben Sie einen Namen ein, um den IdP des Partners zu identifizieren.
    • Identitätsanbieterprotokoll – Wählen Sie SAML oder WS-Fed aus.
    • Domänenlos – Lassen Sie diese Option für domänenbasierten Verbund deaktiviert. Informationen zum Konfigurieren eines SAML-IdP ohne Übereinstimmung mit der E-Mail-Domäne des Benutzers finden Sie unter Konfigurieren des domänenlosen SAML IdP-Partnerverbunds.
    • Domänenname des föderierenden IdP – Geben Sie den IdP-Zieldomänennamen Ihres Partners für die Föderation ein. Geben Sie während dieser anfänglichen Konfiguration nur einen Domänennamen ein. Sie können später weitere Domänen hinzufügen.

    Screenshot der neuen SAML- oder WS-Fed IdP-Seite.

  6. Auswählen einer Methode zum Auffüllen von Metadaten. Wenn Sie über eine Datei verfügen, die die Metadaten enthält, können Sie die Felder automatisch auffüllen, indem Sie die Analysemetadatendatei auswählen und nach der Datei suchen. Alternativ können Sie Eingabemetadaten manuell auswählen und die folgenden Informationen eingeben:

    • Der Aussteller-URI des SAML-IdP des Partners oder die Entitäts-ID des WS-Fed-IdP des Partners.
    • Der Passive Authentifizierungsendpunkt des SAML-IdP des Partners oder der Passive Anfordererendpunkt des WS-Fed IdP des Partners.
    • Zertifikat – Geben Sie den base64-codierten öffentlichen Teil des Tokensignaturzertifikats des IdP ein.
    • Metadaten-URL – Der Speicherort der IdP-Metadaten für die automatische Erneuerung des Signaturzertifikats.

    Screenshot mit Metadatenfeldern.

    Hinweis

    Metadaten-URL ist optional. Es wird jedoch dringend empfohlen. Wenn Sie die Metadaten-URL angeben, kann Microsoft Entra ID das Signaturzertifikat automatisch verlängern, wenn es abläuft. Wenn das Zertifikat aus irgendeinem Grund vor der Ablaufzeit gedreht wird oder Wenn Sie keine Metadaten-URL angeben, kann die Microsoft Entra-ID sie nicht verlängern. In diesem Fall müssen Sie das Signaturzertifikat manuell aktualisieren.

  7. Wählen Sie "Speichern" aus. Der Identitätsanbieter wird der SAML/WS-Fed Identitätsanbieterliste hinzugefügt.

    Screenshot der SAML/WS-Fed Identitätsanbieterliste mit dem neuen Eintrag.

  8. (Optional) So fügen Sie diesem Verbundidentitätsanbieter weitere Domänennamen hinzu:

    1. Wählen Sie den Link in der Spalte "Domänen" aus.

      Screenshot des Links zum Hinzufügen von Domänen zum SAML/WS-Fed Identitätsanbieter.

    2. Geben Sie neben dem Domänennamen des Partner-IDP den Domänennamen ein, und wählen Sie dann "Hinzufügen" aus. Wiederholen Sie diesen Schritt für jede Domäne, die Sie hinzufügen möchten. Wenn Sie fertig sind, wählen Sie "Fertig" aus.

      Screenshot der Schaltfläche

So konfigurieren Sie den Verbund mit der Microsoft Graph-API

Verwenden Sie die Microsoft Graph v1.0 samlOrWsFedExternalDomainFederation-Ressource, um Verbundkonfigurationen abzurufen oder zu erstellen. Die Beispiele in diesem Abschnitt verwenden SAML. Um einen WS-Fed IdP zu konfigurieren, verwenden Sie die WS-Fed-Einstellungen des Partners und setzen Sie preferredAuthenticationProtocol auf wsFed.

Melden Sie sich für delegierten Zugriff mindestens als Administrator des externen Identitätsanbieters an. Das Zugriffstoken muss über die erforderlichen Berechtigungen für den Vorgang verfügen:

Operation Microsoft Graph-Berechtigung
Partnerverbundkonfigurationen auflisten oder abrufen. Domain.Read.All
Erstellen Sie eine Verbundkonfiguration. IdentityProvider.ReadWrite.All
Verbundkonfiguration löschen. Domain.ReadWrite.All oder IdentityProvider.ReadWrite.All

Ersetzen Sie {token} durch ein Zugriffstoken für Microsoft Graph. Die Beispielantworten sind illustrativ und zur Lesbarkeit gekürzt. IDs und Konfigurationswerte unterscheiden sich in Ihrem Mandanten, und der Zertifikatplatzhalter ist kein verwendbares Zertifikat.

SAML/WS-Fed-IdP-Verbundpartnerschaften auflisten

Verwenden Sie die folgende Anforderung, um die SAML/WS-Fed Verbundkonfigurationen in Ihrem Mandanten aufzulisten:

GET https://graph.microsoft.com/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation
Authorization: Bearer {token}

Bei einer erfolgreichen Anforderung werden 200 OK und eine Sammlung in value zurückgegeben:

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"
        }
      ]
    }
  ]
}

Wenn die Antwort @odata.nextLink enthält, fordern Sie diese URL an, um die nächste Seite abzurufen. Fahren Sie fort, bis kein nächster Link zurückgegeben wird. Weitere Informationen finden Sie unter Paging Microsoft Graph Daten.

Verbund nach Domäne suchen

Verwenden Sie einen domains/any Filter, um die Verbundkonfiguration für eine bestimmte Domäne zu finden. Die folgende Anfrage filtert nach 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}

Die Antwort ist immer noch eine Sammlung, auch wenn nur eine Föderation übereinstimmt:

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"
        }
      ]
    }
  ]
}

Wenn kein Verbund mit der Domäne übereinstimmt, ist value ein leeres Array.

Abrufen eines Verbundes nach ID

Um eine Verbundkonfiguration abzurufen, verwenden Sie deren id aus einer Liste oder einer Domänenfilterantwort:

GET https://graph.microsoft.com/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation/11111111-2222-3333-4444-555555555555
Authorization: Bearer {token}

Die Antwort enthält ein einzelnes Verbundobjekt anstelle einer value Auflistung:

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"
    }
  ]
}
Erstellen eines domänenbasierten SAML-IdP

Verwenden Sie die folgende Anforderung, um eine SAML-Verbundkonfiguration zu erstellen für 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"
    }
  ]
}

Ersetzen Sie die Beispielwerte durch die IdP-Einstellungen des Partners:

Eigentum Beispielwert und Zweck
displayName Contoso SAML IdP ist ein Name, der Ihnen hilft, den Anbieter zu identifizieren.
issuerUri https://idp.contoso.com/saml, die Issuer-URI, die den IdP des Partners identifiziert.
passiveSignInUri https://idp.contoso.com/sso/saml, der HTTPS-Endpunkt für die browserbasierte Anmeldung.
metadataExchangeUri https://idp.contoso.com/metadata, die IDP-Metadaten-URL.
preferredAuthenticationProtocol saml für einen SAML-IdP.
signingCertificate Der base64-codierte öffentliche Teil des Tokensignaturzertifikats des IdP, nicht eine Zertifikat-ID oder ein privater Schlüssel.
domains Die externen Domänen, die dem IdP zugeordnet sind, wie z. B. contoso.com.

Eine erfolgreiche Anfrage gibt 201 Created und das resultierende Föderationsobjekt zurück. Die folgende Antwort zeigt die ID und den Anzeigenamen an:

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "11111111-2222-3333-4444-555555555555",
  "displayName": "Contoso SAML IdP"
}

Informationen zum Erstellen eines SAML-IdP, das Benutzer nicht anhand der E-Mail-Domäne abgleicht, finden Sie unter Erstellen eines domänenlosen SAML-IdP mit Microsoft Graph.

Konfigurieren des Verbunds mit Microsoft Graph PowerShell

Installieren Sie Microsoft Graph-PowerShell-SDK. Diese Beispiele verwenden Invoke-MgGraphRequest aus dem Microsoft.Graph.Authentication Modul, um dieselben v1.0-Endpunkte aufzurufen.

Verwenden Sie ein Konto mit mindestens der Rolle "Administrator des externen Identitätsanbieters". Ersetzen Sie die Beispielmandanten-ID, Domäne, Verbund-ID, URLs und Zertifikate durch Ihre eigenen Werte.

Auflisten von Föderationen mit PowerShell

Stellen Sie eine Verbindung mit dem Mandanten her, mit dem Sie den Partnerverbund mit Domain.Read.All konfigurieren möchten. Im folgenden Beispiel wird jede Seite von SAML/WS-Fed-Verbundkonfigurationen abgerufen:

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)
Verbund nach Domäne mit PowerShell suchen

Das folgende Beispiel URL-kodiert den Filter und ruft die Konfiguration ab, die mit contoso.com verknüpft ist:

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 *
Abrufen eines Verbundes nach ID mit PowerShell

Verwenden Sie die Verbund-ID aus einer Liste oder Domänenfilterantwort:

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 *
Erstellen eines domänenbasierten SAML-IdP mit PowerShell

Stellen Sie mit IdentityProvider.ReadWrite.All eine Verbindung her, bereiten Sie den Request-Body vor, und erstellen Sie die Verbundkonfiguration:

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 *

Informationen zum Erstellen eines domänenlosen SAML-IdP finden Sie unter Erstellen eines domänenlosen SAML-IdP mit PowerShell.

Schritt 4: Konfigurieren des Einlösungsauftrags (B2B-Zusammenarbeit in Mitarbeitermandanten)

Wenn Sie den Verbund in Ihrem Mitarbeitermandanten für B2B Collaboration mit einer überprüften Domäne konfigurieren, stellen Sie sicher, dass der Partneridentitätsanbieter zunächst beim Einlösen der Einladung verwendet wird. Konfigurieren Sie die Einstellungen für die Einlösereihenfolge in Ihren mandantenübergreifenden Zugriffseinstellungen für den eingehenden B2B Collaboration-Datenverkehr. Verschieben Sie SAML/WS-Fed Identitätsanbieter an den Anfang der Liste der primären Identitätsanbieter , um die Einlösung mit dem Verbund-IDP zu priorisieren.

Sie können das Partnerverbundsetup testen, indem Sie einen neuen B2B-Gastbenutzer einladen. Ausführliche Informationen finden Sie unter Hinzufügen von Microsoft Entra B2B-Benutzern für die Zusammenarbeit im Microsoft Entra Admin Center.

Hinweis

Sie können den Einladungseinlösungsauftrag mithilfe der Microsoft Graph-REST-API (Betaversion) konfigurieren. Siehe Beispiel 2: Aktualisieren der Standardkonfiguration zur Einlösung von Einladungen in der Microsoft Graph-Referenzdokumentation.

Domänenlose SAML-IdP-Föderation

Der herkömmliche Partnerverbund in Microsoft Entra ID erfordert, dass Sie eine benutzerdefinierte Domäne (z. B. contoso.com) überprüfen und diese Domäne so konfigurieren, dass Authentifizierungsanforderungen an einen externen SAML-Identitätsanbieter (IdP) umgeleitet werden. In diesem Setup wird die Domäne des vom externen IdP bereitgestellten E-Mail-Anspruchs nach der Authentifizierung anhand der Domäne überprüft, die dem konfigurierten SAML-IdP in Microsoft Entra ID zugeordnet ist.

Wenn sich die E-Mail-Domäne des Benutzers von der domäne unterscheidet, die auf dem SAML-IdP konfiguriert ist (z. B. yahoo.com oder gmail.com), tritt bei der Anmeldung möglicherweise der folgende Fehler auf:

AADSTS5000819: SAML Assertion ist ungültig. Der E-Mail-Adressanspruch fehlt oder stimmt nicht mit der Domäne aus einem externen Bereich überein.

Dieser Fehler tritt normalerweise in den folgenden Fällen auf:

  • Der externe SAML-IdP sendet keinen E-Mail-Anspruch oder
  • Die vom IdP bereitgestellte E-Mail-Adressdomäne stimmt nicht mit der Domäne überein, die auf dem externen IdP in Microsoft Entra ID konfiguriert ist.

Auch wenn ein E-Mail-Anspruch vorhanden ist, schlägt die Authentifizierung möglicherweise immer noch fehl, wenn die E-Mail-Domäne aufgrund der domänenbasierten Übereinstimmungsanforderungen nicht mit der konfigurierten IdP-Domäne übereinstimmt.

Der domänenlose SAML-Partnerverbund mit einem SAML-Identitätsanbieter ermöglicht externen Benutzern, sich mit ihren idP-verwalteten Anmeldeinformationen unabhängig von ihrer E-Mail-Domäne bei Ihren Apps oder Personalressourcen zu authentifizieren. Die domänenlose Verbundauthentifizierung macht einen Domänenabgleich zwischen der E-Mail-Adresse des Benutzers und vorkonfigurierten IdP-Domänen bei der Anmeldung oder beim Einlösen einer Einladung überflüssig.

Konfigurieren eines domänenlosen SAML-IdP-Partnerverbunds

Um die Einschränkung für den Domänenvergleich zu beheben, können Sie den SAML-IdP als domänenlos konfigurieren. Wenn domänenloser Partnerverbund aktiviert ist:

  • Microsoft Entra ID leitet Authentifizierungsanforderungen basierend auf der Aussteller-URI-Zuordnung an die konfigurierte SAML-IDP weiter.
  • Die E-Mail-Adressdomäne des Benutzers wird nicht mit der für den IdP konfigurierten Domäne abgeglichen.

Benutzer können sich dann erfolgreich mithilfe von E-Mail-Adressen aus einer beliebigen Domäne (z. B. yahoo.com oder gmail.com) authentifizieren, wenn Sie sich mit dem externen SAML-IdP anmelden.

Important

Pro Mandant kann nur ein Wildcard-IDP konfiguriert werden. In Microsoft Graph verfügt ein domänenloser SAML-IdP über eine domains Sammlung, die einen einzelnen Eintrag enthält, dessen id-Wert * ist. Kombinieren Sie den Wildcard nicht mit bestimmten Domänennamen.

Erstellen Sie einen neuen domänenlosen SAML-IdP im Microsoft Entra Admin Center

So erstellen Sie einen neuen domänenlosen SAML-IdP:

  1. Melden Sie sich mindestens in der Rolle eines Administrators für externe Identitätsanbieter im Microsoft Entra Admin Center an.

  2. Navigieren Sie zu Microsoft Entra ID>Externe Identitäten>alle Identitätsanbieter.

  3. Wählen Sie die Registerkarte "Benutzerdefiniert " und dann " Neue>SAML/WS-Fed hinzufügen" aus.

  4. Geben Sie auf der Seite Neue SAML/WS-Fed IdP einen Anzeigenamen ein, z. B. Contoso SAML IdP, wählen Sie SAML für das Identitätsanbieterprotokoll aus, und wählen Sie Domänenlos aus. Sie müssen keine bestimmte Verbunddomäne eingeben.

    Screenshot der neuen SAML/WS-Fed-Identitätsanbieterseite mit ausgewählter Option „Domainless“.

  5. Analysieren Sie eine Metadatendatei, oder geben Sie den Aussteller-URI, den passiven Authentifizierungsendpunkt, das Signaturzertifikat und die Metadaten-URL manuell ein, wie unter "So fügen Sie den IdP Ihrem Mandanten im Microsoft Entra Admin Center hinzu" beschrieben.

  6. Wählen Sie "Speichern" aus.

Erstellen Sie einen domänenlosen SAML-IdP mit Microsoft Graph

Verwenden Sie denselben Erstellungsendpunkt und IdentityProvider.ReadWrite.All dieselbe Berechtigung wie für einen domänenbasierten SAML-IdP. Legen Sie id des Domäneneintrags auf * fest:

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": "*"
    }
  ]
}

Eine erfolgreiche Anforderung gibt 201 Created und das neue Verbundobjekt zurück. Die folgende Antwort ist gekürzt:

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "66666666-7777-8888-9999-000000000000",
  "displayName": "Contoso SAML IdP"
}

Rufen Sie die Konfiguration anhand der zurückgegebenen ID ab, und bestätigen Sie, dass domains den Wildcard-Eintrag enthält.

Erstellen eines domänenlosen SAML-IdP mit PowerShell

Verwenden Sie das Microsoft.Graph.Authentication Modul und ein Konto mit mindestens der Rolle "Administrator für externe Identitätsanbieter", wie unter "Konfigurieren des Verbunds mit Microsoft Graph PowerShell" beschrieben. Im folgenden Beispiel wird direkt ein domänenloses SAML-IdP erstellt. Führen Sie dieses Beispiel und das domänenbasierte Erstellungsbeispiel für denselben Anbieter nicht aus.

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 *

Domänenbasierten SAML-Verbund in domänenlosen Verbund aktualisieren

Sie können einen domänenbasierten SAML-IdP in eine domänenlose Konfiguration ändern, indem Sie das Microsoft Entra Admin Center, Microsoft Graph oder Microsoft Graph PowerShell verwenden. Aktualisieren Sie nach jeder Konvertierung die zugehörigen Benutzerflüsse.

Important

Wenn sich ein vorhandener Gast nach der Änderung nicht anmelden kann oder sich der IdP-Aussteller-URI geändert hat, setzen Sie deren Einlösungsstatus zurück.

Konvertieren Sie einen vorhandenen SAML-IdP im Microsoft Entra Admin Center

So ändern Sie im Admin Center eine domänenbasierte SAML-IDP in "Domainless":

  1. Melden Sie sich mindestens in der Rolle eines Administrators für externe Identitätsanbieter im Microsoft Entra Admin Center an.

  2. Navigieren Sie zu Microsoft Entra ID>Externe Identitäten>alle Identitätsanbieter.

  3. Wählen Sie auf allen Identitätsanbietern die Registerkarte "Benutzerdefiniert " aus, und suchen Sie nach dem SAML-IdP.

  4. Wählen Sie den Link in der Spalte "Domänen " aus, um den Bereich "Domänendetails" zu öffnen.

  5. Wählen Sie Domänenlos und dann Fertig aus.

    Screenshot des Bereichs

Einen domänenbasierten SAML-IdP mit Microsoft Graph konvertieren

Wenn Sie einen domänenbasierten SAML-IdP mit Microsoft Graph in domänenlos umwandeln möchten, rufen Sie die Einstellungen ab und speichern Sie sie, löschen Sie die vorhandene Konfiguration und erstellen Sie einen Ersatz durch die Wildcarddomäne.

Important

Das Löschen einer Verbundkonfiguration kann verhindern, dass sich vorhandene Verbundgastbenutzer anmelden. Planen und testen Sie die Änderung, bevor Sie sie in der Produktion verwenden, und speichern Sie die vorhandenen Einstellungen vor dem Löschen, damit Sie die ursprüngliche Konfiguration bei Bedarf neu erstellen können. Der Ersatz-IdP hat eine neue ID. Zeichnen Sie alle Zuordnungen zu Benutzerflüssen vor dem Löschen auf. Fügen Sie in einem externen Mandanten dem entsprechenden Benutzerablauf den Ersetzungs-IDP hinzu.

Verwenden Sie Domain.Read.All zum Abrufen der Konfiguration und IdentityProvider.ReadWrite.All zum Erstellen des Ersatzes. Die letztere Berechtigung erlaubt auch die Löschung. Für delegierten Zugriff muss der Administrator mindestens über die Administratorrolle des externen Identitätsanbieters verfügen.

  1. Rufen Sie die vorhandene SAML-IDP anhand ihrer ID ab:

    GET https://graph.microsoft.com/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation/11111111-2222-3333-4444-555555555555
    Authorization: Bearer {token}
    
  2. Speichern Sie die Antwort, und stellen Sie sicher, dass sie den SAML-IdP beschreibt, den Sie ersetzen möchten. Die folgende Antwort zeigt einen IdP an, der mit contoso.com verknüpft ist:

    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. Bereiten Sie die Ersetzungsanforderung vor, bevor Sie den vorhandenen IdP löschen. Behalten Sie die Konfigurationswerte des IdP bei, entfernen Sie die schreibgeschützten id und alle nur in Antworten enthaltenen OData-Anmerkungen, und ersetzen Sie die domains Auflistung durch einen einzelnen Eintrag, dessen id Wert lautet *. Vergewissern Sie sich, dass Ihr Mandant noch nicht über einen anderen Wildcard-IDP verfügt.

  4. Löschen Sie die vorhandene Verbundkonfiguration. Fügen Sie Ihre ID in die Anforderungs-URL ein; senden Sie DELETE nicht an die URL der Sammlung.

    DELETE https://graph.microsoft.com/v1.0/directory/federationConfigurations/11111111-2222-3333-4444-555555555555
    Authorization: Bearer {token}
    

    Ein erfolgreicher Löschvorgang gibt Folgendes zurück:

    HTTP/1.1 204 No Content
    
  5. Erstellen Sie den Ersatz-IDP mit den gespeicherten Einstellungen und der Wildcarddomäne:

    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": "*"
        }
      ]
    }
    

    Eine erfolgreiche Anforderung gibt 201 Created und das Ersatzverbundobjekt zurück. Die folgende Antwort ist gekürzt:

    HTTP/1.1 201 Created
    Content-Type: application/json
    
    {
      "id": "66666666-7777-8888-9999-000000000000",
      "displayName": "Contoso SAML IdP"
    }
    
  6. Rufen Sie den Ersatz anhand der neuen ID ab, und stellen Sie sicher, dass domains* enthält. Stellen Sie alle Benutzerflusszuordnungen wieder her, und testen Sie die Anmeldung mit dem konfigurierten Aussteller-URI, wie im Benutzerfluss für domänenlosen SAML-IdP-Verbund beschrieben.

Konvertieren eines domänenbasierten SAML-IdP mit PowerShell

Verwenden Sie das Microsoft.Graph.Authentication Modul und ein Konto mit mindestens der Rolle "Administrator für externe Identitätsanbieter". Mit diesem Verfahren wird die Verbundkonfiguration gelöscht und neu erstellt. Überprüfen Sie den Microsoft-Graph-Konvertierungsleitfaden, einschließlich der Löschauswirkungen und der Ersatz-ID, bevor Sie sie ausführen.

  1. Stellen Sie eine Verbindung mit dem Zielmandanten mit Lese- und Schreibberechtigungen her, rufen Sie den vorhandenen SAML-IdP ab, und speichern Sie dessen Konfiguration. Ersetzen Sie die Beispielmandanten-ID und Verbund-ID durch Ihre eigenen Werte.

    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. Bereiten Sie den Ersatz mit den gespeicherten IdP-Einstellungen und einer Wildcarddomäne vor. Fügen Sie die vorhandene Verbund-ID nicht in die Erstellungsanforderung ein. Überprüfen Sie das Backup und den Request-Body, bevor Sie fortfahren, und vergewissern Sie sich, dass der Mandant noch keinen anderen Wildcard-IdP hat.

    $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. Löschen Sie die vorhandene Konfiguration, und erstellen Sie dann die Ersatzkonfiguration. Diese Befehle unterbrechen den Verbund, bis der Ersatz erstellt wird. Wenn die Erstellung nach dem Löschen fehlschlägt, verwenden Sie die gespeicherten Einstellungen, um die ursprüngliche domänenbasierte Konfiguration neu zu erstellen.

    $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. Rufen Sie den Ersatz anhand der neuen ID ab, und stellen Sie sicher, dass sein Domäneneintrag * ist:

    $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. Aktualisieren Sie die zugehörigen Benutzerflüsse und testen Sie die Anmeldung.

Benutzerfluss für domänenlosen SAML-IdP-Verbund

Nach dem Konfigurieren des domänenlosen Partnerverbunds können Sie Gastbenutzer aus der Partnerorganisation einladen, indem Sie die folgenden Schritte ausführen:

  1. Navigieren Sie im Microsoft Entra Admin Center zu Identity>Users>All users.
  2. Wählen Sie +Neuer Benutzer und dann "Externen Benutzer einladen" aus.
  3. Geben Sie die E-Mail-Adresse des Gastbenutzers ein. Die E-Mail-Domäne muss nicht mit einer überprüften Domäne in Ihrem Mandanten übereinstimmen.
  4. Fügen Sie in der Einladungsumleitungs-URL einen domain_hint Parameter hinzu, um sicherzustellen, dass der Benutzer basierend auf dem konfigurierten Aussteller-URI an den entsprechenden IDP weitergeleitet wird. Der wert domain_hint muss mit dem in der SAML IdP-Konfiguration definierten Aussteller-URI übereinstimmen.
  5. Schließen Sie die Einladung ab, und senden Sie sie.
  6. Wenn der eingeladene Benutzer die Einladung einlöst, leitet Microsoft Entra ID die Authentifizierungsanforderung mithilfe des Aussteller-URI im Parameter domain_hint an den konfigurierten SAML-IdP weiter.
  7. Der Benutzer authentifiziert sich mit dem externen SAML-IdP. Die E-Mail-Adressdomäne des Benutzers wird nicht mit der für den IdP konfigurierten Domäne abgeglichen, und der Benutzer kann auf den Ressourcenmandanten zugreifen.
  8. Bei nachfolgenden Anmeldungen kann der Benutzer direkt auf die Ressourcenmandantenanwendung zugreifen, indem er sich mit dem externen SAML-IdP authentifiziert, da das Benutzerobjekt mit der externen IdP-Zuordnung aktualisiert wird.

Bekannte Probleme

Berücksichtigen Sie die folgenden bekannten Probleme beim Konfigurieren des domänenlosen SAML IdP-Verbunds:

  • Die IdP-Konfiguration wird gelöscht, wenn ein ungültiger Domänenname eingegeben wird, auch wenn die IdP-Konfiguration nicht gespeichert wird.
  • Wenn Sie einen SAML-IdP von domänenbasiert in domänenlos konvertieren, aktualisieren Sie die zugehörigen Benutzerflüsse. Wenn Sie den IdP löschen und neu erstellen, fügen Sie zuerst den Ersetzungs-IDP zu jedem Benutzerablauf hinzu. Deaktivieren Sie dann den IdP im Benutzerablauf, speichern, den IdP erneut aktivieren und erneut speichern. Informationen zum Aktualisierungsvorgang des Benutzerflusses finden Sie unter Bekannte Einschränkungen.

So aktualisieren Sie die Zertifikat- oder Konfigurationsdetails

Auf der Seite „Alle Identitätsanbieter“ können Sie die Liste der konfigurierten SAML/WS-Fed-Identitätsanbieter und deren Zertifikatsablaufdaten anzeigen. In dieser Liste können Sie Zertifikate verlängern und andere Konfigurationsdetails ändern.

  1. Melden Sie sich mindestens in der Rolle eines Administrators für externe Identitätsanbieter im Microsoft Entra Admin Center an.

  2. Navigieren Sie zu Microsoft Entra ID>Externe Identitäten>alle Identitätsanbieter.

  3. Wählen Sie die Registerkarte "Benutzerdefiniert" aus.

  4. Scrollen Sie zu einem Identitätsanbieter in der Liste, oder verwenden Sie das Suchfeld.

  5. So aktualisieren Sie die Zertifikats- oder Konfigurationsdetails

    • Wählen Sie in der Spalte "Konfiguration" für den Identitätsanbieter den Link "Bearbeiten" aus.
    • Ändern Sie auf der Konfigurationsseite nach Bedarf die folgenden Details:
      • Anzeigename – Name der Organisation des Partners.
      • Identitätsanbieterprotokoll – Wählen Sie SAML oder WS-Fed aus.
      • Passiver Authentifizierungsendpunkt – Der passive Anfordererendpunkt des Partner-IdP.
      • Zertifikat – Der base64-codierte öffentliche Teil des Tokensignaturzertifikats des IdP. Um es zu erneuern, geben Sie das neue Signaturzertifikat ein.
      • Metadaten-URL – Die URL, die die Metadaten des Partners enthält, wird für die automatische Erneuerung des Signaturzertifikats verwendet.
    • Wählen Sie "Speichern" aus.

    Screenshot der IDP-Konfigurationsdetails.

  6. Um die dem Partner zugeordneten Domänen zu bearbeiten, wählen Sie den Link in der Spalte "Domänen" aus. Im Bereich „Domänendetails“:

    • Wenn Sie eine Domäne hinzufügen möchten, geben Sie den Domänennamen neben dem Domänennamen des Partner-IdP ein, und wählen Sie dann "Hinzufügen" aus. Wiederholen Sie diesen Schritt für jede Domäne, die Sie hinzufügen möchten.
    • Um eine Domäne zu löschen, wählen Sie das Symbol „Löschen“ neben der Domäne aus.
    • Wenn Sie fertig sind, wählen Sie "Fertig" aus.

    Screenshot der Seite

Um zum domänenlosen Verbund zu wechseln, folgen Sie Einen vorhandenen SAML-IdP im Microsoft Entra Admin Center konvertieren.

Hinweis

Wenn Sie einen Partnerverbund entfernen möchten, löschen Sie zuerst alle Domänen bis auf eine, und führen Sie dann die Schritte unter So entfernen Sie einen Verbund aus.

So entfernen Sie die Föderation

Sie können Ihre Verbundkonfiguration entfernen. Wenn Sie dies tun, können sich Partnerverbund-Gastbenutzer, die ihre Einladungen bereits eingelöst haben, nicht mehr anmelden. Sie können ihnen jedoch erneut Zugriff auf Ihre Ressourcen gewähren, indem Sie den Einlösungsstatus zurücksetzen. So entfernen Sie eine Konfiguration für einen IdP im Microsoft Entra Admin Center:

  1. Melden Sie sich mindestens in der Rolle eines Administrators für externe Identitätsanbieter im Microsoft Entra Admin Center an.

  2. Navigieren Sie zu Microsoft Entra ID>Externe Identitäten>alle Identitätsanbieter.

  3. Wählen Sie die Registerkarte "Benutzerdefiniert " aus, und scrollen Sie dann in der Liste zum Identitätsanbieter, oder verwenden Sie das Suchfeld.

  4. Wählen Sie den Link in der Spalte "Domänen " aus, um die Domänendetails des IdP anzuzeigen.

  5. Löschen Sie alle Domänen außer einer der Domänen in der Domänennamenliste .

  6. Wählen Sie "Konfiguration löschen" und dann " Fertig" aus.

    Screenshot des Löschens einer Konfiguration.

  7. Wählen Sie 'OK' aus, um den Löschvorgang zu bestätigen.

Sie können den Partnerverbund auch mithilfe des Ressourcentyps samlOrWsFedExternalDomainFederation der Microsoft Graph-API entfernen.

Nächste Schritte