Autenticação de listaMethodModes
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 de todos os métodos de autenticação com suporte ou todas as combinações de método de autenticação com suporte como uma lista de objetos authenticationMethodModes e suas propriedades.
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
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas |
---|---|---|
Delegada (conta corporativa ou de estudante) | Policy.Read.All | Policy.ReadWrite.AuthenticationMethod, Policy.ReadWrite.ConditionalAccess |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Policy.Read.All | Policy.ReadWrite.AuthenticationMethod, Policy.ReadWrite.ConditionalAccess |
Para cenários delegados, o usuário chamador também deve receber pelo menos uma das seguintes funções de Microsoft Entra:
- Administrador de Acesso Condicional
- Administrador de Segurança
- Leitor de Segurança
Solicitação HTTP
Recupere a coleção de objetos authenticationMethodModes e suas descrições.
GET /identity/conditionalAccess/authenticationStrength/authenticationMethodModes
Recupere a coleção plana de objetos authenticationCombinations, representando todas as combinações permitidas (allowedCombinations) em um objeto authenticationStrengthPolicy.
GET /identity/conditionalAccess/authenticationStrength/combinations
Parâmetros de consulta opcionais
Esse método não dá suporte a parâmetros de consulta OData.
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 authenticationMethodModeDetail no corpo da resposta.
Exemplos
Exemplo 1: recuperar objetos authenticationMethodModes e suas descrições
Solicitação
O exemplo a seguir mostra uma solicitação para recuperar a coleção de objetos authenticationMethodModes e suas descrições.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrength/authenticationMethodModes
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#authenticationMethodModeDetail",
"value": [
{
"id" : "password",
"displayName" : "Password",
"authenticationMethod" : "password"
},
{
"id" : "voice",
"displayName" : "Voice",
"authenticationMethod" : "voice"
},
{
"id" : "softwareOath",
"displayName" : "Software OATH tokens",
"authenticationMethod" : "softwareOath"
},
{
"id" : "sms",
"displayName" : "SMS",
"authenticationMethod" : "sms"
},
{
"id" : "fido2",
"displayName" : "FIDO2 Security Key",
"authenticationMethod" : "fido2"
},
{
"id" : "windowsHelloForBusiness",
"displayName" : "Windows Hello for Business",
"authenticationMethod" : "windowsHelloForBusiness"
},
{
"id" : "microsoftAuthenticatorPush",
"displayName" : "Microsoft Authenticator (push notification)",
"authenticationMethod" : "microsoftAuthenticator"
},
{
"id" : "deviceBasedPush",
"displayName" : "Microsoft Authenticator (Passwordless)",
"authenticationMethod" : "microsoftAuthenticator"
},
{
"id" : "temporaryAccessPassOneTime",
"displayName" : "Temporary Access Pass (one-time use)",
"authenticationMethod" : "temporaryAccessPass"
},
{
"id" : "temporaryAccessPassMultiUse",
"displayName" : "Temporary Access Pass (multi-use)",
"authenticationMethod" : "temporaryAccessPass"
},
{
"id" : "email",
"displayName" : "Email one-time passcode",
"authenticationMethod" : "email"
},
{
"id" : "x509CertificateSingleFactor",
"displayName" : "Certificate-based authentication (single-factor)",
"authenticationMethod" : "x509Certificate"
},
{
"id" : "federatedMultiFactor",
"displayName" : "Federation (multifactor)",
"authenticationMethod" : "federation"
},
{
"id" : "federatedSingleFactor",
"displayName" : "Federation (single-factor)",
"authenticationMethod" : "federation"
},
{
"id": "x509CertificateMultiFactor",
"displayName" : "Certificate-based authentication (multifactor)",
"authenticationMethod" : "x509Certificate"
}
]
}
Exemplo 2: recuperar as combinações de autenticação permitidas
Solicitação
O exemplo a seguir mostra uma solicitação para recuperar a coleção plana de objetos authenticationCombinations, representando todas as combinações permitidas possíveis (allowedCombinations) que podem ser usadas em um objeto authenticationStrengthPolicy.
GET https://graph.microsoft.com/beta/identity/conditionalAccess/authenticationStrength/combinations
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#identity/conditionalAccess/authenticationStrength/combinations",
"value": [
"windowsHelloForBusiness",
"fido2",
"x509CertificateMultiFactor",
"deviceBasedPush",
"temporaryAccessPassOneTime",
"temporaryAccessPassMultiUse",
"password,microsoftAuthenticatorPush",
"password,softwareOath",
"password,hardwareOath",
"password,sms",
"password,voice",
"federatedMultiFactor",
"microsoftAuthenticatorPush,federatedSingleFactor",
"softwareOath,federatedSingleFactor",
"hardwareOath,federatedSingleFactor",
"sms,federatedSingleFactor",
"voice,federatedSingleFactor",
"x509CertificateSingleFactor",
"sms",
"password",
"federatedSingleFactor",
"email"
]
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de