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

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 5 minutes de lecture

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

    Avant de commencer

    Installez Connecteur du graphe de services API pour Apigee X la version 1.0.0 ou ultérieure à partir du ServiceNow Store. Pour connaître les étapes d'installation de ServiceNow Store, consultez Installer une application ServiceNow Store.

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    L’expérience de playbook pour les connecteurs d’intégration est activée avec SGC Central .Espace de travail CMDB Pour plus d’informations sur l’interaction avec un playbook, consultez Interagir avec le playbook.

    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 conditions préalables initiales lors de la première configuration d’une connexion à l’aide d’un connecteur.
      Remarque :
      Cette étape n’est nécessaire 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 base de Now Support 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 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. Renseignez les champs du formulaire.
          Tableau 1. Formulaire Certificat X.509
          Champ Description
          Nom Nom du certificat X.509. Par exemple, SGA-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 brève 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 du certificat JKS que vous avez créé à l’étape précédente.
        5. Dans la boîte de dialogue Télé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 des Apigee X données.
      1. À l’étape Configuration du playbook, sélectionnez l’activité Créer et tester la connexion .
      2. Renseignez les champs du formulaire.
        Tableau 2. 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 avec 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 de magasin de clé 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 Configuration du playbook, sélectionnez l’activité Définir les propriétés de configuration .
      2. Entrez les propriétés.
        Tableau 3. Connexion à Graphe de services : propriétés
        Propriété Description
        Identification Apigee
        ID d'organisation Organisation au sein du Apigee X système auquel les projets appartiennent.
        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.
        Configuration de la récupération de données
        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.

        Si vous laissez ce champ vide, les sources de données du connecteur importent les données de tous les environnements.
        Période 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 de données d’utilisation pour récupérer les données d’utilisation de l’API sur une durée spécifiée.
        Configuration des performances
        Taille de page Nombre d’enregistrements par page. La valeur par défaut est 100, la valeur minimale est 2.
        Taille de la partition en octets 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.
      3. Sélectionnez Continuer.
    9. Configurez le calendrier d’importation pour importer des données à intervalles réguliers.
      1. À l’étape Configuration du playbook, sélectionnez l’activité Configurer le calendrier d’importation .
      2. Sélectionnez Configurer le calendrier d’importation.
      3. Développez l’importation de données planifiée parente dans la liste Calendriers d’importation pour sélectionner le calendrier d’importation de l’organisation SGA Apigee X .
      4. 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.

      5. Sélectionnez Enregistrer.
        Vous pouvez également sélectionner Exécuter maintenant pour exécuter immédiatement le calendrier d’importation.
      6. 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 Connexions installées.