Тип ресурса authenticationMethodsPolicy

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Определяет методы проверки подлинности и пользователей, которым разрешено использовать их для входа и выполнения многофакторной проверки подлинности (MFA) в Microsoft Entra ID.

Методы

Метод Тип возвращаемых данных Описание
Получение authenticationMethodsPolicy authenticationMethodsPolicy Чтение свойств и связей объекта authenticationMethodsPolicy .
Обновление authenticationMethodsPolicy authenticationMethodsPolicy Обновите свойства объекта authenticationMethodsPolicy .

Свойства

Свойство Тип Описание
description String Описание политики.
displayName String Имя политики.
id String Идентификатор политики. Наследуется от сущности.
lastModifiedDateTime DateTimeOffset Дата и время последнего обновления политики.
policyVersion String Используемая версия политики.
policyMigrationState authenticationMethodsPolicyMigrationState Состояние миграции политики методов проверки подлинности из устаревших политик многофакторной проверки подлинности и самостоятельного сброса пароля (SSPR). Возможные значения:
  • premigration — означает, что политика методов проверки подлинности используется только для проверки подлинности, при этом соблюдаются устаревшие политики.
  • migrationInProgress — означает, что политика методов проверки подлинности используется как для проверки подлинности, так и для SSPR, соблюдаются устаревшие политики.
  • migrationComplete — означает, что политика методов проверки подлинности используется для проверки подлинности и SSPR, устаревшие политики игнорируются.
  • unknownFutureValue — изменяемое значение перечисления sentinel. Не используйте.
  • reconfirmationInDays Int32 За несколько дней до того, как пользователю будет предложено повторно подтвердить свой метод.
    registrationEnforcement registrationEnforcement Принудительное выполнение регистрации во время входа. Это свойство можно использовать для напоминая пользователям о необходимости настройки целевых методов проверки подлинности.
    reportSuspiciousActivitySettings reportSuspiciousActivitySettings Разрешить пользователям сообщать о непредвиденных голосовых звонках или уведомлениях приложения для многофакторной проверки подлинности как о подозрительных.
    systemCredentialPreferences systemCredentialPreferences Запрашивайте у пользователей наиболее предпочтительные учетные данные для многофакторной проверки подлинности.

    Связи

    Связь Тип Описание
    authenticationMethodConfigurations Коллекция authenticationMethodConfiguration Представляет параметры для каждого метода проверки подлинности. Автоматически расширяется в GET /policies/authenticationMethodsPolicy.

    Представление JSON

    В следующем представлении JSON показан тип ресурса.

    {
      "@odata.type": "#microsoft.graph.authenticationMethodsPolicy",
      "description": "String",
      "displayName": "String",
      "id": "String (identifier)",
      "lastModifiedDateTime": "String (timestamp)",
      "policyVersion": "String",
      "registrationEnforcement": {
        "@odata.type": "microsoft.graph.registrationEnforcement"
      },
        "reportSuspiciousActivitySettings": {
        "@odata.type": "microsoft.graph.reportSuspiciousActivitySettings"
      },
      "systemCredentialPreferences": {
        "@odata.type": "microsoft.graph.systemCredentialPreferences"
      }
    }