Intégration Dynatrace à l’authentification OAuth

  • Rversion finale: Xanadu
  • Mis à jour 17 juin 2026
  • 3 minutes de lecture

    • Intégrez Dynatrace en Gestion des événements authentifiant Dynatrace les jetons V1 ou V2 dans le Dynatrace moniteur.

    Avant de commencer

    Assurez-vous que le module d’extension Gestion des événements Connecteurs (sn_em_connector) est installé sur l’instance Now Platform .

    Le module d'extension Gestion des événements doit être installé sur l'instance Now Platform.

    Vérifiez que les éléments de configuration pour les hôtes gérés par Dynatrace existent dans ServiceNow. Ces CI peuvent être physiques ou virtuels, et peuvent être créés ou détectés manuellement à l'aide de la détection d'adresses IP ou de Cloud Discovery.

    Rôle requis : evt_mgmt_integration

    Pourquoi et quand exécuter cette tâche

    Dynatrace L’intégration à l’authentification OAuth est disponible à partir de la version de la plateforme ou d’une Washington DC version ultérieure.

    Procédure

    1. Configuration sur l’instance ServiceNow .
      1. Créez une glide.oauth.inbound.client.credential.grant_type.enabled propriété système pour utiliser le type d’attribution Informations d’identification du client pour les intégrations entrantes OAuth.
        • Type : vrai|faux
        • Valeur : vrai
      2. Créez un point de terminaison d’entité OAuth pour permettre aux clients d’accéder à l’instance.
        1. Accédez à la Tout > OAuth système > Registre d'application , puis sélectionnez Nouveau.
        2. Sur la page de l’intercepteur, sélectionnez Créer un point de terminaison d’API OAuth pour les clients externes , puis remplissez le formulaire.
        3. Pour créer un enregistrement client OAuth, sélectionnez Soumettre.
      3. Ajoutez l’utilisateur de l’application OAuth et le type d’accord par défaut à l’enregistrement client OAuth créé.
        1. Dans le formulaire Entité OAuth, ajoutez les champs Utilisateur de l’application OAuth et Type d’accord par défaut pour utiliser le type d’attribution Informations d’identification du client pour les intégrations entrantes OAuth.
        2. Ouvrez l’enregistrement client OAuth créé.
        3. Dans l’en-tête de la page, sélectionnez l’icône Plus d’options.
        4. Sélectionner Configurer > Mise en page
        5. Sur la page Mise en page, ajoutez l’utilisateur de l’application OAuth et le type d’accord par défaut dans la liste des champs.
        6. Enregistrez ou mettez à jour le formulaire.
        7. Pour le champ Utilisateur de l’application OAuth , sélectionnez l’utilisateur.
          L’utilisateur doit disposer du rôle evt_mgmt_integration qui sera utilisé pour créer les événements envoyés par Dynatrace.
          Remarque :
          pour garantir une authentification appropriée, utilisez l'utilisateur le moins privilégié disposant du rôle evt_mgmt_integration, plutôt qu'un utilisateur possédant des privilèges élevés.
        8. Définissez la valeur du champ Type d’accord par défaut sur Informations d’identification du client.
        9. Définissez Authscope sur useraccount.
      4. Créez un périmètre d’authentification de l’API REST pour les connecteurs d’événements RestAPI.
        1. Accédez à la Tout > Services web du système > Périmètres d'authentification API > Périmètre d'authentification REST API.
        2. Indiquez un nom.
        3. Définir Actif = vrai.
        4. Définissez Authscope en tant que compte utilisateur.
        5. Définissez l’API REST en tant que connecteurs d’événements.
        6. Sélectionnez Appliquer le périmètre d’authentification à toutes les méthodes HTTP dans cette API.
        7. Sélectionnez Appliquer le périmètre d’authentification à toutes les versions dans cette API.
        8. Sélectionnez Appliquer le périmètre d’authentification à toutes les ressources dans cette API.
    2. Dans la console, définissez les paramètres d’intégration Dynatrace .
      1. Accédez à la Paramètres > Intégration > Notifications de problèmes > Configurer les notifications.
      2. Dans le formulaire Configurer l’intégration personnalisée, URL Webhook.

        https://<nom-instance>.service-now.com/api/sn_em_connector/em/inbound_event?source=dynatrace

      3. Activez Utiliser OAuth 2.0 pour l’authentification.
      4. Dans la section Informations d’identification OAuth 2.0, procédez comme suit.
        1. Fournissez l’URL du jeton d’accès en tant que https://<instance_name>.service-now.com/oauth_token.do.
        2. Fournissez la valeur de l’ID client avec l’ID client du client de l’entité OAuth créé dans ServiceNow l’instance.
        3. Fournissez « Secret client » avec le secret client de l’entité client OAuth créée dans ServiceNow l’instance.
        4. Sélectionnez Enregistrer.
      5. Dans la section Charge utile personnalisée, ajoutez la structure de charge utile suivante pour les événements qui seront générés.
        { 
  "ImpactedEntities": {ImpactedEntities}, 
  "ImpactedEntity": "{ImpactedEntity}", 
  "PID": "{PID}", 
  "ProblemDetailsHTML": "{ProblemDetailsHTML}", 
  "ProblemDetailsJSONv2": "{ProblemDetailsJSONv2}",  
  "ProblemDetailsMarkdown": "{ProblemDetailsMarkdown}", 
  "ProblemDetailsText": "{ProblemDetailsText}", 
  "ProblemID": "{ProblemID}", 
  "ProblemImpact": "{ProblemImpact}", 
  "ProblemSeverity": "{ProblemSeverity}", 
  "ProblemTitle": "{ProblemTitle}", 
  "ProblemURL": "{ProblemURL}", 
  "State": "{State}", 
  "Tags": "{Tags}" 
}

    Résultats

    L’envoi Dynatrace des alertes des agents au module d’extension Gestion des événements commence. Le module d'extension extrait les informations du message d'alerte Dynatrace d'origine pour renseigner les champs d'événement requis et insère l'événement dans la base de données. Dans votre Now Platform instance, accédez à Tous les événements pour consulter les événements.

    Remarque :
    Par défaut, la liaison d’hôte est activée pour Dynatrace les événements destinés aux fournisseurs (AWS/Azure/GCP). Si tous les hôtes de l'environnement sont détectés via Détection dans le cloud en fournissant des informations d'identification et que les ressources détectées se trouvent dans la liste cmdb_ci_vm_object, la liaison d'ordinateurs virtuels est impossible. Pour résoudre ce problème, vous devez activer la règle d’événement Dynatrace générale. Pour en savoir plus sur les règles d'événements, consultez la rubrique Règles d'événements.