ServiceNow

info

Aperçu

Lakewatch est en Aperçu privé. Pour demander l'accès, contactez l'équipe de votre compte Databricks.

Exporter les alertes Lakewatch vers ServiceNow. Lorsqu’une alerte est créée, Lakewatch crée un enregistrement d’incident dans ServiceNow et le met à jour au fur et à mesure que l’alerte change. Pour savoir comment l’exportation se comporte selon les destinations, voir Destinations d'alerte.

L’exportation vers ServiceNow est unidirectionnelle, de Lakewatch vers ServiceNow. Lakewatch se connecte avec une application OAuth que vous enregistrez dans ServiceNow.

Comment l'enregistrement est créé et mis à jour

• Lors de la création d’une alerte : Lakewatch crée un enregistrement d’incident dans votre instance ServiceNow.
• En cas de changement : lorsque le titre, la description ou l’état de l’alerte changent, Lakewatch met à jour le même enregistrement.

L’ID de corrélation de chaque enregistrement contient l’ID de l’alerte Lakewatch, ce qui vous permet de retrouver l’alerte à l’origine de l’enregistrement.

Prérequis

Configurer ServiceNow

Dans ServiceNow, enregistrez une application OAuth que Lakewatch utilisera pour créer et mettre à jour des enregistrements d’incident. Voici les grandes étapes. Pour la procédure exacte, consultez la documentation OAuth de ServiceNow.

1. Dans ServiceNow, allez dans System OAuth > Application Registry et sélectionnez Create an OAuth API endpoint for external clients . Vous pouvez créer une nouvelle application ou en réutiliser une existante.
2. Réglez Type de client sur Intégration en tant que service , réglez Restriction de champ d'application sur Champ d'application étendu , et réglez Utilisateur de l'application OAuth .
3. Accordez à l’utilisateur de l’application OAuth le rôle incident_manager, afin qu’il puisse créer et mettre à jour des enregistrements d’incidents.

Notez l'ID d'instance, l'ID client OAuth et le secret client.

Stockez le secret client en tant que secret Unity Catalog

Stockez le secret client OAuth dans un secret Unity Catalog dans le schéma __lakewatch de votre environnement Lakewatch. Sélectionner un secret liste les secrets de ce schéma, et Créer un secret en crée un à cet endroit. Lakewatch stocke uniquement le nom du secret, et non la valeur du secret.

Vous pouvez créer ce secret à l’avance dans <catalog>.__lakewatch, ou le créer lors de la configuration de l’exportation ServiceNow avec le bouton Créer un secret . Dans les deux cas, la création d’un secret nécessite USE CATALOG sur le catalogue et soit la propriété du schéma __lakewatch, soit les deux CREATE SECRET et USE SCHEMA sur celui-ci. Pour les étapes, voir Créer un secret.

Autorisations requises

Pour configurer l'exportation vers ServiceNow, vous devez disposer des éléments suivants :

• READ SECRET sur le secret Unity Catalog qui contient le secret du client, ou sur son schéma ou catalogue parent. Lakewatch vérifie que vous pouvez lire le secret lorsque vous enregistrez la configuration. Pour l’accorder, consultez la section Gérer les autorisations sur les secrets.
• Le privilège MANAGE sur le catalogue de votre environnement Lakewatch. Voir Configurer les paramètres.

Pour changer le secret client, mettez à jour la valeur du même secret Unity Catalog. Lakewatch utilise la nouvelle valeur lors de l’exportation suivante, sans changement des paramètres. Pour utiliser un secret différent, cliquez sur Sélectionner un secret ou Créer un secret dans les paramètres et enregistrez.

Configurer ServiceNow comme destination d'alerte

Configurez une destination ServiceNow pour les alertes dans la section des paramètres Alertes .

1. Dans la barre latérale Lakewatch, accédez à Paramètres , puis ouvrez Alertes .
2. Sous Livraison , définissez Destination de l’alerte sur ServiceNow .
3. Dans ID d'instance , ne saisissez que la première partie du Hostname de votre instance : pour https://acme.service-now.com, saisissez acme.
4. Dans ID client , saisissez l’ID client OAuth de l’application que vous avez enregistrée dans ServiceNow.
5. Pour Secret client , cliquez sur Sélectionner un secret pour choisir le secret contenant le secret client, ou cliquez sur Créer un secret pour en créer un à partir du secret client sans quitter la page. Le champ affiche le nom du secret, et non sa valeur.
6. Enregistrez vos modifications.

Pour obtenir la référence complète des paramètres d’alerte, consultez la page Configurer les paramètres.

Dépannage

• Les enregistrements ne sont pas créés dans ServiceNow : l’utilisateur de l’application OAuth ne peut pas créer d’enregistrements d’incident, ou l’ID d’instance est incorrect. Confirmez que l’utilisateur de l’application possède le rôle incident_manager et que l’ID d’instance n’est que la première partie du hostname (par exemple, acme).
• La configuration ne s'enregistre pas : vous ne disposez pas des autorisations nécessaires pour lire le secret Unity Catalog, ou le secret se trouve dans un catalogue différent de votre environnement Lakewatch. Confirmez votre accès au secret et à son catalogue.
• Votre secret n’est pas répertorié dans Sélectionner un secret : Sélectionner un secret répertorie uniquement les secrets auxquels vous pouvez accéder dans le schéma __lakewatch du catalog de votre environnement. Stockez le secret à cet emplacement ou demandez READ SECRET dessus.
• L’authentification échoue : l’ID client ou le secret client est incorrect, ou l’application OAuth n’a pas les autorisations nécessaires. Confirmez l'identifiant client, la valeur du secret et l'accès de l'application dans ServiceNow.
• Vous avez fait tourner le secret client : mettez à jour le secret Unity Catalog avec la nouvelle valeur. Aucune modification de la configuration d'exportation n'est nécessaire.