tipo de recurso tokenLifetimePolicy

  • Artigo

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 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 por Microsoft Entra ID. Você pode definir o tempo de vida do token para todos os aplicativos em sua organização, para um aplicativo multilocatário ou para uma entidade de serviço específica em sua organização. Para obter mais detalhes do cenário, confira Tempo de vida do token configurável no plataforma de identidade da Microsoft.

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
Listar tokenLifetimePolicies tokenLifetimePolicy Leia propriedades e relações de objetos tokenLifetimePolicies.
Criar tokenLifetimePolicy tokenLifetimePolicy Crie um objeto tokenLifetimePolicy.
Obter tokenLifetimePolicy tokenLifetimePolicy Leia propriedades e relações de um objeto tokenLifetimePolicy.
Atualizar tokenLifetimePolicy Nenhum Atualize um objeto tokenLifetimePolicy.
Excluir tokenLifetimePolicy Nenhum Excluir um objeto tokenLifetimePolicy.
Lista appliesTo Coleção directoryObject Obtenha a lista de diretórios aos quais essa política foi aplicada.

Propriedades

Propriedade Tipo Descrição
id Cadeia de caracteres Identificador exclusivo para essa política. Somente leitura.
Definição String collection 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. Para obter mais informações sobre o esquema JSON dessa propriedade, consulte Propriedades de uma definição de política de tempo de vida do token. Obrigatório.
displayName Cadeia de caracteres Nome de exibição para essa 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 tempo de vida do token

O objeto JSON a seguir mostra as propriedades em uma propriedade de definição de política de tempo de vida do token. Esse objeto JSON deve ser convertido em uma cadeia de caracteres com aspas escapadas para serem inseridas na propriedade de definição , conforme mostrado no exemplo.

"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". Os valores máximos para propriedades denotadas em "dias" são 1 segundo a menos do número de dias denotados. Por exemplo, o valor máximo de 1 dia é especificado como "23:59:59".

Propriedade Tipo Descrição Valor Min Valor máximo Valor padrão
AccessTokenLifetime Cadeia de caracteres Controla quanto tempo os tokens de acesso e ID são considerados válidos. 10 minutos 1 dia 1 hora
Versão Número inteiro Defina 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

A representação JSON a seguir mostra o tipo de recurso.

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