Configurer Connecteur du graphe de services pour AWS à l’aide de la configuration guidée
Configurez l’environnement et les travaux planifiés pour extraire AWS des AWS données dans le CMDB.
Avant de commencer
Pour utiliser cette optionConnecteur du graphe de services, vous devez être abonné à une unité d’abonnement basée sur l’application Gestion des opérations ITITOM() Visibility () Visibility ( Visibilité ou l’application ITOM Découverte). Comme défini dans la section intitulée « Types de ressources informatiques gérées » dans la vue d’ensemble de l’unité d’abonnement ServiceNow pour votre abonnement, pour les ressources informatiques gérées qui sont créées ou modifiées dans le CMDB cadre de cet Connecteur du graphe de services abonnement, mais qui ne sont pas encore gérées par Visibilité ITOM ou Découverte ITOM, ces ressources augmenteront la consommation d’unités d’abonnement à partir de cette application. Vérifiez votre consommation actuelle d’unités d’abonnement dans Visibilité ITOM ou Découverte ITOM pour vous assurer de la capacité disponible.
- L’application du magasin Integration Commons for CMDB, qui est automatiquement installée.
- L’application de stockage des modèles de classe CI CMDB, qui est automatiquement installée. Consultez Application Modèles de classe CI CMDB.
- Module d’extension Découverte Core (com.snc.discovery.core), qui est automatiquement installé par Découverte.
- Le module d’extension ITOM Découverte License (com.snc.itom.discovery.license). Vous devez activer ce module d’extension.
- Module d’extension Gestion des licences ITOM (com.snc.itom.license). Pour plus d’informations, consultez la section Demander la découverte.
Assurez-vous d’avoir rempli les conditions préalables à la configuration d’AWS. Consultez Configurer l'environnement AWS.
- Pour mettre à jour les documents SSM, exécutez les scripts SG-AWS-RunShellScript-Setup.yml, SG-AWS-RunPowerShellScript-Setup.yml et SG-AWS-RunKubeCtlShellScript.yml .
- Pour mettre à jour les autorisations IAM affectées au rôle SnowOrganizationAccountAccessRole, exécutez le script CreateSnowOrganizationAccountAccessRoleInMemberAccount.yml .
Pourquoi et quand exécuter cette tâche
Pour plus d’informations sur les instructions de configuration de Connecteur du graphe de services pour AWS , consultez les articles suivants :
- Connecteur du graphe de services pour AWS : instructions de configuration [KB1220597] article de la Now Support base de connaissances.
- Connecteur du graphe de services pour AWS : introduction sur le site de la ServiceNow communauté.
- SGC-AWS : fonctionnalités de la version 2.0 sur le site de la ServiceNow communauté.
- S’il existe des personnalisations, supprimez les enregistrements associés à Connecteur du graphe de services pour AWS la table Mises à jour du client [sys_update_xml]. Consultez Customer Updates table.
- Mettez à niveau toutes les dépendances.
- Effectuez une importation complète des données à partir de votre AWS instance. Vérifiez que la valeur du champ Utiliser la date et l’heure AWS de la dernière exécution est désactivée pour toutes les sources de données de la table Source de données [sys_data_source].
- Téléchargez et réexécutez les AWS scripts. Consultez Configurer l'environnement AWS.
Procédure
-
Assurez-vous d’avoir sélectionné le périmètre de l’application Connecteur du graphe de services pour AWS à l’aide du sélecteur d’application.
Pour plus d’informations, voir Sélecteur d’application.
- Accédez à la Tous > Connecteurs du graphe de services > AWS > Configuration.
-
Configurer l'environnement AWS.
Remarque :Une fois que vous avez téléchargé les scripts et configuré l’environnement AWS , définissez les tâches Télécharger les scripts et Instructions de configuration AWS sur Terminé.Pour la tâche Télécharger les scripts, sélectionnez Configurer pour télécharger les scripts.
-
Configurez les informations d’identification de l’authentification pour authentifier les demandes envoyées aux AWS API.
-
Configurez vos AWS informations d’identification.
- Pour la section Configurer la connexion de la page Connecteur du graphe de services pour AWS , sélectionnez Démarrer.
- Pour la tâche Configurer les informations d’identification , sélectionnez Configurer.
- Dans le champ Nom , saisissez un nom pour l’authentification.
SG-AWS-Credentials-Org est le nom de l’alias d’informations d’identification par défaut. Vous pouvez ajouter plusieurs AWS instances. Toutefois, ne modifiez pas l’alias de connexion par défaut.
- Saisissez l’ID de clé d’accès et la clé d’accès secrète dans les champs ID de clé d’accès et Clé d’accès secrète respectivement.
Les AWS clés d’accès sont des informations d’identification à long terme pour l’utilisateur IAM et comprennent deux parties : un ID de clé d’accès et une clé d’accès secrète. Vous devez utiliser ensemble l’ID de clé d’accès et la clé d’accès secrète pour authentifier les demandes.
- Revenez à la page Configurer la tâche de connexion en sélectionnant l’icône de retour (<).
- Définissez la tâche Configurer les informations d’identification comme terminée en sélectionnant Marquer comme terminé.
-
Testez la connexion d’API AWS pour importer des données à partir de l’application AWS .
- Pour la tâche Tester la connexion , dans la section Configurer la connexion , sélectionnez Configurer.
- Sélectionnez le lien connexe Test de la connexion .
- Lorsque le champ État est défini sur Réussite, sélectionnez l’icône de retour (<) pour revenir à la configuration guidée.
- Définissez la tâche Test de la connexion à terminer en sélectionnant Marquer comme terminé.
-
Mettez à jour les propriétés de configuration requises pour une AWS instance.
- Pour la tâche Mettre à jour les propriétés de configuration de l’instance , sélectionnez Configurer.
- Dans le formulaire Propriétés de configuration SG-AWS qui s’ouvre dans un nouvel onglet, examinez et modifiez les champs.
Tableau 1. Formulaire de propriétés de configuration SG-AWS Champ Description Détails de la connexion Alias de connexion Nom permettant d’identifier l’enregistrement de AWS connexion. Par exemple, SG_AWS_CredentialAlias_Org. Vous pouvez ajouter plusieurs AWS instances. Toutefois, ne modifiez pas le nom de l’alias de connexion par défaut SG_AWS_CredentialAlias_Org.
Détails de l'organisation Compte d'organisation Identificateur numérique de compte de l’organisation AWS . Nom de l'organisation Nom de l’organisation AWS . Description de l'organisation Description de l’organisation AWS . Régions AWS Régions AWS Régions pour collecter les données CI. Par défaut, Connecteur du graphe de services pour AWS s’exécute dans toutes les AWS régions pour collecter les données CI.
Vous pouvez saisir AWS des régions spécifiques pour accélérer le processus d’importation de données CI. Par exemple,
us-east1, us-east-2.Si ce champ est laissé vide, Connecteur du graphe de services pour AWS extrait les ressources de toutes les AWS régions.
Toutefois, pour les régions AWS GovCloud, ne laissez pas le champ Régions vide. Les régions AWS GovCloud prises en charge sont
us-gov-east-1etus-gov-west-1.Si vous mettez à jour la valeur du champ Régions ultérieurement, effacez la valeur du champ Date/heure de la dernière exécution dans toutes les sources de données liées au Connecteur du graphe de services pour AWS importer un nouvel ensemble de données.
STS : nom de rôle supposé Rôle STS Nom du rôle AWS Identity and Access Management (IAM) obtenu par l’utilisateur ServiceNow en appelant l’API AssumeRole proposée par le AWS service de jeton de sécurité (STS). L’API AssumeRole renvoie un ensemble d’informations d’identification de sécurité temporaires permettant à l’utilisateur ServiceNow d’accéder AWS aux ressources. Remarque :Saisissez le nom du rôle IAM, mais ne préfixez pas depréfixe ARNdans le nom. Si vous laissez ce champ vide, la valeur de ce champ est automatiquement définie sur SnowOrganizationAccountAccessRole, qui est le nom de rôle IAM par défaut pour l’utilisateur ServiceNow .Détails du compte S3 ID du compte S3 Identificateur numérique du AWS compte qui héberge la Amazon catégorie Simple Storage Service (Amazon S3). Nom de la catégorie S3 Nom de la Amazon catégorie S3 qui collecte les détails des Amazon instances EC2. Région S3 Région où se trouve la Amazon catégorie S3. Détails du document SSM SendCommand Nom Linux de la commande SSM Send Nom du document qui définit les actions exécutées par AWS Systems Manager (SSM) sur une instance EC2 basée sur Amazon Linux. Nom Windows de la commande SSM Send Nom du document qui définit les actions exécutées par le AWS SSM sur une instance EC2 basée sur Amazon Windows. ID du compte de gestion ID du compte de gestion Compte de gestion dans l’organisation AWS . Le compte appelle l’API ListAccounts associée à l’organisation AWS pour collecter des informations de CI à partir de tous les comptes. Pour plus d’informations, consultez ListAccounts sur le site de documentation AWS . Saisissez une valeur pour ce champ lors de la création de l’utilisateur ServiceNow dans un AWS compte membre.
Détails de l'ID de compte autonome ID de compte autonome ID d’un compte membre dans l’organisation AWS . Remarque :Lors de la spécification d’un compte autonome, les données liées à l’organisation AWS, telles que le nom de l’organisation, les unités d’organisation, l’ID de l’organisation et les comptes de service, ne sont pas importées. Si vous souhaitez importer les données complètes ultérieurement, effacez toutes les valeurs mentionnées dans le champ ID de compte autonome . Consultez l’article Connecteur du graphe de services pour AWS : configuration autonome [KB1642159] dans la base de Now Support connaissances.Détails de l'agrégateur AWS Config Compte d'agrégateur Config AWS compte dans lequel le type de ressource d’agrégateur dans le AWS service de configuration a été configuré. Saisissez une valeur dans ce champ lorsque vous utilisez un AWS agrégateur de configuration.
Nom de l'agrégateur Config Nom du type de ressource d’agrégateur. Ce champ n’est disponible que lorsque vous saisissez une valeur dans le champ Compte d’agrégateur de configuration . Région de l'agrégateur Config Région où réside le type de ressource d’agrégateur. Ce champ n’est disponible que lorsque vous saisissez une valeur dans le champ Compte d’agrégateur de configuration . Configuration de la rotation de clé AWS Lancer la rotation des clés AWS Option permettant d’activer le processus de rotation des clés. Date de rotation de la clé AWS Date de rotation des clés. Définissez la valeur sur la date de rotation de clé requise pour la première exécution. Pour les exécutions suivantes, ce champ est automatiquement défini sur la date de rotation. Ce champ n’est disponible que lorsque vous cochez la case Rotation des clés AWS . Période de rotation de la clé AWS (en jours) Période de rotation de clé en jours. Ce champ n’est disponible que lorsque vous cochez la case Rotation des clés AWS . État de rotation de la clé AWS Message d’état d’une rotation de clés indiquant si la rotation a été un succès ou un échec. Ce champ est automatiquement défini pour afficher le message d’état de rotation des clés. Ce champ n’est disponible que lorsque vous cochez la case Rotation des clés AWS . Si l’état de rotation est défaillant, une notification par e-mail est déclenchée, si configurée. Comptes de messagerie pour la réception des notifications d'erreur Liste séparée par des virgules des adresses de destinataires qui reçoivent des notifications concernant les AWS erreurs de rotation de clés. Groupes de comptes de messagerie pour la réception des notifications d'erreur Liste séparée par des virgules ServiceNow des groupes qui reçoivent des notifications concernant les AWS erreurs de rotation de clés. Configuration de Gov Cloud Est Gov Cloud Option pour indiquer que la configuration de la connexion est pour AWS GovCloud. Détails du document SSM EKS SendCommand Document de noms de grappes EKS Nom du document SSM pour détecter les AWS grappes EKS associées aux hôtes bastions EC2. Document de script du shell EKS Nom du AWS document SSM pour extraire les CI liés aux composants Kubernetes, tels que les pods, les services et les déploiements, à partir des grappes EKS. - Sélectionnez Enregistrer , puis Fermer pour fermer l’onglet et revenir à l’onglet Configuration guidée.
- Définissez les propriétés de configuration de mise à jour pour la tâche d’instance comme terminée en sélectionnant Marquer comme terminé.
-
Configurez vos AWS informations d’identification.
-
Configurez les ressources EC2 requises pour Amazon Elastic Kubernetes Service (EKS) l’importation des données de grappe EKS.
Une ressource EC2 EKS est un hôte bastion qui dispose d’un accès réseau aux grappes EKS. Les grappes EKS ne sont pas directement accessibles au connecteur. Par conséquent, vous devez fournir les détails de la ressource EC2 EKS . Pour importer des données de grappe EKS, le connecteur utilise la commande SSM Send sur les ressources EC2 EKS pour exécuter les commandes kubectl à distance.Remarque :Assurez-vous d’avoir configuré votre AWS environnement pour l’intégration EKS. Pour plus d’informations, consultez l’article Connecteur du graphe de services pour AWS - Intégration Amazon EKS [KB1437138] dans la base de Now Support connaissances.
- Pour la section Configurer les détails des ressources EKS de la page Connecteur du graphe de services pour AWS , sélectionnez Démarrer.
- Pour la tâche Saisir les détails des ressources EC2 EKS , sélectionnez Configurer.
-
Renseignez les champs du formulaire qui s’ouvre dans un nouvel onglet.
Tableau 2. SG-AWS-EKS-EC2-Formulaire de ressources Champ Description ID de ressource EC2 EKS Identificateur de la ressource EC2 EKS. Compte EC2 Nom d’utilisateur affecté au compte de ressource EC2 EKS . Région EC2 Région AWS où se trouve la ressource EC2 EKS . Actives Option permettant d’activer la ressource EC2 EKS. Remarque :Définissez la valeur sur faux si vous n’utilisez pas la ressource de ressource EC2 EKS .Connexion Alias de connexion associé à l’environnement et configuré dans l’étape AWS4.a. - Sélectionnez Soumettre pour revenir à la configuration guidée.
-
Répétez les étapes de 5.b à 5.d pour ajouter plusieurs ressources EC2 EKS.
Toutes les ressources EC2 EKS sont ajoutées à la table SG-AWS-EKS-Master [sn_aws_integ_sg_aws_eks_master].
- Définissez la tâche Saisir les détails des ressources EC2 EKS à terminer en sélectionnant Marquer comme terminé.
-
Exécutez l’outil de AWS diagnostic avant d’exécuter une tâche d’importation planifiée pour identifier tout problème dans la configuration de l’environnement AWS .
- Pour la section Outil de diagnostic AWS du graphe de services de la page Connecteur du graphe de services pour AWS , sélectionnez Démarrer.
- Pour la tâche Outil de diagnostic de configuration AWS , sélectionnez Configurer.
- Sélectionnez l’ID de l’organisation dans le champ de texte.
-
Sélectionnez Exécuter le test de diagnostic.
Conseil :Sélectionnez l’une des options suivantes pour exclure les résultats des tests correspondants du résumé du diagnostic :
- Ignorer les tests de configuration SSM
- Exclut les données d’inventaire logiciel des résultats récapitulatifs en n’appelant pas l’API GetInventory . Sélectionnez cette option lorsque vous vous êtes désabonné ou que vous n’avez pas configuré la configuration pour SSM.
- Ignorer les tests de découverte approfondie SSM
- Exclut les données de découverte approfondie des résultats récapitulatifs. Sélectionnez cette option lorsque vous avez annulé ou non défini la configuration de la découverte approfondie SSM.
- Ignorer les tests de configuration EKS
- Exclut les données EKS des résultats récapitulatifs en n’exécutant pas les commandes kubectl. Sélectionnez cette option lorsque vous avez annulé ou non configuré l’intégration EKS.
- Facultatif : Affichez uniquement les résultats des tests de grappe EKS en sélectionnant Afficher les détails des tests EKS.
- Facultatif : Prévisualisez tous les résultats de l’outil de diagnostic précédents en sélectionnant Charger les résultats DT, en sélectionnant un ID de diagnostic, puis en sélectionnant Charger les résultats.
- Lorsque vous avez terminé d’examiner les résultats du résumé du diagnostic, sélectionnez le bouton de retour de votre navigateur pour revenir à la configuration guidée.
- Définissez la tâche de l’outil de diagnostic de configuration AWS comme terminée en sélectionnant Marquer comme terminé.
-
Configurez les travaux planifiés pour importer des données à partir de l’application AWS .
- Dans la section Configurer les tâches d’importation planifiée de la page Connecteur du graphe de services pour AWS , sélectionnez Démarrer.
- Pour la tâche Configurer la tâche planifiée , sélectionnez Configurer.
- Sélectionnez la tâche planifiée que vous souhaitez activer.
-
Sur le formulaire Importation de données planifiée, vérifiez les valeurs de champ de la tâche planifiée.
Pour plus d'informations, consultez Schedule a data import.
- Sélectionnez Mettre à jour.
- Répétez les étapes 7.c pour chaque tâche planifiée d’importation 7.e de données.
- Sélectionnez l’icône de retour (<) pour revenir à la page de Configuration guidée.
- Configurez la tâche de tâche planifiée à terminer en sélectionnant Mark as Complete (Marquer comme terminé) dans la configuration guidée.
- Facultatif :
Ajoutez plusieurs AWS instances.
- Dans la section Ajouter plusieurs instances de la page Connecteur du graphe de services pour AWS , sélectionnez Démarrer.
-
Assurez-vous de disposer des autorisations de modification pour la table Source de données [sys_data_source] afin de créer des sources de données pour la nouvelle instance.
- Sélectionnez le périmètre de l’application Global à l’aide du sélecteur d’application.
- Pour la tâche Mettre à jour l’accès à la source de données, sélectionnez Configurer.
- Dans la liste connexe Accès à l’application, cochez les cases Peut créer, Peut mettre à jour et Peut supprimer , si ce n’est pas déjà fait.
- Sélectionnez Mettre à jour pour fermer l’onglet et revenir à la configuration guidée.
- Modifiez à nouveau le périmètre de l’application pour le définir sur Connecteur du graphe de services pour AWS à l’aide du sélecteur d’application.
- Définissez la tâche Mettre à jour l’accès à la source de données sur terminée en sélectionnant Marquer comme terminé.
-
Mettez à jour l’accès pour les tâches d’importation planifiées.
- Sélectionnez le périmètre de l’application Global à l’aide du sélecteur d’application.
- Pour la tâche Mettre à jour l’accès à Importation de données planifiée , sélectionnez Configurer.
- Dans la liste connexe Accès à l’application, cochez les cases Peut créer, Peut mettre à jour et Peut supprimer , si ce n’est pas déjà fait.
- Sélectionnez Mettre à jour pour fermer l’onglet et revenir à l’onglet Configuration guidée.
- Définissez la tâche Mettre à jour l’accès à l’importation de données planifiée sur terminée en sélectionnant Marquer comme terminé.
- Modifiez à nouveau le périmètre de l’application pour le définir sur Connecteur du graphe de services pour AWS à l’aide du sélecteur d’application.
-
Effacez le cache des tables Source de données [sys_data_source] et Importations de données planifiées [scheduled_import_set] pour activer la création d’une source de données pour la nouvelle connexion dans le Connecteur du graphe de services pour AWS.
- Pour la tâche Effacer le cache des tables de source de données et d’importations de données planifiées , sélectionnez Configurer.
- Dans la zone de texte Exécuter le script de la page de script en arrière-plan, entrez le script suivant :
GlideTableManager.invalidateTable("sys_data_source"); GlideCacheManager.flushTable("sys_data_source"); GlideTableManager.invalidateTable("scheduled_import_set"); GlideCacheManager.flushTable("scheduled_import_set"); GlideTableManager.invalidateTable("sys_db_object"); GlideCacheManager.flushTable("sys_db_object"); - Sélectionnez Exécuter le script pour exécuter le script en arrière-plan dans le champ d’application global .
L’exécution du script peut prendre plusieurs minutes.
- Une fois le script exécuté, sélectionnez Fermer.
- Définissez la tâche Effacer le cache des tables de source de données et d’importations de données planifiées sur terminée en sélectionnant Marquer comme terminé.
- Modifiez à nouveau le périmètre de l’application pour le définir sur Connecteur du graphe de services pour AWS à l’aide du sélecteur d’application.
-
Créez un alias d’informations d’identification pour la nouvelle AWS connexion dans Connecteur du graphe de services pour AWS.
- Pour la tâche Créer un enregistrement d’alias de connexion et d’informations d’identification , sélectionnez Configurer.
- Dans le formulaire Alias de connexion et d’informations d’identification qui s’ouvre dans un nouvel onglet, renseignez les détails de connexion.
- Sélectionnez Soumettre , fermez l’onglet, puis revenez à l’onglet Configuration guidée.
- Définissez la tâche Créer un enregistrement d’alias de connexion et d’informations d’identification à terminer en sélectionnant Marquer comme terminé.
-
Créez des informations d’identification pour le nouvel AWS alias d’informations d’identification.
- Pour la tâche Créer un enregistrement d’alias de connexion et d’informations d’identification , sélectionnez Configurer.
- Sur la page Connexions du , sélectionnez Ajouter une Studio de workflowconnexion.
- Dans la fenêtre Créer une connexion, renseignez le nom de connexion, la clé d’accès et les détails de la clé secrète.
- Sélectionnez Créer une connexion.
- Fermez et Studio de workflow revenez à l’onglet Configuration guidée.
- Définissez la tâche Créer un enregistrement d’alias de connexion et d’informations d’identification à terminer en sélectionnant Marquer comme terminé.
-
Mettez à jour les propriétés de la nouvelle instance en Connecteur du graphe de services pour AWS sélectionnant Configurer pour la tâche Configurer l’environnement AWS pour la nouvelle tâche d’instance .
Pour plus d’informations, suivez l’étape 4.c décrite précédemment pour configurer les propriétés de la AWS connexion disponible par défaut.
Une fois la mise à jour des propriétés terminée, définissez l’environnement Configurer AWS pour que la nouvelle tâche d’instance se termine en sélectionnant Marquer comme terminé.
-
Saisissez les détails des ressources EC2 EKS en sélectionnant Configurer pour la tâche Mettre à jour les détails des ressources EKS .
Pour plus d’informations, suivez l’étape 5 décrite précédemment pour configurer les détails des ressources EC2 EKS pour la AWS connexion disponible par défaut.
Lorsque vous avez terminé de mettre à jour les propriétés, définissez la tâche Mettre à jour les détails des ressources EKS comme terminée en sélectionnant Marquer comme terminé.
-
Configurez les importations planifiées pour la nouvelle instance AWS.
- Pour la tâche Configurer les importations planifiées , sélectionnez Configurer.
- Dans la liste Importations de données planifiées qui s’ouvre dans un nouvel onglet, sélectionnez l’organisation de l’instance AWS que vous souhaitez configurer.
- Sélectionnez l’importation de données planifiée que vous souhaitez activer.
- Dans le formulaire Importation de données planifiée, modifiez les valeurs de champ de la tâche planifiée.
- Sélectionnez Mettre à jour.
- Répétez les étapes 8.i.iii pour chaque tâche planifiée d’importation 8.i.v de données.
- Fermez l’onglet de la liste Importations de données planifiées et revenez à l’onglet Configuration guidée.
- Définissez la tâche Configurer les importations planifiées comme terminée en sélectionnant Marquer comme terminé dans la configuration guidée.