Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.
Obtenha uma lista dos métodos de autenticação registrados para um usuário, conforme definido no objeto userRegistrationDetails . Esse método não funciona para usuários desabilitados.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | AuditLog.Read.All | Indisponível. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Aplicativo | AuditLog.Read.All | Indisponível. |
Importante
Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve ser proprietário ou membro do grupo ou ser atribuído a uma função do Microsoft Entra com suporte ou uma função personalizada que conceda as permissões necessárias para esta operação. Esta operação dá suporte às seguintes funções internas, que fornecem apenas o menor privilégio necessário:
- Leitor de Relatórios
- Leitor de segurança
- Administrador de Segurança
- Leitor Global
Solicitação HTTP
GET /reports/authenticationMethods/userRegistrationDetails
Parâmetros de consulta opcionais
Esse método dá suporte $filter ao parâmetro de consulta OData para ajudar a personalizar a resposta. Você pode aplicar $filter em uma ou mais das seguintes propriedades do recurso userRegistrationDetails .
| Propriedade | Descrição | Exemplo |
|---|---|---|
| isMfaCapable | Filtre os usuários que estão prontos para executar a redefinição de senha ou a autenticação multifator (MFA). Operadores de filtro compatíveis: eq. |
/reports/authenticationMethods/userRegistrationDetails?$filter=isMfaCapable eq true |
| isMfaRegistered | Filtro para usuários registrados para MFA. Os operadores de filtro com suporte são: eq. |
/reports/authenticationMethods/userRegistrationDetails?$filter=isMfaRegistered eq true |
| isSsprEnabled | Filtro para os usuários que foram habilitados para a SSPR. Os operadores de filtro com suporte são: eq. |
/reports/authenticationMethods/userRegistrationDetails?$filter=isSsprEnabled eq true. |
| isSsprRegistered | Filtro para usuários que se registraram para redefinição de senha por autoatendimento (SSPR). Os operadores de filtro com suporte são: eq. |
/reports/authenticationMethods/userRegistrationDetails?$filter=isSsprRegistered eq true |
| methodsRegistered | Filtre pelos métodos de autenticação usados durante o registro. Os operadores de filtro com suporte são: eq. |
/reports/authenticationMethods/userRegistrationDetails?$filter=methodsRegistered/any(x:x eq 'email') |
| userDisplayName | Filtrar por nome de usuário. Os operadores de filtro com suporte são: eq e startswith(). Dá suporte a não diferenciar maiúsculas de minúsculas. |
/reports/authenticationMethods/userRegistrationDetails?$filter=userDisplayName eq 'Contoso' |
| userPrincipalName | Filtrar por nome UPN. Os operadores de filtro com suporte são: eq e startswith(). Dá suporte a não diferenciar maiúsculas de minúsculas. |
/reports/authenticationMethods/userRegistrationDetails?$filter=userPrincipalName eq 'Contoso' |
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 uma coleção de objetos userRegistrationDetails no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/reports/authenticationMethods/userRegistrationDetails
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/beta/$metadata#reports/authenticationMethods/userRegistrationDetails",
"value": [
{
"id": "86462606-fde0-4fc4-9e0c-a20eb73e54c6",
"userPrincipalName": "AlexW@Contoso.com",
"userDisplayName": "Alex Wilber",
"isAdmin": false,
"isSsprRegistered": false,
"isSsprEnabled": false,
"isSsprCapable": false,
"isMfaRegistered": true,
"isMfaCapable": true,
"isPasswordlessCapable": false,
"lastUpdatedDateTime": "2023-03-13T19:15:41.6195833Z",
"methodsRegistered": [
"microsoftAuthenticatorPush",
"softwareOneTimePasscode"
],
"defaultMfaMethod": "microsoftAuthenticatorPush",
"isSystemPreferredAuthenticationMethodEnabled": true,
"systemPreferredAuthenticationMethods": [
"push"
],
"userPreferredMethodForSecondaryAuthentication": "push",
"userType": "member"
},
{
"id": "c6ad1942-4afa-47f8-8d48-afb5d8d69d2f",
"userPrincipalName": "AllanD@Contoso.com",
"userDisplayName": "Allan Deyoung",
"isAdmin": false,
"isSsprRegistered": false,
"isSsprEnabled": false,
"isSsprCapable": false,
"isMfaRegistered": false,
"isMfaCapable": false,
"isPasswordlessCapable": false,
"lastUpdatedDateTime": "2023-03-13T19:15:41.6195833Z",
"methodsRegistered": [],
"defaultMfaMethod": "",
"isSystemPreferredAuthenticationMethodEnabled": true,
"systemPreferredAuthenticationMethods": [],
"userPreferredMethodForSecondaryAuthentication": "",
"userType": "guest"
},
{
"id": "c8096958-797c-44fa-8fde-a6fb62567cf0",
"userPrincipalName": "BiancaP@Contoso.com",
"userDisplayName": "Bianca Pisani",
"isAdmin": false,
"isSsprRegistered": true,
"isSsprEnabled": false,
"isSsprCapable": false,
"isMfaRegistered": true,
"isMfaCapable": true,
"isPasswordlessCapable": false,
"lastUpdatedDateTime": "2023-03-13T19:15:41.6195833Z",
"methodsRegistered": [
"mobilePhone",
"microsoftAuthenticatorPush",
"softwareOneTimePasscode"
],
"defaultMfaMethod": "mobilePhone",
"isSystemPreferredAuthenticationMethodEnabled": true,
"systemPreferredAuthenticationMethods": [
"push"
],
"userPreferredMethodForSecondaryAuthentication": "voiceMobile",
"userType": "member"
}
]
}