internalDomainFederation-Ressourcentyp

Artikel
10/14/2024

Namespace: microsoft.graph

Stellt Konfigurationen von Mandantendomänen dar, die im Verbund mit Microsoft Entra ID überprüft werden. Verwenden Sie diese Ressource, um Verbundeinstellungen zu konfigurieren, wenn Sie den Verbund mit Microsoft Entra ID einrichten. Informationen zum Verbund finden Sie unter Was ist verbund mit Microsoft Entra ID?.

Erbt von samlOrWsFedProvider.

Methoden

Methode	Rückgabetyp	Beschreibung
List	internalDomainFederation-Auflistung	Lesen Sie die Eigenschaften des internalDomainFederation-Objekts für die Domäne.
Create	internalDomainFederation	Erstellen Sie ein neues internalDomainFederation-Objekt .
Get	internalDomainFederation	Liest die Eigenschaften und Beziehungen eines internalDomainFederation-Objekts .
Update	internalDomainFederation	Aktualisieren Sie die Eigenschaften eines internalDomainFederation-Objekts .
Delete	Keine	Löschen Sie ein internalDomainFederation-Objekt .

Eigenschaften

Eigenschaft	Typ	Beschreibung
activeSignInUri	String	URL des Endpunkts, der von aktiven Clients bei der Authentifizierung mit Verbunddomänen verwendet wird, die für einmaliges Anmelden in Microsoft Entra ID eingerichtet sind. Entspricht der ActiveLogOnUri-Eigenschaft des PowerShell-Cmdlets Set-MsolDomainFederationSettings MSOnline v1.
displayName	String	Der Anzeigename des Verbundidentitätsanbieters (IdP). Geerbt von identityProviderBase.
federatedIdpMfaBehavior	federatedIdpMfaBehavior	Bestimmt, ob Microsoft Entra ID die MFA akzeptiert, die vom Verbund-IdP ausgeführt wird, wenn ein Verbundbenutzer auf eine Anwendung zugreift, die von einer Richtlinie für bedingten Zugriff gesteuert wird, die MFA erfordert. Mögliche Werte sind: `acceptIfMfaDoneByFederatedIdp`, `enforceMfaByFederatedIdp`, `rejectMfaByFederatedIdp`, `unknownFutureValue`. Weitere Informationen finden Sie unter federatedIdpMfaBehavior-Werte.
id	String	Der Bezeichner des Verbundidentitätsanbieters. Geerbt von entity.
isSignedAuthenticationRequestRequired	Boolesch	Wenn `true`, wenn SAML-Authentifizierungsanforderungen an den SAML-Verbund-IdP gesendet werden, signiert Microsoft Entra ID diese Anforderungen mithilfe des OrgID-Signaturschlüssels. Wenn `false` (Standard) ist, werden die an den Verbund-IdP gesendeten SAML-Authentifizierungsanforderungen nicht signiert.
issuerUri	String	Aussteller-URI des Verbundservers. Geerbt von samlOrWsFedProvider.
metadataExchangeUri	String	Der URI des Metadatenaustauschendpunkts, der für die Authentifizierung von Rich-Client-Anwendungen verwendet wird. Geerbt von samlOrWsFedProvider.
nextSigningCertificate	String	Fallbacktokensignaturzertifikat, das auch zum Signieren von Token verwendet werden kann, z. B. wenn das primäre Signaturzertifikat abläuft. Formatiert als Base64-codierte Zeichenfolgen des öffentlichen Teils des Tokensignaturzertifikats des Verbund-IdP. Muss mit der X509Certificate2-Klasse kompatibel sein. Ähnlich wie signingCertificate wird die nextSigningCertificate-Eigenschaft verwendet, wenn ein Rollover außerhalb des automatischen Rolloverupdates erforderlich ist, ein neuer Verbunddienst eingerichtet wird oder wenn das neue Tokensignaturzertifikat in den Verbundeigenschaften nicht vorhanden ist, nachdem das Verbunddienstzertifikat aktualisiert wurde.
passiveSignInUri	String	URI, an den webbasierte Clients weitergeleitet werden, wenn sie sich bei Microsoft Entra-Diensten anmelden. Geerbt von samlOrWsFedProvider.
preferredAuthenticationProtocol	authenticationProtocol	Bevorzugtes Authentifizierungsprotokoll. Dieser Parameter muss explizit konfiguriert werden, damit der passive Verbundauthentifizierungsflow funktioniert. Die möglichen Werte sind: `wsFed`, `saml`, `unknownFutureValue`. Geerbt von samlOrWsFedProvider.
promptLoginBehavior	promptLoginBehavior	Legt das bevorzugte Verhalten für die Anmeldeaufforderung fest. Mögliche Werte sind: `translateToFreshPasswordAuthentication`, `nativeSupport`, `disabled`, `unknownFutureValue`.
signingCertificate	String	Aktuelles Zertifikat, das zum Signieren von Token verwendet wird, die an den 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 Automatischrollover-Updates 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.
signingCertificateUpdateStatus	signingCertificateUpdateStatus	Stellt status und Zeitstempel der letzten Aktualisierung des Signaturzertifikats bereit.
signOutUri	String	URI, an den Clients umgeleitet werden, wenn sie sich bei Microsoft Entra-Diensten abmelden. Entspricht der LogOffUri-Eigenschaft des PowerShell-Cmdlets Set-MsolDomainFederationSettings MSOnline v1.

