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

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

    • Configurez des tâches d’importation planifiées pour extraire des Kong Gateway données dans votre Base de données de gestion des configurations (CMDB).

    Avant de commencer

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

    Si vous configurez la connexion Prometheus, activez le module d’extension Kong Gateway Prometheus et vérifiez que toutes les informations d’identification requises sont disponibles. Pour en savoir plus sur le module d’extension Prometheus, consultez Prometheus sur le site de documentation du Kong développeur.

    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 Kong 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. Sélectionnez un modèle pour le type d’authentification afin de créer une connexion.
      1. À l’étape Setup (Configuration ) du playbook, sélectionnez l’activité Sélectionner un alias de modèle .
      2. Sélectionnez un type de modèle.
        • Authentification RBAC Kong : sélectionnez lors de l’utilisation de l’authentification basée sur un jeton.
        • Authentification de base Kong : sélectionnez lors de l’utilisation de l’authentification de base.
    7. Saisissez les détails de la connexion et testez la connexion de l’API pour l’importation de Kong Gateway 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 2. Formulaire Créer et tester la connexion
        Champ Description
        Nom de la connexion Nom permettant d’identifier l’enregistrement de Kong Gateway connexion.
        Nom d'hôte Adresse URL d’administrateur du serveur d’API Kong Admin .
        Protocole Protocole utilisé pour la connexion assurant une communication sécurisée entre le client et le Kong serveur.
        Remplacer le port par défaut Port utilisé par l’API Kong Admin .
        Clé API Secret d’authentification Kong Gateway pour se connecter au service. Ce champ s’affiche uniquement lorsque l’authentification RBAC Kong est sélectionnée dans l’activité Sélectionner un modèle d’alias .
        Nom d'utilisateur Nom d’utilisateur requis pour authentifier les demandes à l’API Kong Gateway Admin . Ce champ apparaît uniquement lorsque l’authentification de base Kong est sélectionnée dans l’activité Sélectionner un modèle d’alias .
        Mot de passe Mot de passe associé au nom d’utilisateur requis pour authentifier les demandes. Ce champ apparaît uniquement lorsque l’authentification de base Kong est sélectionnée dans l’activité Sélectionner un modèle d’alias .
      3. Sélectionnez Créer et tester la connexion.
      4. Une fois le test de connexion terminé, sélectionnez Continuer.
    8. Facultatif : 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. Dans le champ disponible dans la Expand HTTP Method Types section Configuration de la récupération de données, entrez les méthodes HTTP, notamment 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.
      3. Dans le champ disponible dans la Exclude workspaces section Paramètres de propriété, saisissez l’espace de travail qui doit être exclu de l’importation.

        Pour plusieurs espaces de travail, séparez-les par des virgules. Par exemple : espace de travail1, espace de travail2. Si vous laissez ce champ vide, les sources de données du connecteur importent les données de tous les espaces de travail.

      4. Cochez la case Importer les balises disponible dans la section Paramètres des balises pour ingérer des balises à partir du Kong Gateway service.
        Lorsque cette option est sélectionnée, spécifiez le séparateur de paires clé-valeur pour les balises dans le champ Séparateur de valeurs de balises . Si cette option n’est pas sélectionnée, les balises ne sont pas extraites.
      5. Dans le champ Séparateur de valeur des balises disponible dans la section Paramètres des balises, entrez le séparateur pour la clé et la valeur dans les balises.
        Par exemple, si le séparateur de valeur de la balise est défini sur =, la balise env=prod est enregistrée avec env comme clé et prod comme valeur.

        Si ce champ est laissé vide, aucune balise n’est ingérée.

      6. Cochez la case Collecter les données d’utilisation disponible dans la section Paramètres des mesures pour activer la collecte de données d’utilisation afin de récupérer les données d’utilisation de l’API sur une durée spécifiée.
      7. Dans le champ Période de collecte (en jours) disponible dans la section Paramètres de mesures, saisissez la durée en jours pour la collecte des données d’utilisation de l’API.
      8. Sélectionnez Continuer.
    9. Facultatif : Saisissez les détails de connexion de Prometheus et testez la connexion de l’API pour l’importation de Kong Gateway données de mesures à l’aide du module d’extension Prometheus.
      Remarque :
      Vous pouvez ignorer cette étape si la surveillance de l’utilisation de l’API avec Prometheus n’est pas requise ou si vous utilisez une instance Prometheus existante. Pour ignorer cette étape, sélectionnez Ignorer pour l’activité Créer et tester la connexion Prometheus .
      1. À l’étape Setup (Configuration ) du playbook, sélectionnez l’activité Create and Test Prometheus Connection (Créer et tester la connexion Prometheus ).
      2. Remplissez les champs du formulaire.
        Tableau 3. Formulaire Créer et tester la connexion Prometheus
        Champ Description
        Nom de la connexion Nom permettant d’identifier l’enregistrement de connexion Prometheus .
        URL de connexion URL de base de l’API HTTP Prometheus , utilisée pour l’extraction de mesures.
        Nom d'utilisateur Nom d’utilisateur requis pour authentifier les demandes au serveur Prometheus .
        Mot de passe Mot de passe associé au nom d’utilisateur requis pour authentifier les demandes au serveur Prometheus .
      3. Sélectionnez Créer et tester la connexion.
      4. Une fois le test de connexion terminé, sélectionnez Continuer.
    10. Facultatif : Associez la connexion Prometheus à une Kong Gateway connexion.
      Remarque :
      Vous pouvez ignorer cette étape si la surveillance de l’utilisation de l’API avec Prometheus n’est pas requise. Pour ignorer cette étape, sélectionnez Ignorer pour l’activité de mappage de Kong Prometheus .
      1. À l’étape Setup (Configuration ) du playbook, sélectionnez l’activité de mappage Kong Prometheus .
      2. Dans le champ Connexions Prometheus , recherchez et sélectionnez une connexion Prometheus à associer.
        Vous pouvez sélectionner la connexion Prometheus créée à l’étape 9 ou sélectionner n’importe quelle connexion Prometheus existante au cours de cette étape. Si vous ignorez cette étape 9, sélectionnez n’importe quelle connexion Prometheus existante.
      3. Sélectionnez Envoyer.
      Une connexion Prometheus peut être associée à plusieurs Kong Gateway connexions. Vous pouvez à tout moment mettre à jour le mappage Prometheus dans la Kong Gateway connexion à partir de la SGC Central vue. Consultez Mettre à jour une connexion pour un Connecteur du graphe de services dans SGC Central.
    11. 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. 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 la passerelle SG-Kong associé à votre connexion.
        Remarque :
        Le nom de la connexion est précédé du nom du calendrier.
      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 le calendrier d’importation immédiatement.
      6. Sélectionnez Continuer.
    12. À l’étape Setup (Configuration ) du playbook, sélectionnez l’activité Confirm connection creation (Confirmer la création de la connexion) pour vérifier si la connexion a été configurée.

    Que faire ensuite

    Sélectionnez Afficher toutes les connexions pour examiner les détails de la connexion. Les connexions configurées, y compris la connexion et la Kong Gateway connexion Prometheus, le cas échéant, apparaissent 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.