Configurer API Connecteur du graphe de services pour Kong Gateway à l’aide de la configuration guidée

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 11 minutes de lecture

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

    Avant de commencer

    Important :
    À moins de problèmes de configuration, utilisez la vue dans pour SGC CentralEspace de travail CMDB configurer la connexion du connecteur, car la méthode de configuration guidée est en cours de dépréciation.
    Dépendances et exigences :
    • 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.

    Pour l’authentification de base, obtenez le nom d’utilisateur et le mot de passe requis pour authentifier les demandes auprès de l’API Kong Gateway Admin .

    Pour l’authentification basée sur les jetons, obtenez la clé API pour la Kong Gateway connexion au service.

    Rôle requis : admin

    Procédure

    1. Vérifiez que le périmètre de l’application est défini sur l’application API Connecteur du graphe de services pour Kong Gateway à l’aide du sélecteur d’application.
      Pour plus d’informations, voir Sélecteur d’application.
    2. Accédez à la Tous > Connecteurs du graphe de services > Passerelle Kong > Configuration.
    3. Configurez le type d’authentification, les informations d’identification et les détails de connexion HTTP.
      1. Dans la section Configurer la connexion et les informations d’identification de la page Intégration de Kong Gateway avec CMDB , sélectionnez Démarrer.
      2. Configurez le type d’authentification.
        1. Pour la tâche Définir le type d’authentification , sélectionnez Configurer.
        2. Définissez la Auth Type propriété sur l’une des valeurs suivantes :
          • De base : authentification de base qui utilise un nom d’utilisateur et un mot de passe.
          • Jeton : authentification basée sur un jeton qui utilise un nom d’utilisateur et un mot de passe pour récupérer un jeton.
        3. Sélectionnez Mettre à jour.
        4. Définissez la tâche Définir le type d’authentification comme terminée en sélectionnant Marquer comme terminé.
      3. Configurez les informations d’identification de l’authentification utilisées pour envoyer des demandes à l’API Kong Gateway Admin .
        1. Pour la tâche Configurer la connexion , sélectionnez Configurer.
        2. En fonction du type d’authentification, sélectionnez le type de connexion.
          • Pour l’authentification de base, sur la page Connexions, recherchez et sélectionnez Authentification de base Kong , puis sélectionnez Afficher les détails.
          • Pour l’authentification basée sur un jeton, dans la page Connexions, recherchez et sélectionnez Authentification RBAC Kong , puis sélectionnez Afficher les détails.
        3. Modifiez les détails d’authentification de base disponibles par défaut.
          Remarque :
          Ignorez cette étape si vous utilisez l’authentification basée sur les jetons.
          1. Dans la section Informations de connexion de la fenêtre Modifier la connexion, renseignez les champs.
            Tableau 1. Information de connexion
            Champ Description
            Nom de la connexion Nom permettant d’identifier l’enregistrement de Kong Gateway connexion.

            L’authentification de base Kong est le nom de connexion par défaut. Vous pouvez ajouter plusieurs Kong Gateway instances. Toutefois, essayez de ne pas modifier le nom de connexion par défaut.
            Nom d'hôte Nom du domaine cible ou adresse IP utilisée pour accéder à l’instance Kong Gateway .
            Protocole Protocole utilisé pour la connexion assurant une communication sécurisée entre le client et le Kong serveur. Ce champ est automatiquement défini sur https. Les valeurs valides sont :
            • http
            • https
            Remplacer le port par défaut Port utilisé par l’API Kong Admin .
          2. Renseignez les champs de la section Informations d’identification de la fenêtre Modifier la connexion.
            Tableau 2. Informations d'identification
            Champ Description
            Nom d'utilisateur Nom d’utilisateur requis pour authentifier les demandes à l’API Kong Gateway Admin , comme indiqué dans la section Avant de commencer .
            Mot de passe Mot de passe associé au nom d’utilisateur requis pour authentifier les demandes, comme indiqué dans la section Avant de commencer .
          3. Sélectionnez Modifier la connexion.
        4. Modifiez les détails d’authentification basés sur un jeton disponibles par défaut.
          Remarque :
          Ignorez cette étape si vous utilisez l’authentification de base.
          1. Dans la section Informations de connexion de la fenêtre Modifier la connexion, renseignez les champs.
            Tableau 3. Information de connexion
            Champ Description
            Nom de la connexion Nom permettant d’identifier l’enregistrement de Kong Gateway connexion.

            L’authentification RBAC Kong est le nom de connexion par défaut. Vous pouvez ajouter plusieurs Kong Gateway instances. Toutefois, essayez de ne pas modifier le nom de connexion par défaut.
            Nom d'hôte Nom du domaine cible ou adresse IP utilisée pour accéder à l’instance Kong Gateway .
            Protocole Protocole utilisé pour la connexion assurant une communication sécurisée entre le client et le Kong serveur. Ce champ est automatiquement défini sur https. Les valeurs valides sont :
            • http
            • https
            Remplacer le port par défaut Port utilisé par l’API Kong Admin .
          2. Dans la section Informations d’identification de la fenêtre Modifier la connexion, dans le champ Clé API , saisissez le secret d’authentification pour vous connecter au Kong Gateway service, comme indiqué dans la section Avant de commencer .
          3. Sélectionnez Modifier la connexion.
        5. Configurez la tâche de connexion comme terminée en sélectionnant Marquer comme terminé.
      4. Configurez les propriétés pour contrôler le périmètre de la récupération de données.
        1. Pour la tâche Définir les propriétés de configuration , sélectionnez Configurer.
        2. Dans la liste connexe Propriétés de connexion à Graphe de services, configurez les propriétés.
          Tableau 4. Propriétés
          Propriété Description
          Exclure des espaces de travail Nom de l’espace de travail à exclure. Les entités de cet espace de travail ne seront pas renseignées dans le Kong Gateway service.

          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.
          Importer les balises Balises à ingérer à partir du Kong Gateway service.

          Pour plusieurs balises, séparez-les par des virgules.

          Si spécifié, entrez le séparateur de paires clé-valeur pour les balises de la Tags Value Separator propriété. Si cette option n’est pas spécifiée, les balises ne sont pas récupérées.
          Séparateur de valeurs de balises 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 vide, aucune balise n’est ingérée.
          Remarque :
          Les Auth Typepropriétés , Workspaceset Load Balancers sont renseignées automatiquement.
        3. Définissez la tâche Définir les propriétés de configuration comme terminée en sélectionnant Marquer comme terminé.
      5. Testez la connexion.
        1. Pour la tâche Test de la connexion , sélectionnez Configurer.
        2. 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.

        3. 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.

        4. Définissez la tâche Test de la connexion comme terminée en sélectionnant Marquer comme terminé.
    4. Facultatif : Ajouter plusieurs instances.
      Remarque :
      Si vous n’avez pas besoin d’ajouter plusieurs instances, vous pouvez ignorer cette étape.
      1. Dans la section Ajouter plusieurs instances de la page Intégration de Kong Gateway avec CMDB , sélectionnez Démarrer.
      2. Activez la création de sources de données pour la nouvelle Kong Gateway connexion.
        1. Assurez-vous de disposer des autorisations de modification pour la table Source de données [sys_data_source].
        2. Pour la tâche Mettre à jour l’accès à la source de données , sélectionnez Configurer.
        3. Pour modifier l’enregistrement, sélectionnez le périmètre de l’application dans le sélecteur d’application.
        4. Dans la liste connexe Accès à l’application du formulaire Mettre à jour l’accès à la source de données, cochez les cases Peut créer, Peut mettre à jour et Peut supprimer .
        5. Sélectionnez Mettre à jour.
        6. Sélectionnez l’application API Connecteur du graphe de services pour Kong Gateway à l’aide du sélecteur d’application.
        7. Définissez la tâche Mettre à jour l’accès à la source de données comme terminée en sélectionnant Marquer comme terminé.
      3. Pour activer la création de sources de données pour la nouvelle connexion, effacez le cache des tables Source de données [sys_data_source] et Tables [sys_db_object].
        Pour effacer le cache :
        1. Pour la tâche Effacer le cache , sélectionnez Configurer.
        2. Dans la zone de texte Exécuter le script de la page de script d’arrière-plan, entrez le script suivant :
          GlideTableManager.invalidateTable("sys_data_source");
      GlideCacheManager.flushTable("sys_data_source");
      GlideTableManager.invalidateTable("sys_db_object");
      GlideCacheManager.flushTable("sys_db_object");
        3. Sélectionnez Exécuter le script pour exécuter le script d’arrière-plan dans le champ d’application global .

          L’exécution du script peut prendre plusieurs minutes.

        4. Une fois le script exécuté, sélectionnez Fermer.
        5. Sélectionnez l’application API Connecteur du graphe de services pour Kong Gateway à l’aide du sélecteur d’application.
        6. Définissez la tâche Effacer le cache comme terminée en sélectionnant Marquer comme terminé.
      4. Ajoutez une nouvelle connexion.
        1. Pour la tâche Ajouter une autre connexion , sélectionnez Configurer.
        2. En fonction du type d’authentification, sélectionnez le type de connexion.
          • Pour l’authentification de base, sur la page Connexions, recherchez et sélectionnez Authentification de base Kong , puis sélectionnez Ajouter une connexion.
          • Pour l’authentification basée sur les jetons, dans la page Connexions, recherchez et sélectionnez Authentification RBAC Kong , puis sélectionnez Ajouter une connexion.
        3. Renseignez les détails d’authentification de base.
          Remarque :
          Ignorez cette étape si vous utilisez l’authentification basée sur les jetons.
          1. Dans la section Informations de connexion de la fenêtre Créer une connexion, renseignez les champs.
            Tableau 5. Information de connexion
            Champ Description
            Nom de la connexion Nom permettant d’identifier l’enregistrement de Kong Gateway connexion.
            Nom d'hôte Nom du domaine cible ou adresse IP utilisée pour accéder à l’instance Kong Gateway .
            Protocole Protocole utilisé pour la connexion assurant une communication sécurisée entre le client et le Kong serveur. Ce champ est automatiquement défini sur https. Les valeurs valides sont :
            • http
            • https
            Remplacer le port par défaut Port utilisé par l’API Kong Admin .
          2. Renseignez les champs de la section Informations d’identification de la fenêtre Créer une connexion.
            Tableau 6. Informations d'identification
            Champ Description
            Nom d'utilisateur Nom d’utilisateur requis pour authentifier les demandes à l’API Kong Gateway Admin , comme indiqué dans la section Avant de commencer .
            Mot de passe Mot de passe associé au nom d’utilisateur requis pour authentifier les demandes, comme indiqué dans la section Avant de commencer .
          3. Sélectionnez Créer une connexion.
        4. Renseignez les détails de l’authentification basée sur un jeton.
          Remarque :
          Ignorez cette étape si vous utilisez l’authentification de base.
          1. Dans la section Informations de connexion de la fenêtre Créer une connexion, renseignez les champs.
            Tableau 7. Information de connexion
            Champ Description
            Nom de la connexion Nom permettant d’identifier l’enregistrement de Kong Gateway connexion.
            Nom d'hôte Nom du domaine cible ou adresse IP utilisée pour accéder à l’instance Kong Gateway .
            Protocole Protocole utilisé pour la connexion assurant une communication sécurisée entre le client et le Kong serveur. Ce champ est automatiquement défini sur https. Les valeurs valides sont :
            • http
            • https
            Remplacer le port par défaut Port utilisé par l’API Kong Admin .
          2. Dans la section Informations d’identification de la fenêtre Créer une connexion, dans le champ Clé API , saisissez le secret d’authentification pour vous connecter au Kong Gateway service, comme indiqué dans la section Avant de commencer .
          3. Sélectionnez Créer une connexion.
        5. Définissez la tâche Ajouter une autre connexion à terminer en sélectionnant Marquer comme terminé.
      5. Configurez les propriétés pour la nouvelle connexion.
        1. Pour la tâche Définir les propriétés de configuration pour une nouvelle connexion , sélectionnez Configurer.
        2. Dans la colonne Nom, sélectionnez l’enregistrement de connexion de la nouvelle connexion.
        3. Dans la liste connexe Propriétés de connexion à Graphe de services, configurez les propriétés.
          Tableau 8. Propriétés
          Propriété Description
          Exclure des espaces de travail Nom de l’espace de travail à exclure. Les entités de cet espace de travail ne seront pas renseignées dans le Kong Gateway service.

          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.
          Importer les balises Balises à ingérer à partir du Kong Gateway service.

          Pour plusieurs balises, séparez-les par des virgules.

          Si spécifié, entrez le séparateur de paires clé-valeur pour les balises de la Tags Value Separator propriété. Si cette option n’est pas spécifiée, les balises ne sont pas récupérées.
          Séparateur de valeurs de balises 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 vide, aucune balise n’est ingérée.
          Remarque :
          Les Auth Typepropriétés , Workspaceset Load Balancers sont renseignées automatiquement.
        4. Sélectionnez Mettre à jour.
        5. Définissez les propriétés de configuration définies pour la nouvelle connexion à terminer en sélectionnant Marquer comme terminé.
      6. Testez la nouvelle connexion.
        1. Pour la tâche Tester les nouvelles connexions , sélectionnez Configurer.
        2. Dans la colonne Nom, sélectionnez l’enregistrement de connexion de la nouvelle connexion.
        3. 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.

        4. 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.

        5. Définissez la tâche Tester les nouvelles connexions comme terminée en sélectionnant Marquer comme terminé.
      7. Répétez les étapes de 4.a jusqu’à 4.f pour ajouter une autre instance.
    5. Configurez les tâches d’importation planifiées.
      1. Dans la section Configurer des tâches d’importation planifiée de la page Intégration de Kong Gateway avec CMDB , sélectionnez Démarrer.
      2. Pour la tâche Configurer l’importation planifiée , sélectionnez Configurer.
      3. Dans la colonne Nom, sélectionnez la tâche planifiée parent Passerelle SG-Kong
      4. 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.

      5. Cochez la case Actif pour activer l’importation planifiée de SG-Kong Gateway.
      6. Dans le champ Exécuter , sélectionnez Périodiquement pour spécifier la fréquence d’exécution de la tâche.
      7. Sélectionnez Mettre à jour.
      8. Configurez la tâche d’importation planifiée comme terminée en sélectionnant Marquer comme terminé.