Compartilhar via


authenticationMethodsPolicy resource type (Tipo de recurso authenticationMethodsPolicy)

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Define os métodos de autenticação e os utilizadores que podem utilizá-los para iniciar sessão e realizar a autenticação multifator (MFA) no Microsoft Entra ID.

Métodos

Método Tipo de retorno Descrição
Get authenticationMethodsPolicy Leia as propriedades e relações de um objeto authenticationMethodsPolicy .
Atualizar authenticationMethodsPolicy Atualize as propriedades de um objeto authenticationMethodsPolicy .

Propriedades

Propriedade Tipo Descrição
description Cadeia de caracteres Uma descrição da política.
displayName Cadeia de caracteres O nome da política.
id Cadeia de caracteres O identificador da política. Herdado da entidade.
lastModifiedDateTime DateTimeOffset A data e hora da última atualização da política.
policyVersion Cadeia de caracteres A versão da política em utilização.
policyMigrationState authenticationMethodsPolicyMigrationState O estado da migração da política de métodos de autenticação a partir das políticas de autenticação multifator legada e reposição personalizada de palavra-passe (SSPR). Os valores possíveis são:
  • premigration - significa que a política de métodos de autenticação é utilizada apenas para autenticação, as políticas legadas são respeitadas.
  • migrationInProgress - significa que a política de métodos de autenticação é utilizada para autenticação e SSPR, as políticas legadas são respeitadas.
  • migrationComplete - significa que a política de métodos de autenticação é utilizada para autenticação e SSPR, as políticas legadas são ignoradas.
  • unknownFutureValue - Valor da sentinela de enumeração evoluível. Não usar.
  • reconfirmationInDays Int32 Dias antes de ser pedido ao utilizador que reconfirme o respetivo método.
    registrationEnforcement registrationEnforcement Imponha o registo no tempo de início de sessão. Esta propriedade pode ser utilizada para lembrar os utilizadores de configurar métodos de autenticação direcionados.
    reportSuspiciousActivitySettings reportSuspiciousActivitySettings Permitir que os utilizadores comuniquem pedidos inesperados de autenticação multifator de notificação de aplicação telefónica ou chamada de voz como suspeitos.
    systemCredentialPreferences systemCredentialPreferences Pedir aos utilizadores as credenciais mais preferidas para a autenticação multifator.

    Relações

    Relação Tipo Descrição
    authenticationMethodConfigurations authenticationMethodConfiguration collection Representa as definições para cada método de autenticação. Expandida automaticamente no GET /policies/authenticationMethodsPolicy.

    Representação JSON

    A representação JSON seguinte mostra o tipo de recurso.

    {
      "@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"
      }
    }