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 via l'API Table et le met à jour au fur et à mesure que l'alerte change. Pour savoir comment l'exportation se comporte selon les destinations, consultez Destinations d'alerte.

L’exportation vers ServiceNow est unidirectionnelle, de Lakewatch vers ServiceNow. Lakewatch écrit dans l’API de table ServiceNow en s’authentifiant 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 via l’API Table.
• En cas de changement : lorsque le titre, la description ou l’état de l’alerte changent, Lakewatch met à jour le même enregistrement.

Lakewatch définit l’identifiant de corrélation de l’enregistrement sur l’identifiant de l’alerte Lakewatch, afin que vous puissiez retracer un enregistrement jusqu’à son alerte et que Lakewatch mette à jour le même enregistrement plutôt que de créer un doublon.

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

Lakewatch lit le secret client OAuth à partir d’un secret Unity Catalog, une ressource sécurisable avec un nom à trois niveaux sous la forme catalog.schema.secret, à chaque fois qu’il exporte une alerte. Lakewatch ne stocke que le nom du secret, pas sa valeur.

Vous pouvez créer ce secret à l’avance ou le créer en ligne lors de la configuration de l’exportation ServiceNow à l’aide du bouton Créer un secret . Dans les deux cas, la création d’un secret nécessite USE CATALOG sur le catalogue et la propriété du schéma ou CREATE SECRET et USE SCHEMA sur le schéma. 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.
• Autorisation de modifier la configuration d'exportation d'alerte dans les paramètres du workspace.

Au moment de l’exportation, Lakewatch lit le secret du client lui-même, en tant que Service Principal. Comme Lakewatch lit le secret par son nom à chaque exportation, la rotation du secret est transparente : mettez à jour le secret Unity Catalog et Lakewatch utilise la nouvelle valeur lors de l’exportation suivante, sans modification de la configuration d’exportation.

Configurer l’exportation ServiceNow

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. Trouvez le paramètre Exporter sous Alertes .
3. Définissez la destination de l’exportation sur ServiceNow .
4. Pour Workspace , conservez le workspace actuel, sauf si la destination se trouve derrière le réseau d’un workspace spécifique, tel qu’un endpoint PrivateLink ou un service restreint à une région. Le réseau de ce workspace fournit l’exportation.
5. Dans ID de l'instance , saisissez l'identifiant de votre instance ServiceNow. Saisissez uniquement le libellé de l'hôte, pas l'URL complète : pour une instance à https://acme.service-now.com, saisissez acme.
6. Dans ID client , saisissez l’ID client OAuth de l’application que vous avez enregistrée dans ServiceNow.
7. Définissez Secret du client sur le secret Unity Catalog qui contient le secret du client OAuth. Tapez ou collez son nom à trois niveaux (catalog.schema.secret), cliquez sur Sélectionner un secret pour choisir un secret existant ou cliquez sur Créer un secret pour en créer un à partir du secret du client sans quitter la page. Une fois enregistré, le champ de secret devient en lecture seule ; pour le mettre à jour, faites tourner le secret dans Unity Catalog.
8. 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’incidents, ou l’ID de l’instance est incorrect. Confirmez que l’utilisateur de l’application possède le rôle incident_manager et que l’ID de l’instance correspond uniquement à l’étiquette de l’hôte (par exemple, acme).
• La configuration n'est pas enregistrée : vous n'avez pas l'autorisation de lire le secret Unity Catalog, ou le nom du secret n'est pas sous la forme catalog.schema.secret. Confirmez votre accès au secret et au nom du secret.
• 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.