Compartilhar via

phoneAuthenticationMethod: enableSmsSignIn

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.

Ative o início de sessão por SMS para um número de telefone existente mobile . Para ser ativado com êxito:

  • O telefone tem de ter "phoneType": "mobile".
  • O telefone tem de ser exclusivo no sistema de início de sessão por SMS (mais ninguém pode utilizar esse número).
  • O utilizador tem de estar ativado para o início de sessão por SMS na política de métodos de autenticação .

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) UserAuthMethod-Phone.ReadWrite UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.ReadWrite.All, UserAuthMethod-Phone.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application UserAuthMethod-Phone.ReadWrite.All UserAuthenticationMethod.ReadWrite.All

Importante

Em cenários delegados com contas escolares ou profissionais em que o utilizador com sessão iniciada está a agir sobre outro utilizador, tem de lhes ser atribuída 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.

  • Administrador de Autenticação
  • Administrador de Autenticação Privilegiada

Solicitação HTTP

Ative o início de sessão por SMS para o seu próprio método de autenticação de telemóvel.

Observação

Chamar o ponto de extremidade /me exige um usuário conectado e, portanto, uma permissão delegada. As permissões de aplicação não são suportadas ao utilizar o /me ponto final.

POST /me/authentication/phoneMethods/{id}/enableSmsSignIn

Ative o início de sessão por SMS para o seu próprio método de autenticação de telemóvel ou de outro utilizador.

Observação

Ao chamar o /users/{id} ponto final com {id} a representação do utilizador com sessão iniciada, as permissões delegadas com menos privilégios são UserAuthenticationMethod.Read para operações de leitura e UserAuthenticationMethod.ReadWrite para operações de escrita.

POST /users/{id | userPrincipalName}/authentication/phoneMethods/{id}/enableSmsSignIn

O valor de id para phoneType mobile é 3179e48a-750b-4051-897c-87b9720928f7.

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 tiver êxito, este método retornará um código de resposta 200 OK. Não devolve nada no corpo da resposta.

Exemplos

O exemplo a seguir mostra como chamar essa API.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/me/authentication/phoneMethods/3179e48a-750b-4051-897c-87b9720928f7/enableSmsSignIn

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 OK
  • Last updated on