Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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"
}