Tipo de recurso tokenLifetimePolicy

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 de versão.

Representa uma política que pode controlar o tempo de vida de um token de acesso JWT, um token de ID ou um token SAML 1.1/2.0 emitido pelo Azure Active Directory (Azure AD). É possível definir tempos de vida do token para todos os aplicativos em sua organização, para um aplicativo multilocatário (organização múltipla) ou para uma entidade de serviço específica em sua organização. Para obter mais detalhes do cenário, consulte Tempo de vida útil do token configurável no Azure Active Directory.

Observação: Não há suporte para configurar essa política para Tokens de Atualização e Tokens de Sessão.

Herda de stsPolicy.

Métodos

Método	Tipo de retorno	Descrição
Criar tokenLifetimePolicy	tokenLifetimePolicy	Crie um objeto tokenLifetimePolicy.
Obter tokenLifetimePolicy	tokenLifetimePolicy	Ler propriedades e relações de um objeto tokenLifetimePolicy.
Listar tokenLifetimePolicies	tokenLifetimePolicy	Leia propriedades e relações de objetos tokenLifetimePolicies.
Atualizar tokenLifetimePolicy	Nenhum	Atualize um objeto tokenLifetimePolicy.
Excluir tokenLifetimePolicy	Nenhum	Exclua um objeto tokenLifetimePolicy.
Lista appliesTo	Coleção directoryObject	Obter a lista de directoryObjects aos qual essa política foi aplicada.
Atribiur tokenLifetimePolicy	Nenhum	Atribua um objeto tokenLifetimePolicy a um aplicativo ou objeto servicePrincipal.
Listar token atribuídoLifetimePolicy	Conjunto tokenLifetimePolicy	Listar os objetos tokenLifetimePolicy atribuídos a um aplicativo ou objeto servicePrincipal.
Remover tokenLifetimePolicy	Nenhum	Remova um objeto tokenLifetimePolicy de um aplicativo ou objeto servicePrincipal.

Propriedades

Propriedade	Tipo	Descrição
id	Cadeia de caracteres	Identificador exclusivo dessa política. Somente leitura.
definition	Coleção de cadeias de caracteres	Uma coleção de cadeias de caracteres que contém uma cadeia de caracteres JSON que define as regras e as configurações dessa política. Consulte abaixo para obter mais detalhes sobre o esquema JSON para esta propriedade. Obrigatório.
description	Cadeia de caracteres	Descrição dessa política.
displayName	Cadeia de caracteres	Nome de exibição para esta política. Obrigatório.
isOrganizationDefault	Booliano	Se definido como true , ativa essa política. Pode haver muitas políticas para o mesmo tipo de política, mas apenas uma pode ser ativada como o padrão da organização. Opcional, o valor padrão é false .

Propriedades de uma definição de política de vida útil do token

As propriedades abaixo formam o objeto JSON que representa uma política de vida útil do token. Esse objeto JSON deve ser convertido em uma cadeia de caracteres com aspas que escapam para serem inseridas na propriedade definition. Um exemplo é mostrado abaixo no formato JSON:

"definition": [
    "{\"TokenLifetimePolicy\":{\"Version\":1,\"AccessTokenLifetime\":\"8:00:00\"}}"
  ]

Observação: todas as durações de tempo nessas propriedades são especificadas no formato "dd.hh:mm:ss".

Observação: os valores máximos para propriedades anotadas em "dias" são 1 segundo a menos do número de dias anotado. Por exemplo, o valor máximo de 1 dia é especificado como "23:59:59".

Propriedade	Tipo	Descrição	Valor Mínimo	Valor Máximo	Valor padrão
AccessTokenLifetime	Cadeia de caracteres	Controla por quanto tempo os tokens de acesso e ID são considerados válidos.	10 minutos	1 dia	1 hora
Versão	Inteiro	Definir o valor de 1. Obrigatório.	Nenhum	Nenhum	Nenhum

Relações

Relação	Tipo	Descrição
appliesTo	Coleção directoryObject	A coleção directoryObject à qual essa política foi aplicada. Somente leitura.

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "definition": ["String"],
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "isOrganizationDefault": true,
}