Obter senhaAuthenticationMethod
Namespace: microsoft.graph
Recupere uma senha registrada em um usuário, representada por um objeto passwordAuthenticationMethod . Para segurança, a senha em si nunca será retornada no objeto e a propriedade senha é sempre null
.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA 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 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 agindo 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. |
Application | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
Para cenários delegados, o administrador precisa de pelo menos uma das seguintes funções de Microsoft Entra.
- Leitor Global
- Administrador de Autenticação
- Administrador de Autenticação Privilegiada
Administradores com funções de Administrador de Usuário, Administrador do Helpdesk ou Administrador de Senhas também podem recuperar métodos de autenticação de senha para usuários não administradores e um conjunto limitado de funções de administrador, conforme definido em Quem pode redefinir senhas.
Solicitação HTTP
Obtenha detalhes do seu próprio método de autenticação de senha.
GET /me/authentication/passwordMethods/{id}
Obtenha detalhes do seu próprio método de autenticação de senha ou de outro usuário.
GET /users/{id | userPrincipalName}/authentication/passwordMethods/{id}
Parâmetros de consulta opcionais
Esse 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. 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, esse método retornará um 200 OK
código de resposta e a senha solicitadaAuthenticationMethod 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/28c10230-6103-485e-b985-444c60001490
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/$entity",
"id": "28c10230-6103-485e-b985-444c60001490",
"password": null,
"creationDateTime": null
}
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários