Partager via

Connecteur de données ServiceNow

  • Article

Pour configurer l’intégration de ServiceNow CMDB, vous devez fournir le nom d’hôte de votre instance ServiceNow et les informations d’identification valides. Le connecteur s’authentifie avec l’authentification de base à l’aide du nom d’utilisateur et du mot de passe pour l’accès en lecture seule.

Remarque

Nous vous recommandons de créer un utilisateur dédié à utiliser avec des connecteurs de données dans Exposure Management.

Configuration de ServiceNow

  1. Recherchez le nom d’hôte de votre instance ServiceNow. Par exemple, « contoso.service-now.com ».  
  2. Créez un utilisateur ServiceNow :
    1. Suivez les étapes ci-dessous pour créer un utilisateur.
    2. Conservez le nom d’utilisateur (ID utilisateur) et le mot de passe que vous avez fournis pour une utilisation ultérieure.
    3. S’il n’y a pas de champ de mot de passe, envoyez le formulaire pour créer l’utilisateur. Ensuite, lorsque vous sélectionnez le nouvel utilisateur, vous recevez l’option Définir le mot de passe .
    4. Lorsque vous créez l’utilisateur, case activée la zone Accès au service Web uniquement afin que l’utilisateur soit dédié uniquement pour cette intégration.
  3. Attribuez un rôle cmdb_read à l’utilisateur que vous avez créé. Des instructions détaillées sont disponibles ici.

Remarque

Le connecteur ServiceNow prend uniquement en charge l’authentification de base. L’authentification OAuth sera disponible ultérieurement.

Établir une connexion ServiceNow dans Gestion des expositions

Pour établir une connexion avec ServiceNow dans Exposure Management, procédez comme suit :

  1. Ouvrez les connecteurs de données à partir de la navigation Gestion des expositions, puis sélectionnez Se connecter dans la vignette CMDB ServiceNow.
  2. Entrez votre service ServiceNow instance détails et informations d’identification (créés dans la configuration ServiceNow), puis sélectionnez Se connecter.

Données récupérées

La gestion des expositions récupère actuellement les données sur les appareils, leur association d’applications métier et leur criticité métier. Des données supplémentaires sont également récupérées qui permettent d’identifier l’appareil, telles que les informations sur la carte réseau et les données du système d’exploitation.

Seuls les appareils qui étaient actifs au cours des 90 derniers jours sont récupérés, en fonction de l’évaluation du champ « sys_updated_on » dans l’intégration continue ServiceNow.

Les champs suivants sont ingérés via le connecteur :

Catégorie Properties
Appareils -Os
- osVersion
- osServicePack
- cpuType
-catégorie
- assetTag
-virtuel
- serviceNowCriticality
- usedFor
- networkAdapters (voir les détails ci-dessous)
- lastLoggedOnUser
- mostFrequentUser
- sysClassName
- uPrimaryBusinessApplication (voir les détails ci-dessous)
Carte réseau -nom
- sysId
- macAddress
- ipAddress
- ipDefaultGateway
Application métier - sysId
-nombre
- uCriticality
- businessCriticality

Résolution des problèmes liés au connecteur

Voici quelques problèmes courants qui peuvent survenir lors de la configuration du connecteur ServiceNow et des suggestions pour les résoudre.

Type d’erreur Action de résolution des problèmes
Message d’erreur « Impossible de résoudre le nom du serveur distant » Vérifiez le nom d’hôte de l’instance ServiceNow. En savoir plus sur l’authentification auprès de ServiceNow ici : Authentification (servicenow.com)
Code d’erreur 401 : Échec de l’autorisation Un échec d’autorisation indique que les informations d’identification peuvent ne pas être correctes ou qu’il peut ne pas y avoir suffisamment d’autorisations pour accéder aux données ServiceNow. Vérifiez vos informations d’identification et vérifiez qu’elles sont correctes et valides. En outre, case activée que vos informations d’identification disposent des autorisations requises. Pour plus d’informations sur la façon de s’assurer que le rôle cmdb_read est attribué, consultez la section Configuration de ServiceNow. Une autre raison possible de cet échec est le fait que votre instance ServiceNow est configuré pour accepter des connexions uniquement à partir d’une plage limitée d’adresses IP. Dans ce cas, consultez les conseils pour ajouter le bon ensemble d’adresses IP à votre liste d’autorisation ici : Adresses IP de liste d’autorisation
Code d’erreur 403 : Erreur d’accès interdit Cette erreur indique que les informations d’identification fournies ne disposent pas des autorisations nécessaires pour exécuter les API demandées. Mettez à jour vos informations d’identification avec les autorisations appropriées, comme décrit dans la section configuration, et vérifiez qu’elles ont au moins cmdb_read rôle attribué.
Code d’erreur 404 : Erreur introuvable Cette erreur indique que le point de terminaison demandé n’est pas accessible. Vérifiez que le nom d’hôte de votre instance ServiceNow est correct.
Code d’erreur 429 « Trop de demandes » Le système extrait régulièrement les données des fournisseurs externes configurés, qui peuvent avoir une limite sur le nombre de demandes simultanées. Nous vous recommandons de créer un utilisateur ou un compte dédié pour le connecteur afin d’éviter d’atteindre cette limite.
Message d’erreur d’URL incorrecte Cette erreur indique que le point de terminaison demandé n’est pas accessible. Vérifiez que le nom d’hôte de votre instance ServiceNow est correct.
Erreur « Déconnecté temporaire » ou « Échec temporaire » Si ce message d’erreur s’affiche sans informations supplémentaires, vérifiez la configuration du connecteur (nom d’hôte et informations d’identification). Si elles sont valides et que le problème ne se résout pas seul, contactez le support.
Ne pas voir certaines interfaces de configuration ou ressources CMDB ServiceNow dans les données ingérées Consultez Données récupérées pour obtenir une description des données qui doivent être récupérées par le connecteur CMDB ServiceNow. S’il manque encore des données, contactez le support.
Aucune donnée ingérée à partir de ServiceNow CMDB Passez en revue votre status de connexion pour vous assurer qu’il n’y a pas d’erreurs. Vérifiez qu’il existe des entrées valides dans votre CMDB ServiceNow qui correspondent aux données que nous récupérons. Exécutez l’exemple de requête Advanced Hunting pour case activée si des ressources ServiceNow se trouvent dans les tables Exposure Graph. Si vous ne parvenez toujours pas à trouver vos données CMDB ServiceNow, contactez le support technique.
Les adresses IP autorisées ServiceNow doivent être configurées pour permettre aux connecteurs de gestion des expositions d’accéder à ServiceNow Découvrez comment ajouter l’ensemble d’adresses IP à ajouter à votre liste d’autorisation ici : Adresses IP de liste d’autorisation

Étapes suivantes

Obtenir de la valeur à partir de vos connecteurs de données.