Configurer Connecteur du graphe de services d'API pour Apigee X à l’aide de SGC Central

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 6 minutes de lecture

    • Configurez des tâches d’importation planifiées pour extraire des Apigee X données dans votre CMDB.

    Avant de commencer

    Installez Connecteur du graphe de services d'API pour Apigee X la version 1.0.0 ou ultérieure à partir de .ServiceNow Store Pour ServiceNow Store connaître les étapes d’installation, consultez Installer une application ServiceNow Store.
    Rôle requis : la table suivante répertorie les rôles requis pour chaque étape du playbook.
    Tableau 1. Rôle requis pour chaque étape du playbook
    Étape Rôle
    Prérequis administrateur
    Configuration SGC-Admin (sn_cmdb_int_util.sgc_admin) ou administrateur
    Remarque :
    Le rôle d’utilisateur admin est nécessaire pour exécuter des scripts en arrière-plan et pour fournir un accès aux tables globales à l’utilisateur SGC-Admin. Pour en savoir plus sur les rôles d’utilisateur de , reportez-vous à Connecteurs du graphe de services la section Rôles d'utilisateur Connecteur du graphe de services.

    Pourquoi et quand exécuter cette tâche

    L’expérience de playbook pour les connecteurs d’intégration est activée SGC Central avec le Espace de travail CMDB. Pour configurer l’application, consultez et pour en savoir plus sur l’interaction avec un playbook, consultez Configurer SGC CentralInteragir avec unSGC Central playbook.

    Remarque :
    Vous pouvez également configurer une connexion par défaut déjà disponible à partir des connexions installées ou brouillon dans .SGC Central Accéder à Tous > Connecteurs du graphe de services, puis sélectionnez Configuration pour le connecteur dans le menu. Pour en savoir plus sur les connexions installées et brouillon, reportez-vous à la section Gestion des connexions ajouté pour Connecteurs du graphe de services dans SGC Central.

    Procédure

    1. Accédez à la Espaces de travail > Espace de travail CMDB.
    2. Dans le Espace de travail CMDB, sélectionnez SGC Central.
    3. Sur la page Vue d’ensemble, sélectionnez Créer une connexion.
      Conseil :
      Vous pouvez également sélectionner Créer une connexion sur la page Toutes les connexions.
    4. Dans la fenêtre Créer une connexion, sélectionnez le type de Apigee X connecteur, puis sélectionnez Créer une connexion.
    5. Remplissez les prérequis initiaux lors de la configuration d’une connexion pour la première fois à l’aide d’un connecteur.
      Remarque :
      Cette étape n’est requise que lors de la première configuration. Consultez Effectuer les tâches de configuration initiale lors de la création d’une connexion dans SGC Central.
    6. Remplissez les conditions préalables à la configuration de l’environnement Apigee X .
      1. 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.
        1. À l’étape Conditions préalables du playbook, sélectionnez l’activité Examiner les instructions de configuration .
        2. 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 Now Support base de connaissances.

          Vous devez créer un compte de service, affecter des rôles, lier des rôles au compte de service, activer les API, créer un fichier P12 et l’enregistrer dans votre ServiceNow instance.

          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 d'API pour Apigee X .

        3. Cochez la case J’ai lu les instructions de configuration pour confirmer que vous avez configuré l’environnement Apigee X conformément aux instructions.
        4. Sélectionnez Continuer.
      2. Créez un certificat X.509 pour associer le certificat Java KeyStore (JKS) de l’application Apigee X au connecteur.
        Remarque :
        Vous pouvez ignorer cette étape si vous réutilisez un certificat précédemment créé.
        1. À l’étape Conditions préalables du playbook, sélectionnez l’activité Créer le certificat X.509 .
        2. Remplissez les champs du formulaire.
          Tableau 2. Formulaire du certificat X.509
          Champ Description
          Nom Nom du certificat X.509. Par exemple, ApigeeX-509Certificate.
          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 courte Description du certificat X.509.
        3. Dans la section Pièces jointes, sélectionnez Ajouter un fichier.
        4. Parcourez et sélectionnez le fichier P12 pour le certificat JKS que vous avez créé à l’étape précédente.
        5. Dans la boîte de dialogue Charger un fichier, sélectionnez Charger.
        6. Sélectionnez Continuer.
    7. Saisissez les détails de la connexion et testez la connexion de l’API pour l’importation de Apigee X données.
      1. À l’étape Configuration du playbook, sélectionnez l’activité Créer et tester la connexion .
      2. Remplissez les champs du formulaire.
        Tableau 3. Configurer et tester le formulaire de connexion
        Champ Description
        Nom de la connexion Nom permettant d’identifier l’enregistrement de Apigee X connexion.
        E-mail du compte de service Adresse e-mail associée au compte de service utilisé pour l’authentification ServiceNow , Apigee X comme indiqué à l’étape précédente.
        Certificat X.509 Nom du certificat X.509 tel qu’indiqué à l’étape précédente.
        Mot de passe du keystore Mot de passe associé au magasin de clés, comme indiqué à l’étape précédente.
      3. Sélectionnez Créer et tester la connexion.
      4. Une fois le test de connexion terminé, sélectionnez Continuer.
    8. Définissez les propriétés de configuration pour la connexion.
      1. À l’étape Setup (Configuration ) du playbook, sélectionnez l’activité Set configuration properties (Définir les propriétés de configuration ).
      2. Entrez les propriétés.
        Tableau 4. Connexion à Graphe de services : propriétés
        Propriété Description
        Identification d'Apigee
        Nom de l’organisation Apigee/ID de projet GCP Apigee X Noms d’organisations ou GCP ID de projets à partir desquels les données doivent être extraites. Si ce champ est vide, les données sont récupérées auprès de toutes les organisations autorisées Apigee X .

        Pour plusieurs valeurs, séparez-les par des virgules.
        Configuration de la récupération de données
        Inclure des environnements Apigee X Environnements à inclure dans la connexion.

        Pour plusieurs environnements, séparez-les par des virgules. Seuls les proxys d’API dans les environnements répertoriés dans la Include environments propriété sont importés.

        Si vous laissez ce champ vide, les sources de données du connecteur importent les proxys d’API à partir de tous les environnements.
        Périodes de collecte (en jours) Durée en jours pour la collecte des données d'utilisation de l'API.
        Collecter les données d’utilisation Option permettant d’activer 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.
        Développer les types de méthodes HTTP Méthodes HTTP telles que GET, POST,PUT, PATCH,DELETE, OPTIONS, HEAD,CONNECT et TRACE, à prendre en compte pour les itinéraires.

        Pour plusieurs méthodes, séparez-les par des virgules.Si ce champ est laissé vide, un seul API Frontend est créé avec la méthode ALL , indiquant la prise en charge de toutes les méthodes HTTP standard.
        Identification de GCP
        ID de l'organization GCP GCP ID d’organisation pour la récupération des données à partir des sources de données Organisation GCP , GCP Dossier et GCP Projet.
      3. Sélectionnez Continuer.
    9. Configurez le calendrier d’importation pour importer des données à intervalles réguliers.
      1. À l’étape Setup (Configuration ) du playbook, sélectionnez l’activité Configure import schedule (Configurer le calendrier d’importation ).
      2. Développez l’importation de données planifiée parente dans la liste Importer les calendriers pour sélectionner le calendrier d’importation de l’organisation Apigee associé à votre connexion.
        Remarque :
        Le nom de la connexion est précédé du nom du calendrier.
      3. Dans la boîte de dialogue Configurer le calendrier d’importation , cochez la case Actif , puis renseignez les détails du calendrier et de l’heure d’exécution.

        Pour plus d'informations, consultez Schedule a data import.

      4. Sélectionnez Enregistrer.
        Vous pouvez également sélectionner Exécuter maintenant pour exécuter le calendrier d’importation immédiatement.
      5. Sélectionnez Continuer.
    10. À l’étape Configuration du playbook, sélectionnez l’activité Confirmer la création de la connexion pour vérifier si la connexion a été créée.

    Que faire ensuite

    Sélectionnez Afficher toutes les connexions pour examiner les détails de la connexion. La connexion configurée apparaît dans la liste des connexions installées.

    Vous pouvez ensuite gérer les connexions à partir de la SGC Central vue du Espace de travail CMDB. Pour plus d'informations, consultez Gestion des connexions ajouté pour Connecteurs du graphe de services dans SGC Central.