Configurer Connecteur du graphe de services API pour Apigee X à l’aide de la configuration guidée
Configurez des tâches d’importation planifiée pour extraire Apigee X des données dans votre CMDB.
Avant de commencer
- L’application du magasin Integration Commons for CMDB, qui est automatiquement installée. Voir Éléments communs d’intégration pour CMDB.
- L’application de stockage des modèles de classe CI CMDB, qui est automatiquement installée. Consultez Modèles de classe CI CMDB.
- 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). Consultez Request Discovery.
Rôle requis : admin
Procédure
-
Vérifiez que le périmètre de l’application est défini sur l’application Connecteur du graphe de services API pour Apigee X à l’aide du sélecteur d’application.
Pour plus d’informations, voir Sélecteur d’application.
- Accédez à la Tout > Connecteurs du graphe de services > Apigee X > Configuration.
- Sur la Connecteur du graphe de services API pour Apigee X page, sélectionnez Continuer.
-
Configurez les informations d’identification de l’authentification pour envoyer des demandes à l’application Apigee X .
- Dans la section Configurer la connexion et les informations d’identification de la Connecteur du graphe de services API pour Apigee X page, sélectionnez Démarrer.
-
Accordez l’autorisation de mise à jour de pièce jointe afin que la source de données back-end front-end SGA Apigee X puisse récupérer des fichiers à partir d’enregistrements Apigee X et les joindre à des enregistrements.
- Sélectionnez la tâche Mettre à jour l’accès à la pièce jointe .
- Sélectionnez le périmètre de l’application dans le sélecteur d’application.
- Dans la liste connexe Accès à l’application de la sous-page Pièce jointe, cochez la case Peut mettre à jour , puis sélectionnez Mettre à jour.
- Sélectionnez le périmètre de l’application dans le Connecteur du graphe de services API pour Apigee X sélecteur d’application.
- Définissez la tâche Mettre à jour l’accès à la pièce jointe comme terminée en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
-
Configurez l’environnement Apigee X et créez un certificat Java KeyStore (JKS) pour chiffrer les certificats de sécurité obtenus à partir d’une Apigee X application.
- Sélectionnez la tâche Instructions de configuration d’Apigee X .
- Passez en revue et suivez les instructions de configuration sur l’article Connecteur du graphe de services d’API pour Apigee X : instructions de configuration [KBB0010364] dans la base de Now Support connaissances.
Notez le mot de passe du keystore de destination. Vous devez spécifier ce mot de passe lors de l’importation du certificat JKS dans l’application Connecteur du graphe de services API pour Apigee X .
- Définissez la tâche Instructions de configuration d’Apigee X comme terminée en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
-
Créez un certificat X.509 pour associer le certificat Java KeyStore (JKS) de l’application Apigee X au connecteur.
- Sélectionnez la tâche Créer le certificat X.509 .
- Sélectionnez Nouveau.
- Renseignez les champs du formulaire.
Tableau 1. Formulaire Certificat X.509 Champ Description Nom Nom du certificat X.509. Par exemple, SGA-ApigeeX-509Certificate.Notification à l'expiration Utilisateurs à notifier lorsque le certificat expire. Si aucun utilisateur n’est sélectionné, l’utilisateur connecté est ajouté par défaut, ainsi que les deux derniers utilisateurs connectés disposant du rôle d’administrateur. Avertissement avant l'expiration (en jours) Nombre de jours pour envoyer une notification avant l’expiration du certificat. Actif Option permettant d’activer le certificat. Type Conteneur de certificats automatiquement défini sur Java Key Store. Laissez la valeur de champ définie sur Magasin de clés Java. Échéance en jours Nombre de jours jusqu’à l’expiration du certificat. Mot de passe de magasin de clés Mot de passe permettant d’accéder au certificat JKS, comme indiqué à l’étape précédente. Description brève Description du certificat X.509. - Sélectionnez l’icône Gérer les pièces
- Sélectionnez Choisir un fichier pour parcourir et charger le fichier keystore.p12 pour le certificat JKS que vous avez créé à l’étape 4.c.
- Fermez la boîte de dialogue.
- Sélectionnez le lien connexe Valider les banques/certificats .
- Une fois la validation réussie, sélectionnez Mettre à jour pour revenir à la page de configuration guidée.
- Définissez la tâche Créer le certificat X.509 comme terminée en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
-
Configurez la connexion.
- Vérifiez que le périmètre de l’application est défini sur l’application Connecteur du graphe de services API pour Apigee X à l’aide du sélecteur d’application.
- Sélectionnez la tâche Configurer la connexion .
- Sélectionnez Cliquer ici pour ouvrir la page Connexions dans un onglet de navigateur distinct.
- Recherchez et sélectionnez Modifier pour la connexion SGA Apigee X.
- Dans la section Informations de connexion de la fenêtre Modifier la connexion, renseignez les champs.
Tableau 2. Information de connexion Champ Description Nom de la connexion Nom permettant d’identifier l’enregistrement de Apigee X connexion. La connexion SGA Apigee Xest le nom de l’alias d’informations d’identification par défaut. Vous pouvez ajouter plusieurs Apigee X instances. Toutefois, essayez de ne pas modifier le nom de connexion par défaut. - Renseignez les champs de la section Informations d’identification de la fenêtre Modifier la connexion.
Tableau 3. Informations d'identification Champ Description E-mail du compte de service Adresse e-mail associée au compte de service utilisé pour l’authentification ServiceNow , Apigee X comme indiqué dans la section Avant de commencer . Certificat X.509 Certificat X.509 créé à l’étape 4.d. Mot de passe de magasin de clé Mot de passe associé au magasin de clés, comme indiqué dans la section Avant de commencer . - Sélectionnez Modifier et obtenir le jeton OAuth.
- Sélectionnez Mettre à jour.
- Une fois le flux de jetons OAuth terminé, revenez à la page de configuration guidée et définissez la tâche Configurer la connexion comme terminée en cochant la case Marquer comme terminé, puis en sélectionnant Continuer.
-
Configurez les propriétés du connecteur pour accéder aux ressources.
- Sélectionnez la tâche Ajouter des propriétés de configuration .
- Dans la liste connexe Propriétés de connexion du graphe de services, entrez les valeurs de ces propriétés.
Tableau 4. Connexion à Graphe de services : propriétés Propriété Description Période de collecte (jours) Durée en jours pour la collecte des données d’utilisation de l’API. CollectUsageData (en anglais seulement) Activez la collecte des données d’utilisation pour récupérer les données d’utilisation de l’API sur une durée spécifiée. Périmètre de Découverte Périmètre de découverte de l’application Apigee X . Les options disponibles sont les suivantes : - Organisation
- Sélectionnez Organisation lorsque le compte de ServiceNow service a accès aux données au sein de l’organisation Apigee X .
- projet
- Sélectionnez Projets lorsque le compte de ServiceNow service a accès aux données des Apigee X projets uniquement.
Exclure les environnements Apigee X environnements qui doivent être exclus de la connexion. Pour plusieurs environnements, séparez-les par des virgules. Toutes les passerelles, à l’exception de celles répertoriées dans la Exclude Environments propriété, sont récupérées.
ID d'organisation Organisation au sein du Apigee X système auquel le projet appartient. Taille de page Nombre d’enregistrements par page. La valeur par défaut est 100, la valeur minimale est2.Taille de partition Taille de la partition pour Apigee X les API gérées si le chargement parallèle est activé. Accepte une valeur numérique supérieure à zéro. Si ce champ est vide, la valeur est automatiquement calculée.
ID de projet Identificateur de projet dans l’environnement Apigee X auquel la connexion sera liée. Pour plusieurs ID de projet, séparez-les par des virgules.
Conseil :Pour saisir une valeur de propriété, double-cliquez (ou utilisez le raccourci clavier) pour saisir une valeur dans la cellule Valeur de la propriété. - Définissez la tâche Ajouter des propriétés de configuration comme terminée en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
-
Testez la connexion.
- Sélectionnez la tâche Test de la connexion .
- Pour tester la connexion, sélectionnez le lien connexe Test de la connexion .
Le test de la connexion peut prendre quelques instants. La page est actualisée pour afficher les résultats des tests.
- Lorsque le champ État est défini sur Réussite, sélectionnez Mettre à jour.
Si l’un des tests présente des erreurs, suivez les suggestions pour y remédier.
- Définissez la tâche Test de la connexion comme terminée en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
- Facultatif :
Intégrez à plusieurs Apigee X instances.
- Dans la section Ajouter plusieurs instances de la Connecteur du graphe de services API pour Apigee X page, sélectionnez Démarrer.
-
Activez la création de sources de données pour la nouvelle Apigee X connexion.
- Vérifiez que vous disposez des autorisations de modification pour la table Source de données [sys_data_source].
- Sélectionnez la tâche Mettre à jour l’accès à la source de données.
- Pour modifier l’enregistrement, sélectionnez le périmètre de l’application dans le sélecteur d’application.
- Dans la liste connexe Accès à l’application du formulaire Source de données qui s’ouvre dans un autre onglet, cochez les cases Peut créer, Peut mettre à jour et Peut supprimer .
- Sélectionnez Mettre à jour.
- Dans le sélecteur d’application, sélectionnez le périmètre de l’application Connecteur du graphe de services API pour Apigee X .
- Définissez la tâche Mettre à jour l’accès à la source de données comme terminée en sélectionnant la case à cocher Marquer comme terminé , puis sélectionnez Continuer.
-
Activez la création d’une tâche d’importation planifiée pour la nouvelle Apigee X connexion.
- Assurez-vous de disposer des autorisations de modification pour la table Importation de données planifiée [scheduled_import_set].
- Sélectionnez la tâche Mettre à jour l’accès à Importation de données planifiée .
- Pour modifier l’enregistrement, sélectionnez le périmètre de l’application dans le sélecteur d’application.
- Dans la liste connexe Accès à l’application du formulaire Importation de données planifiée, cochez les cases Peut créer, Peut mettre à jour et Peut supprimer .
- Sélectionnez Mettre à jour.
- Dans le sélecteur d’application, sélectionnez le périmètre de l’application Connecteur du graphe de services API pour Apigee X .
- Définissez la tâche Mettre à jour l’accès à Importation de données planifiée sur terminée en sélectionnant la case à cocher Marquer comme terminé , puis sélectionnez Continuer.
-
Videz le cache des tables Source de données [sys_data_source] et Importations de données planifiées [scheduled_import_set].
- Sélectionnez la tâche Effacer le cache des tables de source de données et d’importations de données planifiées .
- Pour modifier l’enregistrement, sélectionnez le périmètre de l’application dans le sélecteur d’application.
- Dans le champ Exécuter le script , entrez le code 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"); GlideTableManager.invalidateTable("sys_attachment"); GlideCacheManager.flushTable("sys_attachment"); - Sélectionnez Exécuter le script.
- Dans le sélecteur d’application, sélectionnez le périmètre de l’application Connecteur du graphe de services API pour Apigee X .
- Définissez la tâche Effacer le cache des tables Source de données et Importations de données planifiées sur terminer en sélectionnant Marquer comme terminé.
- Pour créer un certificat X.509 pour la nouvelle Apigee X instance, répétez l’étape4.d, puis marquez la tâche Créer un certificat X.509 à terminer en sélectionnant Marquer comme terminé.
-
Ajoutez une autre connexion pour la nouvelle Apigee X instance.
- Vérifiez que le périmètre de l’application est défini sur l’application Connecteur du graphe de services API pour Apigee X à l’aide du sélecteur d’application.
- Sélectionnez la tâche Ajouter une autre connexion , puis cliquez ici.
- Sur la page Connexions qui s’ouvre dans un autre onglet de navigateur, sélectionnez Ajouter une connexion.
- Dans la fenêtre Créer une connexion, renseignez les détails de connexion, de compte de service et du magasin de clés, y compris le mot de passe du magasin de clés.
Vous avez créé le magasin de clés à l’étape 5.e.
- Sélectionnez Créer et obtenir un jeton OAuth.
- Fermez la page Connexions et revenez à l’onglet de la page Configuration guidée.
- Définissez la tâche Ajouter une autre connexion à terminer en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
-
Ajoutez des propriétés pour la nouvelle connexion.
- Vérifiez que le périmètre de l’application est défini sur l’application Connecteur du graphe de services API pour Apigee X à l’aide du sélecteur d’application.
- Sélectionnez la tâche Ajouter des propriétés de configuration .
- Dans la colonne Nom , sélectionnez le nom de la connexion que vous avez créé à l’étape 5.f.
- Dans la liste connexe Propriétés de connexion du graphe de services, entrez les valeurs de ces propriétés.
Pour plus d’informations sur les propriétés, consultez 4.f.ii.
Conseil :Pour saisir une valeur de propriété, double-cliquez (ou utilisez le raccourci clavier) pour saisir une valeur dans la cellule Valeur de la propriété. - Définissez la tâche Ajouter des propriétés de configuration comme terminée en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
-
Testez la nouvelle connexion.
- Sélectionnez la tâche Tester les nouvelles connexions .
- Dans la colonne Nom , sélectionnez le nom de la connexion que vous avez créé à l’étape 5.f.
- Pour tester la connexion, sélectionnez le lien connexe Test de la connexion .
Le test de la connexion peut prendre quelques instants. La page est actualisée pour afficher les résultats des tests.
- Lorsque le champ État est défini sur Réussite, sélectionnez Mettre à jour.
Si l’un des tests présente des erreurs, suivez les suggestions pour y remédier.
- Définissez la tâche Test des nouvelles connexions à terminer en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
-
Configurez la tâche planifiée pour l’importation de Apigee X données.
- Dans la section Configurer des tâches d’importation planifiée de la Connecteur du graphe de services API pour Apigee X page, sélectionnez Démarrer.
-
Sélectionnez la tâche planifiée de l’organisation SGA Apigee X .
Pour une configuration à instances multiples, sélectionnez l’importation planifiée créée avec la connexion dans l’étape 5.f.
-
Sur le formulaire Importation de données planifiée, vérifiez les valeurs des champs.
Pour plus d'informations, consultez Schedule a data import.
- Cochez la case Actif pour activer la tâche planifiée.
- Dans le champ Exécuter , sélectionnez Périodiquement pour spécifier la fréquence d’exécution de la tâche.
- Sélectionnez Mettre à jour.
- Définissez la tâche Configurer des tâches d’importation planifiée à terminer en cochant la case Marquer comme terminé , puis sélectionnez Continuer.
- Sur la Connecteur du graphe de services API pour Apigee X page, sélectionnez Terminé pour enregistrer vos changements.
- Dans la boîte de dialogue Terminer la configuration, sélectionnez Terminer pour terminer la configuration.
- Dans la zone de message qui s’affiche, sélectionnez Terminé.