Listar passwordMethods
Namespace: microsoft.graph
Obtenha uma lista das palavras-passe registadas para um utilizador, representadas por um objeto passwordAuthenticationMethod . Esta API devolve exatamente um objeto referenciado pelo ID 28c10230-6103-485e-b985-444c60001490, uma vez que um utilizador pode ter exatamente uma palavra-passe. Por motivos de segurança, a palavra-passe em si nunca é devolvida no objeto e a propriedade da palavra-passe é sempre null.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permissões
Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.
Permissões que atuam de forma autónoma
Permissões que atuam de forma autónoma
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | UserAuthenticationMethod.Read | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Aplicativo | Sem suporte. | Sem suporte. |
Permissões que atuam noutros utilizadores
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | UserAuthenticationMethod.Read.All | UserAuthenticationMethod.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | UserAuthenticationMethod.Read.All | UserAuthenticationMethod.ReadWrite.All |
Importante
Em cenários delegados com contas escolares ou profissionais, o utilizador com sessão iniciada tem de ter uma função de Microsoft Entra suportada ou uma função personalizada com uma permissão de função suportada. As seguintes funções com menos privilégios são suportadas para esta operação.
- Leitor Global
- Administrador de Autenticação
- Administrador de Autenticação Privilegiada
Os administradores com funções de Administrador de Utilizador, Administrador de Suporte Técnico ou Administrador de Palavra-passe também podem repor palavras-passe para utilizadores não administradores e um conjunto limitado de funções de administrador, conforme definido em Quem pode repor palavras-passe.
Solicitação HTTP
Obtenha detalhes do seu próprio método de autenticação por palavra-passe.
GET /me/authentication/passwordMethods
Obtenha detalhes do seu próprio método de autenticação por palavra-passe ou de outro utilizador.
GET /users/{id | userPrincipalName}/authentication/passwordMethods
Parâmetros de consulta opcionais
Este método não suporta parâmetros de consulta opcionais para personalizar a resposta.
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, este método devolve um 200 OK código de resposta e uma coleção de objetos passwordAuthenticationMethod no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/me/authentication/passwordMethods
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('67273bfa-5cd8-477a-acf7-e13ff81ebf70')/authentication/passwordMethods",
"value": [
{
"id": "28c10230-6103-485e-b985-444c60001490",
"password": null,
"createdDateTime": null
}
]
}