emailAuthenticationMethodConfiguration-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt die Authentifizierungsmethode für E-Mail-Einmalkennung (One-Time Passcode, OTP) dieses Mandanten dar. Richtlinien für Authentifizierungsmethoden definieren Konfigurationseinstellungen und Benutzer oder Gruppen, die für die Verwendung der Authentifizierungsmethode aktiviert sind. Die cloudnativen Benutzer des Mandanten können E-Mail-OTP für die Self-Service-Kennwortzurücksetzung verwenden. Externe Benutzer können E-Mail-OTP für die Authentifizierung während der Einlösung von Einladungen und der Self-Service-Registrierung für bestimmte Apps in Benutzerflows verwenden.

Erbt von authenticationMethodConfiguration.

Methoden

Methode	Rückgabetyp	Beschreibung
Get	emailAuthenticationMethodConfiguration	Liest die Eigenschaften und Beziehungen eines emailAuthenticationMethodConfiguration-Objekts.
Update	Keine	Aktualisieren Sie die Eigenschaften eines emailAuthenticationMethodConfiguration-Objekts.
Löschen	Keine	Setzt das emailAuthenticationMethodConfiguration-Objekt auf seine Standardkonfiguration zurück.

Eigenschaften

Eigenschaft	Typ	Beschreibung
allowExternalIdToUseEmailOtp	externalEmailOtpState	Bestimmt, ob E-Mail-OTP von externen Benutzern für die Authentifizierung verwendet werden kann. Mögliche Werte sind: default, enabled, disabled, unknownFutureValue. Mandanten im default Zustand, die die Beta-API nicht verwendet haben, haben ab Oktober 2021 automatisch E-Mail-OTP aktiviert.
excludeTargets	excludeTarget-Sammlung	Gruppen von Benutzern, die von der Richtlinie ausgeschlossen sind.
id	Zeichenfolge	Der Richtlinienbezeichner für die Authentifizierungsmethode. Geerbt von authenticationMethodConfiguration.
state	authenticationMethodState	Gibt an, ob diese Authentifizierungsmethode aktiviert ist. Die möglichen Werte sind: enabled, disabled.

Beziehungen

Beziehung	Typ	Beschreibung
includeTargets	authenticationMethodTarget-Sammlung	Eine Sammlung von Gruppen, für die die Verwendung der Authentifizierungsmethode aktiviert ist.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.emailAuthenticationMethodConfiguration",
  "allowExternalIdToUseEmailOtp": "String",
    "excludeTargets": [
    {
      "@odata.type": "microsoft.graph.excludeTarget"
    }
  ],
  "id": "String (identifier)",
  "includeTargets": [ { "@odata.type": "microsoft.graph.authenticationMethodTarget" } ],
  "state": "String"
}