Prérequis
Avant de configurer l'intégration entre LDO et ServiceNow, assurez-vous que les prérequis suivants sont satisfaits pour établir une synchronisation correcte:
Alignement terminologique
Dans LDO, un appareil physique (tel qu'un ordinateur portable, un poste de travail ou un serveur) est appelé Dispositif. Dans ServiceNow, le même élément est appelé Actif.
Cohérence des données
Pour que le plugin ServiceNow fonctionne correctement, les dispositifs dans le portail LDO doivent correspondre aux actifs ou éléments de configuration dans ServiceNow. Assurez-vous que:
- Le nom du dispositif dans le portail LDO correspond au nom de l'Actif dans ServiceNow.
- Le numéro de série du dispositif correspond au numéro de série de l'Actif correspondant dans ServiceNow.
Accès et permissions
Vérifiez que les comptes utilisateur utilisés pour LDO et ServiceNow disposent des rôles et permissions nécessaires pour accéder, synchroniser et gérer les dispositifs/actifs sur les deux plateformes.
Application
| Rôles et droits
|
Lenovo Device Orchestration (LDO) | Vous devez disposer d'un compte administratif d'organisation pour générer
les identifiants API (ID client et Secret) requis pour l'intégration entre
LDO et ServiceNow, afin que le plugin LDO ServiceNow puisse fonctionner
correctement. |
ServiceNow | Compte administrateur |
Le plugin LDO ServiceNow a été développé et testé dans une instance ServiceNow vierge et vide. Toute modification ou mise à jour effectuée par ServiceNow sur leur plateforme peut impacter la fonctionnalité du plugin LDO ServiceNow.
Importer et installer le fichier XML Lenovo dans ServiceNow
L'Application Remote Update Set est un fichier XML que vous pouvez importer dans l'instance ServiceNow. Ce fichier contient la configuration et les scripts développés par Lenovo.
Il est obligatoire de disposer d'un compte administrateur dans l'application ServiceNow.
LDO Device Insights est actuellement désigné par LDI dans le plugin ServiceNow.
Procédure pour importer et installer le fichier XML Lenovo (LDO actuellement désigné par LDI dans le plugin ServiceNow) :
Connectez-vous au tableau de bord ServiceNow.
- Saisissez Update dans la barre de recherche. Le menu System Update Sets apparaît.
Cliquez sur Retrieved Update Sets. Dans la section Related Links, le lien Import Update Set from XML apparaît.
Cliquez sur
Import Update Set from XML.
Cliquez sur Choose file, puis sur Upload. Une fois le fichier importé, l'application LDI apparaîtra dans la liste.
Cliquez sur LDI. L'enregistrement LDI s'affiche dans l'application ServiceNow.
Remarque : Vous pouvez mettre à jour, supprimer ou prévisualiser les ensembles de mises à jour LDI.
Cliquez sur Preview Update Set.
Remarque : La prévisualisation échoue s'il y a des erreurs lors de l'import du fichier XML LDI.
Pour résoudre les erreurs, sélectionnez toutes les erreurs dans l'onglet, puis cliquez sur Update Set Preview Problems.
Sélectionnez Accept remote update.
Cliquez sur Commit. L'ensemble de mises à jour est validé avec succès.
Authentifier les identifiants API LDO dans ServiceNow
Dans la barre de recherche, saisissez LDI Config. L'onglet LDI Config apparaît.
Cliquez sur LDI Config. La page Properties s'affiche. Sur cette page, saisissez les identifiants API LDI pour établir une connexion entre ServiceNow et la plateforme LDI.
Entrez l'ID client API LDO.
Pour générer les identifiants API LDI, reportez-vous à Obtenir les identifiants API.
Synchroniser les actifs dans ServiceNow et LDI.
Connectez-vous à l'instance ServiceNow.
Dans la barre de recherche, saisissez computer. L'onglet Computer apparaît dans le menu de navigation.
Cliquez sur Computer dans le menu de navigation. La liste des actifs s'affiche dans le panneau.
Cliquez sur l'icône Settings. La fenêtre Personalize List Columns apparaît.
Les cases à cocher affichées dans la capture d'écran sont cochées par défaut.
Nom de l'actif : Par exemple, EPUAKYIW0FCA.
ID modèle de l'actif : HP EliteBook 850G7 Notebook.
Numéro de série de l'actif : 5CG1092.
Vous pouvez rechercher un actif par Nom, ID modèle ou Numéro de série. Sélectionnez les actifs que vous souhaitez synchroniser à l'aide de filtres.
Remarque importante : N'appliquez pas de filtre si vous souhaitez synchroniser tous les actifs.
Cochez les cases pour sélectionner les actifs à synchroniser avec la plateforme LDO.
Faites un clic droit sur l'onglet Export. Un menu latéral apparaît. Dans le menu contextuel, choisissez Export → CSV.
Sélectionnez le format de fichier à exporter (par exemple, CSV).
Cliquez sur Download. Le fichier est téléchargé sur l'appareil.
Format du fichier ServiceNow :
Si le nom d'un dispositif dans LDI et ServiceNow est différent, le nom du dispositif peut être modifié automatiquement via le fichier CSV.
Seuls les symboles underscore (_) et tiret (-) sont autorisés.
Pour mettre à jour automatiquement le NOM DU DISPOSITIF, le TYPE DE MACHINE doit être model_id, et le NUMÉRO DE SÉRIE doit correspondre à serial_number.
- Connectez-vous au compte LDO.
- Cliquez sur Device Management > Devices dans le menu de navigation. Le panneau Devices apparaît.
- Cliquez sur More. Une fenêtre déroulante apparaît.
Cliquez sur Import Device Changes.
- Sélectionnez le fichier (par exemple, le fichier CSV des actifs exportés depuis ServiceNow).
Cliquez sur Verify. Le fichier est vérifié.
Cliquez sur Yes. Les informations du dispositif sont mises à jour dans LDI, et un e-mail de confirmation est envoyé à votre adresse e-mail enregistrée. ServiceNow récupère les données pour le(s) dispositif(s) spécifié(s) et les affiche dans l'onglet Plugin. Le plugin LDI ServiceNow est maintenant configuré.
Intégrer ServiceNow dans LDO
Cette fonctionnalité permet au système de créer automatiquement un ticket et de l'assigner à l'équipe de support LDO lorsqu'un incident survient. Elle inclut des tâches telles que la configuration de la connexion au portail ServiceNow et la création de règles impliquant la gestion des capteurs, entre autres.
La communication entre le servicenow-integration-service et l'API ServiceNow utilise l'authentification Basic Authentication. Ainsi, les identifiants utilisateur ServiceNow sont stockés dans la base de données servicenow-integration-service et sont fournis à chaque appel API.
Alternativement, un mécanisme plus sécurisé peut être utilisé : l'authentification OAuth. Dans ce cas, un jeton à durée limitée est obtenu depuis l'API OAuth à l'aide des identifiants, puis utilisé dans les appels API suivants.
Procédure pour activer l'authentification OAuth :
- Connectez-vous au portail ServiceNow.
- Remplissez l'URL de l'instance.
- Saisissez les valeurs pour les champs suivants :
- ID utilisateur ou Identifiants admin
- Mot de passe
- ID client
- Secret client
- L'administrateur de l'organisation doit créer un utilisateur dans ServiceNow pour ID utilisateur et Mot de passe, et un client pour ID client et Secret client.
- Les rôles doivent être spécifiés : Admin, Asset, App_service_user, etc. Avec cet ensemble de rôles, il y a un problème pour définir un impact et une urgence élevés via l'API. Lorsque High est demandé, Medium est défini dans l'incident.
- Cliquez sur Connect to ServiceNow. Tous les identifiants saisis sont ensuite stockés dans la base de données. Ainsi, il est possible de recevoir des jetons à chaque besoin.
Vous devez disposer des privilèges d'administrateur d'organisation LDO pour configurer et créer une règle.
Cette option nécessite d'enregistrer un utilisateur et un mot de passe, mais cet utilisateur peut être contrôlé côté ServiceNow.
- Créer une règle d'incident ServiceNow
- Connectez-vous au portail LDO.
- Sélectionnez Informations sur le dispositif / Règles d'incident ServiceNow. La page Règles d'incident ServiceNow apparaît.
- Cliquez sur le bouton Connecter. La page Connexion à ServiceNow apparaît.
- Dans la section Ajouter une Instance, saisissez l'URL , l'ID utilisateur, et le mot de passe de ServiceNow.
- Dans la section Client Details, saisissez L'ID client et le Client Secret, de Service Now. Tous les champs sont obligatoires.
- Cliquez sur Connecter.
Créer une règle d'incident ServiceNow
Vous devez configurer ServiceNow dans LDO avant de créer une règle d'incident. Reportez-vous à Intégrer ServiceNow dans LDO pour plus de détails.
Le tableau suivant présente les champs disponibles dans la page Règles d'incident SNOW :
Tableau des champs de la page SNOW Incident Rules :
Application
| Rôles et droits
|
Nom de la règle
| Nom unique
identifiant la règle de Service Now |
Activités synchronisées | Le champ
"Activités synchronisées" affiche le nombre d'incidents créés
lorsque cette règle est active. Lorsque la règle est désactivée, ce champ
n'est plus mis à jour. |
Actions | · Cliquez sur l'icône ✏️(crayon) pour modifier une règle · Cliquez sur l'icône 🟢(cercle vert) pour
activer une règle · Cliquez sur l'icône ⭕(cercle rouge) pour désactiver une règle · Cliquez sur l'icône 🗑️(poubelle) pour supprimer une règle |
Vous pouvez également cliquer sur le bouton toggle

en haut de la page pour afficher toutes les règles actives pour les dispositifs ServiceNow.
Pour créer une règle :
- Sur la page des règles d'incident SNOW, cliquez sur l'icône . La page Nouvelle règle s'affiche.
- Saisissez le nom que vous souhaitez attribuer à la nouvelle règle.
- Sélectionnez les conditions dans les menus déroulants.
- Entrez le nom ou l'étiquette du dispositif auquel la nouvelle règle s'applique.
- Cliquez sur Enregistrer les règles.
Gérer un incident dans ServiceNow
La page suivante affiche tous les détails relatifs à un événement créé suite à la survenue d'un incident.
Lorsque vous créez un incident, les détails sont mis à jour dans l'onglet Diagnostics LDI. Vous pouvez consulter cet onglet en bas de la page. Il vous aide à prendre les mesures appropriées.