Criar temporárioAccessPassMethod
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 seja utilizável em seu tempo de vida especificado. Se o usuário exigir 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 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.
Permissões agindo em outros usuários
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
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 está agindo em outro usuário, o administrador precisa, pelo menos, da função Administrador de Autenticação ou Administrador de Autenticação PrivilegiadaMicrosoft Entra função.
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 propriedades opcionais que podem ser usadas ao criar o temporaryAccessPassAuthenticationMethod.
Propriedade | Tipo | Descrição |
---|---|---|
isUsableOnce | Booleano | Opcional. Determina se o passe é limitado a um uso único. Se true , o passe pode ser usado uma vez; se false , o passe poderá ser usado várias vezes na configuração lifetimeInMinutes . Um Passe de Acesso Temporário de vários usos (isUsableOnce = false ), só pode ser criado e usado para entrada se for permitido pela política de método de autenticação do Passe de Acesso Temporário. |
lifetimeInMinutes | Int32 | Opcional. O tempo de vida do temporaryAccessPass em minutos que começam na hora da criação ou no 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 Temporary Access Pass será aplicada. |
startDateTime | DateTimeOffset | Opcional. A data e a hora em que o temporaryAccessPass fica 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 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"
}
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários