---
sourceDocument: Brésil Sécurité de la plateforme
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/platform-security

 Release :

    - brazil

ft:locale :

    - fr-FR

ft:publication_title :

    - Brésil Sécurité de la plateforme

ft:clusterId :

    - psec

bundleId :

    - psec

workflow :

    - Platform


---

# Configurer la clé API : authentification basée sur les jetons

# Configurer la clé API : authentification basée sur les jetons {#ariaid-title1}

Rversion finale: Brazil  
Mis à jour 10 sept. 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture  
Configurez une clé API pour prendre en charge l'authentification pour les points de terminaison d'API REST.

## Avant de commencer

Rôle requis : api_service_admin, adaptive_auth_policy_admin

Module d'extension requis : clé API et authentification HMAC (<kbd class="ph userinput">com.glide.tokenbased_auth</kbd>)

## Procédure

1. Créez un profil d'authentification entrant.
   1. Accédez à TousServices web du systèmePolitiques d'accès APIProfils d'authentification entrants.
   2. Sélectionnez Nouveau.  
      Le système affiche le message Quel type de profil d'authentification ?
   3. Sélectionnez Créer des profils d'authentification de clé API.  
   4. Remplissez les champs du formulaire.  
      {#configure-api-key__table_pdg_vvm_nzb__entry__2}

      | Champ | Description |
      |-|-|
      | Nom | Nom permettant d'identifier la politique d'authentification. |
      | Application | Périmètre de la politique d'authentification. |
      | Paramètre d'authentification | Sélectionnez le paramètre d'authentification pour la demande d'authentification. Vous pouvez sélectionner les options par défaut ou créer un nouveau paramètre d'authentification : * x-sn-apikey : en-tête d'authentification * x-sn-apikey : en-tête du paramètre de requête {#configure-api-key__ul_vpl_bwm_nzb} |
      [Tableau 1. Profils d'authentification de clé API]

      {#configure-api-key__table_pdg_vvm_nzb}  
      Remarque :  
      L'option sélectionnée doit être définie dans l'appel REST dans l'en-tête d'authentification ou le paramètre de requête.  
      Remarque :  
      Pour ajouter un préfixe pour la clé API, ouvrez le fichier de paramètres d'authentification que vous avez sélectionné et spécifiez le champ Préfixe .
   5. Envoyez le formulaire.
2. Créez une clé API REST.
   1. Accédez à TousServices web du systèmePolitiques d'accès APIClé API REST.
   2. Sélectionnez Nouveau.
   3. Renseignez les champs suivants du formulaire :  
      {#configure-api-key__table_ehg_jtx_mzb__entry__2}

      | Champ | Description |
      |-|-|
      | Nom | Nom permettant d'identifier la clé API REST |
      | Description | Description de la clé API REST. |
      | Actives | État de la clé API REST. |
      | Utilisateur | Utilisateur associé à la clé API REST. Utilisez l'icône de recherche pour sélectionner l'utilisateur. |
      | Périmètre d'authentification | Option permettant d'ajouter un périmètre d'authentification pour gérer l'autorité de la clé API REST. |
      | Jeton | La clé API REST générée par le fichier Plateforme IA ServiceNow. Copiez la clé à utiliser dans le cadre de l'appel d'API REST dans le paramètre En-tête ou Requête. |
      | Expiration | Heure après laquelle les informations d'identification ne sont plus valides. Une valeur vide signifie qu'il n'y a pas d'expiration. Remarque : Pour plus d'informations sur l'expiration du jeton, reportez-vous à la section [Nettoyage en cours de l'expiration du jeton](https://servicenow-prod.fluidtopics.net/tdRRSdrQ3LqAAzYmn5oIXw "Détails sur la façon de nettoyer l’expiration du jeton à l’aide de différentes propriétés système.") . |
      [Tableau 2. Clé API]

      {#configure-api-key__table_ehg_jtx_mzb}
   4. Envoyez le formulaire.
   5. Ouvrez l'enregistrement qui a été créé pour afficher le jeton généré par Plateforme IA ServiceNow l'utilisateur.  
   {#configure-api-key__substeps_j4w_dtx_mzb}
3. Créez une politique d'accès REST API.
   1. Accédez à TousServices web du systèmePolitiques d'accès REST API.
   2. Sélectionnez Nouveau.
   3. Remplissez les champs du formulaire.  
      {#configure-api-key__table_d4x_w45_d4b__entry__2}

      | Champ | Description |
      |-|-|
      | Nom | Nom unique de la politique d'accès API. |
      | Actives | Option permettant d'activer la politique d'accès API. |
      | REST API | API REST à laquelle la politique d'accès est appliquée. Par exemple, l'API de pièce jointe. |
      | CHEMIN REST API | Chemin d'accès de l'API REST. Ce champ est rempli automatiquement en fonction de l'API REST sélectionnée. Par exemple, now/attachment. |
      | Méthode HTTP | Méthode utilisée pour interagir avec l'API. Ce champ est rempli automatiquement en fonction de l'API REST sélectionnée. |
      | Version | Version de l'API. Par exemple, v1. Ce champ est rempli automatiquement en fonction de l'API REST sélectionnée. Remarque : Pour créer une politique d'authentification pour toutes les versions d'une API REST, vous devez créer des politiques individuelles pour chaque version. |
      | Ressource | Ressource enfant de l'API REST. Ce champ est rempli automatiquement en fonction de l'API REST sélectionnée. Par exemple, /now/attachment |
      | Application | Périmètre de l'application. |
      | Global | Activez ce champ pour appliquer la politique d'authentification à toutes les méthodes, versions et ressources de l'API. Remarque : L'authentification basée sur le jeton n'est pas autorisée dans la politique API REST globale. |
      | Appliquer à toutes les méthodes | Activez ce champ pour appliquer la politique d'authentification de l'API à l'ensemble des méthodes, versions et ressources de l'API. |
      | Appliquer à toutes les ressources | Activez ce champ pour appliquer la politique d'authentification de l'API à toutes les versions. |
      | Appliquer à toutes les versions | Activez ce champ pour appliquer la politique d'authentification de l'API à toutes les ressources. |
      [Tableau 3. Politiques d'accès API]

      {#configure-api-key__table_d4x_w45_d4b}
   4. Ajoutez le profil d'authentification API qui a été créé.
   5. Envoyez le formulaire.

   {#configure-api-key__substeps_ypz_h5x_mzb}  
   Vous pouvez envoyer l'appel d'API REST avec le x-sn-apikey (jeton) qui a été généré lors Plateforme IA ServiceNow de la création de la clé API dans le paramètre En-tête ou Requête en fonction de la configuration d'authentification.  
   Avertissement :  
   Utilisez la requête POST lors de la soumission d'informations sensibles au serveur.

