homeRealmDiscoveryPolicy-Ressourcentyp

Artikel
05/24/2024

Namespace: microsoft.graph

Stellt eine Richtlinie zum Steuern Microsoft Entra Authentifizierungsverhaltens für Verbundbenutzer dar, insbesondere für Einschränkungen der automatischen Beschleunigung und Benutzerauthentifizierung in Verbunddomänen. Sie können homeRealmDiscoveryPolicy für alle Dienstprinzipale in Ihrem organization oder für bestimmte Dienstprinzipale in Ihrem organization festlegen. Weitere Szenario- und Richtliniendetails finden Sie unter Konfigurieren Microsoft Entra Anmeldeverhaltens für eine Anwendung mithilfe einer Richtlinie für die Startbereichsermittlung und Anmelden bei Microsoft Entra ID mit E-Mail als alternative Anmelde-ID.

Erbt von stsPolicy.

Methoden

Methode	Rückgabetyp	Beschreibung
List	homeRealmDiscoveryPolicy	Liest Eigenschaften und Beziehungen von homeRealmDiscoveryPolicies-Objekten.
Create	homeRealmDiscoveryPolicy	Create ein homeRealmDiscoveryPolicy-Objekt.
Get	homeRealmDiscoveryPolicy	Lesen von Eigenschaften und Beziehungen eines homeRealmDiscoveryPolicy-Objekts.
Update	Keine	Aktualisieren eines homeRealmDiscoveryPolicy-Objekts.
Delete	Keine	Löschen sie ein homeRealmDiscoveryPolicy-Objekt.
Auf Anwendungen angewendete Richtlinien auflisten	directoryObject collection	Rufen Sie die Liste der directoryObjects ab, auf die diese Richtlinie angewendet wurde.

Eigenschaften

Eigenschaft	Typ	Beschreibung
Definition	Zeichenfolgensammlung	Eine Zeichenfolgenauflistung, die eine JSON-Zeichenfolge enthält, die die Regeln und Einstellungen für diese Richtlinie definiert. Weitere Informationen zum JSON-Schema für diese Eigenschaft finden Sie unter Eigenschaften einer Richtliniendefinition für die Startbereichsermittlung . Erforderlich.
description	Zeichenfolge	Beschreibung für diese Richtlinie.
displayName	Zeichenfolge	Anzeigename für diese Richtlinie. Erforderlich.
id	Zeichenfolge	Eindeutiger Bezeichner für diese Richtlinie. Schreibgeschützt.
isOrganizationDefault	Boolesch	Wenn auf `true`festgelegt ist, wird diese Richtlinie aktiviert. Es kann viele Richtlinien für denselben Richtlinientyp geben, aber nur eine kann als organization Standard aktiviert werden. Optional, der Standardwert ist `false`.

Eigenschaften einer Richtliniendefinition für die Startbereichsermittlung

Die folgenden Eigenschaften bilden das JSON-Objekt, das eine Richtlinie für die Tokengültigkeitsdauer darstellt. Dieses JSON-Objekt muss in eine Zeichenfolge mit Escapezeichen für Anführungszeichen konvertiert werden, damit es in die Definitionseigenschaft eingefügt wird. Unten sehen Sie ein Beispiel im JSON-Format:

"definition": [
    "{
        \"HomeRealmDiscoveryPolicy\": {
          \"AccelerateToFederatedDomain\":true,
          \"AllowCloudPasswordValidation\": false,
          \"PreferredDomain\":\"federated.example.edu\",
          \"AlternateIdLogin\":{
            \"Enabled\":true
          }
        }
      }"
  ]

Eigenschaft	Typ	Beschreibung
AccelerateToFederatedDomain	Boolesch	Legen Sie für die automatische Beschleunigung auf `true` fest (Startbereichsermittlung umgehen). Wenn `true` nur eine überprüfte Verbunddomäne im Mandanten vorhanden ist, werden Die Benutzer zur Anmeldung direkt zum Verbundidentitätsanbieter (z. B. AD FS) weitergeleitet. Wenn `true` mehrere überprüfte Domänen im Mandanten vorhanden sind, muss PreferredDomain angegeben werden. Optional.
AllowCloudPasswordValidation	Boolesch	Legen Sie diese Einstellung auf `true` fest, damit eine Anwendung einen Verbundbenutzer authentifizieren kann, indem sie Anmeldeinformationen für Benutzername/Kennwort direkt an den Microsoft Entra Tokenendpunkt vorlegt. Funktioniert nur, wenn die Kennworthashsynchronisierung aktiviert ist. Optional.
AlternateIdLogin	Json	Legen Sie diesen Wert auf `{\"Enabled\": true}` fest, um Microsoft Entra Anmeldung per E-Mail als alternative Anmelde-ID zuzulassen. Funktioniert nur, wenn IsOrganizationDefault auf `true`festgelegt ist. Optional.
PreferredDomain	Zeichenfolge	Gibt eine Domäne an, bei der die Anmeldung beschleunigt werden soll. Sie kann weggelassen werden, wenn der Mandant nur über eine Verbunddomäne verfügt. Wenn sie nicht angegeben wird und mehr als eine überprüfte Verbunddomäne vorhanden ist, hat diese Richtlinie keine Auswirkung. Erforderlich, wenn AccelerateToFederatedDomain ist `true`.

Beziehungen

Beziehung	Typ	Beschreibung
Appliesto	directoryObject collection	Die directoryObject-Auflistung , auf die diese Richtlinie angewendet wurde. Schreibgeschützt.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "definition": ["String"],
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "isOrganizationDefault": true
}

Freigeben über