Hinweis

Azure AD- und MSOnline PowerShell-Module sind ab dem 30. März 2024 veraltet. Weitere Informationen finden Sie im Update zu Einstellungen. Nach diesem Datum beschränkt sich der Support für diese Module auf Unterstützung bei der Migration zum Microsoft Graph PowerShell SDK und auf Sicherheitskorrekturen. Die veralteten Module werden noch bis zum 30. März 2025 zur Verfügung stehen.

Es wird empfohlen, zu Microsoft Graph PowerShell zu migrieren, um mit Microsoft Entra ID (früher Azure AD) zu interagieren. Allgemeine Fragen zur Migration finden Sie in den Häufig gestellten Fragen zur Migration. Hinweis: Bei den Versionen 1.0.x von MSOnline kann es nach dem 30. Juni 2024 zu Unterbrechungen kommen.

federatedIdpMfaBehavior-Werte

Member	Beschreibung
acceptIfMfaDoneByFederatedIdp	Microsoft Entra ID akzeptiert MFA, die vom Verbundidentitätsanbieter ausgeführt wird. Wenn der Verbundidentitätsanbieter keine MFA ausgeführt hat, führt Microsoft Entra ID die MFA aus.
enforceMfaByFederatedIdp	Microsoft Entra ID akzeptiert MFA, die vom Verbundidentitätsanbieter ausgeführt wird. Wenn der Verbundidentitätsanbieter keine MFA ausgeführt hat, leitet er die Anforderung an den Verbundidentitätsanbieter um, um MFA auszuführen.
rejectMfaByFederatedIdp	Microsoft Entra ID führt immer MFA durch und lehnt MFA ab, die vom Verbundidentitätsanbieter ausgeführt wird.

Hinweis

federatedIdpMfaBehavior ist eine weiterentwickelte Version der SupportsMfa-Eigenschaft des PowerShell-Cmdlets Set-MsolDomainFederationSettings MSOnline v1.

Der Wechsel zwischen federatedIdpMfaBehavior und SupportsMfa wird nicht unterstützt.
Wenn die eigenschaft federatedIdpMfaBehavior festgelegt ist, ignoriert Microsoft Entra ID die Einstellung SupportsMfa.
Wenn die eigenschaft federatedIdpMfaBehavior nie festgelegt ist, berücksichtigt Microsoft Entra ID weiterhin die SupportsMfa-Einstellung.
Wenn weder federatedIdpMfaBehavior noch SupportsMfa festgelegt ist, wird Microsoft Entra ID standardmäßig auf acceptIfMfaDoneByFederatedIdp verhalten festgelegt.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.internalDomainFederation",
  "id": "String (identifier)",
  "displayName": "String",
  "issuerUri": "String",
  "metadataExchangeUri": "String",
  "signingCertificate": "String",
  "passiveSignInUri": "String",
  "preferredAuthenticationProtocol": "String",
  "activeSignInUri": "String",
  "signOutUri": "String",
  "promptLoginBehavior": "String",
  "isSignedAuthenticationRequestRequired": "Boolean",
  "nextSigningCertificate": "String",
  "signingCertificateUpdateStatus": {
    "certificateUpdateResult": "String",
    "@odata.type": "microsoft.graph.signingCertificateUpdateStatus"
  },
  "federatedIdpMfaBehavior": "String"
}

Freigeben über