Intégrer ThousandEyes au jeton de clé API REST

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 1 minute de lecture

    • Intégrez l’utilisation d’une clé API pour établir une communication sécurisée et automatiser l’échange de données via l’API REST. Cela simplifie l’intégration, permettant un accès transparent aux services et améliorant l’efficacité opérationnelle.

    Avant de commencer

    Rôle requis : evt_mgmt_integration

    Procédure

    1. Accédez à la Tout > Services web du système > Politiques d'accès API > Clé API REST.
      Navigation dans l’API REST
    2. Sélectionnez Nouveau.
    3. Renseignez les champs du formulaire.
      Remarque :
      L’utilisateur doit être créé avec le rôle evt_mgmt_integration. Créez-en un nouveau sur la table sys_user à utiliser ici pour faciliter l’accès approprié.
      Tableau 1. Clé API
      Champ Description
      Nom Nom permettant d’identifier la clé API REST
      Description Description de la clé API REST.
      Actif É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 Clé API REST générée. 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.
    4. Déverrouillez le périmètre d’authentification et ajoutez : UserAccount.
    5. Utilisez le menu du formulaire et sélectionnez Enregistrer.

      Le système génère un jeton et l’enregistre dans le champ Jeton . Pour afficher le jeton, utilisez l’icône de verrou et copiez le contenu affiché sous le champ. Il s’agit de la valeur de votre paramètre (ou en-tête) de requête lorsque votre autre système envoie une demande d’API REST à ServiceNow.

      Jeton REST API généré dans le champ Jeton.

    Résultats

    Vous êtes maintenant prêt à commencer à envoyer des événements. Dans votre outil de surveillance, vous pouvez envoyer des événements avec l’en-tête ou le paramètre de requête : x-sn-apikey. Par exemple : 
    https://[INSTANCENAME].service-now.com/api/sn_em_connector/em/inbound_event?source=[SOURCENAME]&sys_id=[SYSID OF PUSH CONNECTOR INSTANCE]&x-sn-apikey=[AUTH TOKEN]