SGC セントラル を使用して Kong Gateway の API サービスグラフコネクタを構成する

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：5分

    • Kong Gateway データを 構成管理データベース (CMDB) にプルするようにスケジュール済みインポートジョブを設定します。

    始める前に

    ServiceNow Store から Kong Gateway の API サービスグラフコネクタ バージョン 2.0.0 以降をインストールします。 インストール手順 ServiceNow Store については、「 ServiceNow Store アプリケーションのインストール」を参照してください。

    必要なロール：admin

    このタスクについて

    オンボーディングコネクタのプレイブックエクスペリエンスは、CMDB ワークスペースのSGC セントラルでアクティブ化されます。SGC セントラル アプリケーションを構成するには「SGC セントラルの構成」を参照し、プレイブックの操作方法の詳細については「プレイブックの操作」を参照してください。

    手順

    1. 移動先 ワークスペース > CMDB ワークスペース.
    2. CMDB ワークスペースで SGC セントラル を選択します。
    3. [概要] ページで、[接続を作成] を選択します。
      ヒント:
      または、 [すべての接続] ページで [接続を作成] を選択することもできます。
    4. [接続を作成] ウィンドウで、Kong コネクタタイプを選択し、[接続を作成] を選択します。
    5. コネクタを使用して初めて接続を設定するときは、最初の前提条件を満たしてください。
      注:
      この手順は、初回セットアップ時にのみ必要です。「で接続を作成するときに初期セットアップタスクを実行する SGC セントラル」を参照してください。
    6. 接続を作成する認証タイプのテンプレートを選択します。
      1. プレイブックの [セットアップ (Setup)] ステージで、[エイリアステンプレートを選択 (Select alias template)] アクティビティを選択します。
      2. テンプレートタイプを選択します。
        • Kong RBAC 認証:トークンベースの認証を使用する場合に選択します。
        • Kong ベーシック認証:ベーシック認証を使用する場合に選択します。
    7. 接続の詳細を入力し、Kong Gateway データをインポートするための API 接続をテストします。
      1. プレイブックの [セットアップ (Setup)] ステージで、[接続を構成してテスト (Configure and test connection)] アクティビティを選択します。
      2. フォームのフィールドに入力します。
        表 : 1. [接続を構成してテスト (Configure and test connection)] フォーム
        フィールド 説明
        接続名 Kong Gateway接続レコードを識別する名前です。
        ホスト名 Kong Admin API サーバーの管理 URL アドレス。
        プロトコル クライアントと Kong サーバー間の安全な通信を確保する接続に使用されるプロトコル。
        デフォルトポートを上書き Kong Admin API によって使用されるポート。
        API キー Kong Gateway サービスに接続するための認証シークレット。このフィールドは、[エイリアステンプレートを選択] アクティビティで Kong RBAC 認証が選択されている場合にのみ表示されます。
        ユーザー名 Kong Gateway Admin API への要求を認証するために必要なユーザー名。このフィールドは、[エイリアステンプレートを選択] アクティビティで Kong ベーシック認証が選択されている場合にのみ表示されます。
        パスワード 要求の認証に必要なユーザー名に関連付けられたパスワード。このフィールドは、[エイリアステンプレートを選択] アクティビティで Kong ベーシック認証が選択されている場合にのみ表示されます。
      3. [接続の作成とテスト (Create and test connection)] を選択します。
      4. 接続テストが完了したら、[続行] を選択します。
    8. オプション: 接続の構成プロパティを設定します。
      1. プレイブックの [セットアップ (Setup)] ステージで、[構成プロパティを設定 (Set configuration properties)] アクティビティを選択します。
      2. [Exclude workspaces] フィールドに、インポートから除外する必要があるワークスペースを入力します。

        ワークスペースが複数ある場合は、カンマで区切ります。たとえば、workspace1,workspace2 のようにします。このフィールドを空のままにすると、コネクタ内のデータソースはすべてのワークスペースからデータをインポートします。

      3. Kong Gatewayサービスからタグを取り込むには、[タグのインポート] チェックボックスをオンにします。
        選択した場合、[ タグ値セパレーター ] フィールドでタグのキーと値のペアのセパレーターを指定します。選択しない場合、タグはフェッチされません。
      4. [ タグ値セパレーター ] フィールドで、タグのキーと値のセパレーターを入力します。
        たとえば、タグ値の区切り文字が = に設定されている場合、タグ env=prod は、 env をキーとして、 prod を値として保存されます。

        空のままにすると、タグは取り込まれません。

      5. [Continue (続行)] を選択します。
    9. 定期的にデータをインポートするようにインポートスケジュールを構成します。
      1. プレイブックの [セットアップ (Setup)] ステージで、[インポートスケジュールの構成 (Configure import schedule)] アクティビティを選択します。
      2. [インポートスケジュールの構成 (Configure import schedule)] を選択します。
      3. [スケジュールをインポート] リストで [親スケジュール済みデータインポート] を展開して、 SG-Kong Gateway のインポートスケジュールを選択します。
      4. [ インポートスケジュールの構成 ] ダイアログボックスで、[ アクティブ ] チェックボックスをオンにして、実行スケジュールと時間の詳細を入力します。

        詳細については、「Schedule a data import」を参照してください。

      5. [Save (保存)] を選択します。
        または、[ 今すぐ実行] を選択して、インポートスケジュールをすぐに実行します。
      6. [Continue (続行)] を選択します。
    10. プレイブックの [セットアップ (Setup)] ステージで、[接続のセットアップの確認 (Confirm connection setup)] アクティビティを選択して、接続が構成されているかどうかを確認します。

    次のタスク

    [すべての接続を表示 (View all connections)] を選択して、接続の詳細を確認します。構成された接続が [インストール済み接続 (Installed connections)] リストに表示されます。