Create temporaryAccessPassMethod

Namespace: microsoft.graph

Crie um novo objeto temporaryAccessPassAuthenticationMethod em um usuário. Um usuário só pode ter um Passe de Acesso Temporário que possa ser usado durante o tempo de vida especificado. Se o usuário precisar de um novo Passe de Acesso Temporário enquanto o Passe de Acesso Temporário atual for válido, o administrador poderá criar um novo Passe de Acesso Temporário para o usuário, o Passe de Acesso Temporário anterior será excluído e um novo Passe de Acesso Temporário será criado.

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) UserAuthMethod-TAP.Read UserAuthenticationMethod.ReadWrite.All, UserAuthenticationMethod.Read, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite, UserAuthMethod-TAP.Read.All, UserAuthMethod-TAP.ReadWrite, UserAuthMethod-TAP.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application UserAuthMethod-TAP.Read.All UserAuthenticationMethod.ReadWrite.All, UserAuthenticationMethod.Read.All, UserAuthMethod-TAP.ReadWrite.All

Importante

Para acesso delegado usando contas corporativas ou de estudante em que o usuário conectado está agindo sobre outro usuário, ele deve receber 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:

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

Quando os usuários gerenciam seus próprios métodos de autenticação, o sistema solicita que eles concluam a autenticação multifator (MFA) se eles foram autenticados pela última vez há mais de 10 minutos na sessão atual.

Solicitação HTTP

POST /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto temporaryAccessPassAuthenticationMethod .

A tabela a seguir descreve as propriedades opcionais que podem ser usadas ao criar o temporaryAccessPassAuthenticationMethod.

Propriedade Tipo Descrição
isUsableOnce Booleano Opcional. Determina se a aprovação está limitada a um uso único. Se true, a senha pode ser usada uma vez; se false, a senha pode ser usada várias vezes em sua configuração lifetimeInMinutes . Um Passe de Acesso Temporário multiuso (isUsableOnce = false), só poderá ser criado e usado para entrada se ele for permitido pela política do método de autenticação do Passe de Acesso Temporário.
lifetimeInMinutes Int32 Opcional. O tempo de vida do temporaryAccessPass em minutos a partir da hora da criação ou em startDateTime, se definido. Deve estar entre 10 e 43200 (equivalente a 30 dias). Se não for especificado, a configuração defaultLifetimeInMinutes na política de método de autenticação do Passe de Acesso Temporário será aplicada.
startDateTime DateTimeOffset Opcional. A data e a hora em que o temporaryAccessPass estará disponível para uso. Se não for especificado, o Passe de Acesso Temporário estará disponível para uso imediatamente após sua criação.

Resposta

Se for bem-sucedido, esse método retornará um código de 201 Created resposta e um objeto temporárioAccessPassAuthenticationMethod no corpo da resposta.

Exemplos

Solicitação

POST https://graph.microsoft.com/v1.0/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods
Content-Type: application/json

{
    "startDateTime": "2022-06-05T00:00:00.000Z",
    "lifetimeInMinutes": 60,
    "isUsableOnce": false
}

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
    "id": "6f1967b7-15e8-4935-ac26-d50770ed07a7",
    "temporaryAccessPass": "+drkzqAD",
    "createdDateTime": "2022-06-02T16:21:09.765173Z",
    "startDateTime": "2022-06-05T00:00:00Z",
    "lifetimeInMinutes": 60,
    "isUsableOnce": false,
    "isUsable": false,
    "methodUsabilityReason": "NotYetValid"
}