Métodos de List

Namespace: microsoft.graph

Recuperar uma lista de objetos authenticationMethod . Essa API retorna apenas os métodos de autenticação suportados nesta versão da API. Consulte Azure AD authentication methods API overview for a list of currently supported methods.

Permissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Permissões agindo em si mesmo

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	UserAuthenticationMethod.Read, UserAuthenticationMethod.ReadWrite
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	Sem suporte.

Permissões atuando em outros usuários

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All

Para cenários delegados em que um administrador está atuando em outro usuário, o administrador precisa de uma das seguintes funções do Azure AD:

• Administrador global
• Leitor global
• Administrador de autenticação privilegiada
• Administrador de autenticação (só vê números de telefone mascarados)

Solicitação HTTP

GET /me/authentication/methods
GET /users/{id | userPrincipalName}/authentication/methods

Parâmetros de consulta opcionais

Este método não dá suporte a parâmetros de consulta opcionais para personalizar a resposta.

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se tiver êxito, este método retornará um 200 OK código de resposta e uma coleção de objetos authenticationMethod no corpo da resposta.

Exemplos

Solicitação

Este é um exemplo de solicitação.

GET https://graph.microsoft.com/v1.0/me/authentication/methods

Resposta

Este é um exemplo de resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.fido2AuthenticationMethod",
      "id": "-2_GRUg2-HYz6_1YG4YRAQ2",
      "displayName": "Red key",
      "creationDateTime": "2020-08-10T06:44:09Z",
      "aaGuid": "2fc0579f-8113-47ea-b116-555a8db9202a",
      "model": "NFC key",
      "attestationCertificates": [
          "dbe793efdf1945e2df25d93653a1e8a3268a9075"
      ],
      "attestationLevel": "attested"
    },
    {
    "@odata.type": "#microsoft.graph.windowsHelloForBusinessAuthenticationMethod",
    "id": "b5e01f81-1f81-b5e0-811f-e0b5811fe0b5",
    "displayName": "Jordan's Surface Book",
    "createdDateTime": "2020-11-27T23:12:49Z",
    "keyStrength": "normal"
    }
  ]
}