---
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 l'authentification basée sur un jeton HMAC

# Configurer l'authentification basée sur un jeton HMAC {#ariaid-title1}

Rversion finale: Brazil  
Mis à jour 10 sept. 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture  
Configurez HMAC 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 (com.glide.tokenbased_auth)  
Remarque :  
Lors de la configuration du HMAC, assurez-vous que le nom du script qui commence par HMAC est renseigné dans la vue de liste des scripts.

## Procédure

1. Créez une configuration HMAC.
   1. Accédez à TousServices web du systèmePolitiques d'accès APIHMAC Configuration.
   2. Sélectionnez Nouveau.  
      Remarque :  
      Vous pouvez également utiliser l'encodage HMAC SHA256 Base64 par défaut créé lors de l'installation du module d'extension.
   3. Renseignez les champs suivants du formulaire :  
      {#configure-hmac__table_y3b_h1f_nzb__entry__2}

      | Champ | Description |
      |-|-|
      | Nom | Nom de la configuration HMAC. |
      | Application | Périmètre de la configuration. |
      | Description | Description détaillée de la configuration. |
      | Algorithme de hachage | L'algorithme de hachage à utiliser. Options disponibles : * HmacSHA256 * HmacSHA384 * HmacSHA512 {#configure-hmac__ul_llc_4vs_pzb} Remarque : À partir de la version Yokohama, les algorithmes de hachage faibles ne sont pas pris en charge. Utilisez HmacSHA256 ou un algorithme plus puissant. |
      | Script d'utilitaire HMAC | Script utilitaire pour HMAC. Remarque : Si vous validez l'authentification HMAC à l'aide du corps de la demande, de l'horodatage et du secret sans ID de clé, procédez comme suit : * Créer un include de script personnalisé en tant que script d'utilitaire HMAC * Utilisez cet utilitaire d'inclusion de script pour interpréter l'horodatage transmis et le corps de la demande. {#configure-hmac__ul_o53_5qy_jbc} Pour chaque secret partagé créé dans l'instance ServiceNow® , il existe un ID de clé. Vous devez configurer l'ID de clé dans l'ID de clé par défaut dans le profil d'authentification HMAC. |
      [Tableau 1. HMAC Configuration]

      {#configure-hmac__table_y3b_h1f_nzb}
   4. Envoyez l'enregistrement.
   {#configure-hmac__substeps_y2w_tz2_nzb}
2. 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 HMAC.  
   4. Remplissez les champs du formulaire.  
      {#configure-hmac__table_nnk_yqx_mzb__entry__2}

      | Champ | Description |
      |-|-|
      | Nom | Nom permettant d'identifier la politique d'authentification. |
      | Application | Périmètre de la politique d'authentification. |
      | Configuration pour HMAC | Configuration HMAC qui a été créée. |
      | Paramètre d'authentification | Paramètre d'authentification de la demande d'authentification. Vous pouvez sélectionner les options par défaut ou créer un nouveau paramètre d'authentification : * x-sn-hmac-signature-256 : en-tête d'authentification * x-sn-hmac-signature-256 : paramètre de requête {#configure-hmac__ul_ejm_4w4_nzb} |
      | ID de clé par défaut du secret partagé | Les informations de jeton qui peuvent être mises à jour dans ce champ pour l'utilisation de HMAC. |
      [Tableau 2. Profils d'authentification HMAC]

      {#configure-hmac__table_nnk_yqx_mzb}  
      Remarque :  
      L'option sélectionnée doit être définie dans l'appel REST dans le cadre de l'en-tête d'authentification ou du paramètre de requête.
   5. Envoyez le formulaire.
   {#configure-hmac__substeps_dv3_yy2_nzb}
3. Créez un secret HMAC.
   1. Accédez à TousServices web du systèmePolitiques d'accès APISecret HMAC de l'API REST.
   2. Sélectionnez Nouveau.
   3. Renseignez les champs suivants du formulaire :  
      {#configure-hmac__table_tpz_x1f_nzb__entry__2}

      | Champ | Description |
      |-|-|
      | Nom | Nom permettant d'identifier le secret HMAC de l'API REST. |
      | Description | Description du secret HMAC de l'API REST. |
      | Actives | Statut du secret HMAC de l'API REST. |
      | Utilisateur | Utilisateur associé au secret HMAC de l'API REST. Utilisez l'icône de recherche pour sélectionner l'utilisateur. |
      | ID clé | ID de clé qui doit être envoyé dans le cadre de l'appel REST. L'ID clé est généré après la soumission du formulaire. |
      | Secret partagé | Secrets partagés de l'utilisateur. Par exemple, le mot de passe. |
      | Source | Source de l'enregistrement. |
      | 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 3. Secret HMAC de l'API REST]

      {#configure-hmac__table_tpz_x1f_nzb}
   4. Envoyez le formulaire.
   5. Ouvrez l'enregistrement qui a été créé.  
      Recherchez l'ID de clé généré par l'utilisateur Plateforme IA ServiceNow pour l'utilisateur.  
      Remarque :  
      Vous pouvez ajouter l'ID de clé généré pendant l'ID de clé dans le profil d'authentification créé pour HMAC si vous ne souhaitez pas spécifier le paramètre Auth ou Query pour l'appel d'API.
   {#configure-hmac__substeps_yn3_r1f_nzb}
4. 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-hmac__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 | Option permettant d'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 | Option permettant d'appliquer la politique d'authentification de l'API à l'ensemble des méthodes, versions et ressources de l'API. |
      | Appliquer à toutes les ressources | Option permettant d'appliquer la politique d'authentification de l'API à toutes les versions. |
      | Appliquer à toutes les versions | Option permettant d'appliquer la politique d'authentification de l'API à toutes les ressources. |
      [Tableau 4. Politiques d'accès API]

      {#configure-hmac__table_d4x_w45_d4b}
   4. Ajoutez le profil d'authentification API qui a été créé.  
   5. Envoyez le formulaire.  
      Vous pouvez envoyer l'appel d'API REST :
      * Avec la signature x-sn-hmac-256 qui a été générée ServiceNow® lors de la création de clé API dans le paramètre En-tête ou Requête en fonction de la configuration d'authentification.
      * Avec script de pré-demande avec secret partagé spécifié dans le cadre de la demande.

      {#configure-hmac__ul_upf_rsv_pzb}  
      Avertissement :  
      Utilisez la requête POST lors de la soumission d'informations sensibles au serveur.
   {#configure-hmac__substeps_ypz_h5x_mzb}

