Freigeben über

samlOrWsFedExternalDomainFederation-Ressourcentyp

  • Artikel

Namespace: microsoft.graph

Ermöglicht es einem Microsoft Entra-Mandanten, einen Verbund mit einer externen Organisation herzustellen, deren Identitätsanbieter (IdP) das SAML- oder WS-Fed-Protokoll unterstützt. Dadurch kann der Microsoft Entra-Mandant Gastbenutzern den Zugriff auf seine Ressourcen ermöglichen. Weitere Informationen zu SAML oder WS-Fed IdP-Verbund finden Sie unter Verbund mit SAML oder WS-Fed Identitätsanbieter für Gastbenutzer.

Erbt von samlOrWsFedProvider.

Methoden

Methode Rückgabetyp Beschreibung
List samlOrWsFedExternalDomainFederation-Auflistung Ruft eine Liste der samlOrWsFedExternalDomainFederation-Objekte und deren Eigenschaften ab.
Create samlOrWsFedExternalDomainFederation Erstellen Sie ein neues samlOrWsFedExternalDomainFederation-Objekt .
Get samlOrWsFedExternalDomainFederation Liest die Eigenschaften und Beziehungen eines samlOrWsFedExternalDomainFederation-Objekts .
Update samlOrWsFedExternalDomainFederation Aktualisieren Sie die Eigenschaften eines samlOrWsFedExternalDomainFederation-Objekts .
Delete Keine Löscht ein samlOrWsFedExternalDomainFederation-Objekt .
Domänen auflisten externalDomainName-Auflistung Rufen Sie die externalDomainName-Ressourcen aus der Domänennavigationseigenschaft ab.
Erstellen eines externen Domänennamens externalDomainName Erstellen Sie ein neues externalDomainName-Objekt.

Eigenschaften

Eigenschaft Typ Beschreibung
displayName Zeichenfolge Der Anzeigename des SAML- oder WS-Fed-basierten IdP. Geerbt von identityProviderBase.
id Zeichenfolge Der Bezeichner des Identitätsanbieters. Geerbt von entity.
issuerUri Zeichenfolge Aussteller-URI des Verbundservers. Geerbt von samlOrWsFedProvider.
metadataExchangeUri Zeichenfolge Der URI des Metadatenaustauschendpunkts, der für die Authentifizierung von Rich-Client-Anwendungen verwendet wird. Geerbt von samlOrWsFedProvider.
passiveSignInUri Zeichenfolge URI, an den webbasierte Clients weitergeleitet werden, wenn sie sich bei Microsoft Entra-Diensten anmelden. Geerbt von samlOrWsFedProvider.
preferredAuthenticationProtocol authenticationProtocol Bevorzugtes Authentifizierungsprotokoll. Die möglichen Werte sind: wsFed, saml, unknownFutureValue. Geerbt von samlOrWsFedProvider.
signingCertificate Zeichenfolge Aktuelles Zertifikat, das zum Signieren von Token verwendet wird, die an die Microsoft Identity Platform übergeben werden. Das Zertifikat ist als Base64-codierte Zeichenfolge des öffentlichen Teils des Tokensignaturzertifikats des Verbund-IdP formatiert und muss mit der X509Certificate2-Klasse kompatibel sein.

Diese Eigenschaft wird in den folgenden Szenarien verwendet:
  • , wenn ein Rollover außerhalb des Updates für automatisches Rollover erforderlich ist
  • Ein neuer Verbunddienst wird eingerichtet
  • , wenn das neue Tokensignaturzertifikat nicht in den Verbundeigenschaften vorhanden ist, nachdem das Verbunddienstzertifikat aktualisiert wurde.


Microsoft Entra ID aktualisiert Zertifikate über einen Automatischrollover-Prozess, bei dem versucht wird, ein neues Zertifikat aus den Verbunddienstmetadaten abzurufen, 30 Tage vor Ablauf des aktuellen Zertifikats. Wenn kein neues Zertifikat verfügbar ist, überwacht Microsoft Entra ID die Metadaten täglich und aktualisiert die Verbundeinstellungen für die Domäne, wenn ein neues Zertifikat verfügbar ist.

Geerbt von samlOrWsFedProvider.

Beziehungen

Beziehung Typ Beschreibung
Domänen externalDomainName-Auflistung Sammlung von Domänennamen der externen Organisationen, mit denen der Mandant einen Verbund erstellt. Unterstützt $filter (eq).

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.samlOrWsFedExternalDomainFederation",
  "id": "String (identifier)",
  "displayName": "String",
  "issuerUri": "String",
  "metadataExchangeUri": "String",
  "signingCertificate": "String",
  "passiveSignInUri": "String",
  "preferredAuthenticationProtocol": "String"
}