Intégrer Instana à l’authentification OAuth
Intégrer Instana à Gestion des événementsServiceNow l’utilisation de l’authentification OAuth.
Avant de commencer
Assurez-vous que le module d’extension Gestion des événements Connecteurs (sn_em_connector) est installé sur l’instance ServiceNow AI Platform .
Rôle requis : evt_mgmt_admin
Procédure
-
Configuration sur l’instance ServiceNow .
- Créez une glide.oauth.inbound.client.credential.grant_type.enabled propriété système pour utiliser le type d’accord Informations d’identification du client pour les intégrations entrantes OAuth.
- Type : Vrai/Faux
- Valeur : vrai
Remarque :Un administrateur doit créer cette propriété système, car le rôle evt_mgmt_admin ne dispose pas de l’autorisation requise pour le faire. - Créez un point de terminaison d'entité OAuth pour permettre aux clients d'accéder à l'instance.
- Accédez à la Tous > OAuth système > Registre d'application puis sélectionnez New.
- 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.
- Pour créer un enregistrement client OAuth, sélectionnez Soumettre.
- Ajoutez l'utilisateur de l'application OAuth et le type d'accord par défaut à l'enregistrement client OAuth créé.
- 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’accord Informations d’identification du client pour les intégrations entrantes OAuth.
- Ouvrez l'enregistrement client OAuth créé.
- Dans l’en-tête de la page, sélectionnez l’icône Autres options.
- Sélectionner Configurer > Mise en page
- Sur la page Mise en page, ajoutez Utilisateur de l’application OAuth et Type d’accord par défaut dans la liste des champs.
- Enregistrez ou mettez à jour le formulaire.
- Pour le champ Utilisateur de l’application OAuth , sélectionnez l’utilisateur.L’utilisateur doit avoir le rôle evt_mgmt_integration qui sera utilisé pour créer les événements envoyés par Grafana.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.
- Définissez la valeur du champ Type d’accord par défaut sur Informations d’identification du client.
- Créez une glide.oauth.inbound.client.credential.grant_type.enabled propriété système pour utiliser le type d’accord Informations d’identification du client pour les intégrations entrantes OAuth.
- Dans la console Instana, accédez à Paramètres > Événements et alertes > Canaux d’alerte.
- Ouvrez la liste déroulante Ajouter un canal d’alerte et sélectionnez l’option Webhook générique .
-
Dans le champ URL Webhook , créez un canal d’alerte en saisissant l’URL suivante :
https://<instance>.service-now.com/api/sn_em_connector/em/inbound_event?source=instana.
-
Activez le commutateur Activer OAuth pour authentifier l’URL ServiceNow .
- Dans le champ ID client , fournissez la valeur d’ID client du client de l’entité OAuth créé dans ServiceNow l’instance.
- Dans le champ Secret client , fournissez la valeur de secret client de l’entité OAuth Client créée dans ServiceNow l’instance.
- Dans le champ URL du jeton , saisissez https://<instance_name>.servicenow.com/oauth_token.do
- Pour tester l’intégration, sélectionnez Canal de test
- Sélectionnez Enregistrer.
-
Configurez Instana pour créer des alertes pour les types d'événements ou les événements.
- Accédez à la Paramètres > Événements et alertes > Alertes.
- Sélectionnez Nouvelle alerte.
-
Dans la section Événements , sélectionnez l’une des options suivantes :
- Alerte sur le ou les types d'événements
- Alerte sur le ou les événements
-
Lors de la création d'alertes pour les types d'événements :
- Sélectionnez le type d’événements pour lesquels vous souhaitez créer des alertes, tel que Problèmes critiques, Tous les incidents, Problèmes d’avertissement, etc.
- Dans la section Alerte , sélectionnez le canal d’alerte ServiceNow .
-
Lors de la création d'alertes pour les événements :
- Sélectionnez les événements pour lesquels vous souhaitez créer des alertes.
- Dans la section Alerte , sélectionnez le canal d’alerte ServiceNow .
Lorsque Instana crée une alerte, celle-ci est envoyée à l’instance ServiceNow . Les alertes créées pour l’entité hôte sont liées à la table Serveur (cmdb_ci_server) et les alertes créées pour l’entité Site Web sont liées à la table HTTP(S) (cmdb_ci_endpoint_http).Ajoutez d’autres types d’entité dans la table Mappage de champs d’événements Instana - ci_type pour vous assurer que l’entité se lie au CI correct dans l’instance ServiceNow .
-
Pour afficher l’événement dans le système source Instana, vous pouvez y accéder à partir d’une ServiceNow instance :
- Accédez à la Tous > Gestion des événements > Espace de travail pour l'exploitation des services.
- Sélectionnez toutes les alertes.
- Sélectionnez l'alerte pertinente.
- Dans l’onglet Détails , localisez la section Actions sur le côté droit de la page et dans la cellule Afficher l’événement sur l’interface utilisateur Instana , sélectionnez Lancer l’application.