Criar temporaryAccessPassMethod

Namespace: microsoft.graph

Crie um novo objeto temporaryAccessPassAuthenticationMethod num utilizador. Um utilizador só pode ter um Passe de Acesso Temporário que possa ser utilizado durante a duração especificada. Se o utilizador precisar de um novo Passe de Acesso Temporário enquanto o Passe de Acesso Temporário atual for válido, o administrador pode criar um novo Passe de Acesso Temporário para o utilizador, o Passe de Acesso Temporário anterior será eliminado e será criado um novo Passe de Acesso Temporário.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

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.

Permissões que atuam noutros utilizadores

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

Para cenários delegados em que um administrador aja com outro utilizador, o administrador precisa, pelo menos, da função Administrador de Autenticação ou Administrador de Autenticação PrivilegiadaMicrosoft Entra.

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 do pedido, forneça uma representação JSON do objeto temporaryAccessPassAuthenticationMethod .

A tabela seguinte descreve as propriedades opcionais que podem ser utilizadas ao criar o temporaryAccessPassAuthenticationMethod.

Propriedade Tipo Descrição
isUsableOnce Booleano Opcional. Determina se o passe está limitado a uma utilização única. Se true, o passe pode ser utilizado uma vez; se false, o passe pode ser utilizado várias vezes dentro da definição lifetimeInMinutes . Um Passe de Acesso Temporário multiuso (isUsableOnce = false), só pode ser criado e utilizado para iniciar sessão se for permitido pela política de método de autenticação Passe de Acesso Temporário.
lifetimeInMinutes Int32 Opcional. A duração do temporaryAccessPass em minutos a partir da hora de criação ou em startDateTime, se definido. Tem de estar entre 10 e 43200 (o equivalente a 30 dias). Se não for especificado, é aplicada a predefiniçãoLifetimeInMinutes na política de método de autenticação Passe de Acesso Temporário .
startDateTime DateTimeOffset Opcional. A data e hora em que o temporaryAccessPass fica disponível para utilização. Se não for especificado, o Passe de Acesso Temporário está disponível para utilização imediatamente após a sua criação.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto temporaryAccessPassAuthenticationMethod 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"
}