Type de ressource tokenLifetimePolicy

Article
05/24/2024

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente une stratégie qui peut contrôler la durée de vie d’un jeton d’accès JWT, d’un jeton d’ID ou d’un jeton SAML 1.1/2.0 émis par Microsoft Entra ID. Vous pouvez définir des durées de vie de jeton pour toutes les applications de votre organization, pour une application multilocataire ou pour un principal de service spécifique dans votre organization. Pour plus d’informations sur le scénario, consultez Durées de vie des jetons configurables dans le Plateforme d'identités Microsoft.

La configuration de cette stratégie pour les jetons d’actualisation et les jetons de session n’est pas prise en charge.

Hérite de stsPolicy.

Méthodes

Méthode	Type renvoyé	Description
List	tokenLifetimePolicy	Lit les propriétés et les relations des objets tokenLifetimePolicies.
Create	tokenLifetimePolicy	Create un objet tokenLifetimePolicy.
Obtenir	tokenLifetimePolicy	Lit les propriétés et les relations d’un objet tokenLifetimePolicy.
Mettre à jour	Aucun	Mettre à jour un objet tokenLifetimePolicy.
Supprimer	Aucune	Supprime un objet tokenLifetimePolicy.
Lister les stratégies appliquées à des applications	collection directoryObject	Obtenez la liste des directoryObjects auxquels cette stratégie a été appliquée.

Propriétés

Propriété	Type	Description
id	Chaîne	Identificateur unique pour cette stratégie. En lecture seule.
Définition	Collection de chaînes	Collection de chaînes contenant une chaîne JSON qui définit les règles et les paramètres de cette stratégie. Pour plus d’informations sur le schéma JSON de cette propriété, consultez Propriétés d’une définition de stratégie de durée de vie de jeton. Obligatoire.
displayName	Chaîne	Nom d’affichage de cette stratégie. Obligatoire.
isOrganizationDefault	Valeur booléenne	Si la valeur `true`est définie sur , active cette stratégie. Il peut y avoir plusieurs stratégies pour le même type de stratégie, mais une seule peut être activée comme organization valeur par défaut. Facultatif, la valeur par défaut est `false`.

Propriétés d’une définition de stratégie de durée de vie des jetons

L’objet JSON suivant affiche les propriétés d’une propriété de définition de stratégie de durée de vie de jeton. Cet objet JSON doit être converti en chaîne avec des guillemets placés dans une séquence d’échappement pour être inséré dans la propriété de définition , comme illustré dans l’exemple.

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

Remarque

Toutes les durées de ces propriétés sont spécifiées au format « dd.hh :mm :ss ». Les valeurs maximales des propriétés indiquées en « jours » sont inférieures d’une seconde au nombre de jours indiqué. Par exemple, la valeur maximale de 1 jour est spécifiée comme « 23 :59 :59 ».

Propriété	Type	Description	Valeur minimale	Valeur maximale	Valeur par défaut
AccessTokenLifetime	Chaîne	Contrôle la durée pendant laquelle les jetons d’accès et d’ID sont considérés comme valides.	10 minutes	1 jour	1 heure
Version	Entier	Définissez la valeur 1. Obligatoire.	Aucun	Aucun	Aucun

Relations

Relation	Type	Description
appliesTo	collection directoryObject	Collection directoryObject à laquelle cette stratégie a été appliquée. En lecture seule.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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

Partager via