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

MuleSoft Anypoint Platform データを CMDB にプルするようにスケジュール済みインポートジョブを設定します。

始める前に

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

MuleSoft Anypoint Platformアドミニストレーターから接続済みアプリの認証情報を取得します。次の詳細情報をメモします。

• クライアント ID: 接続済みアプリの一意の識別子。
• クライアントシークレット: 接続済みアプリを認証するための秘密鍵。
• ディレクトリー (テナント) ID:データのインポート元の MuleSoft 組織の識別子。

コネクタセットアップの詳細については、Now Support ナレッジベースの記事「API Service Graph connector for MuleSoft - Setup Instructions [KB2560348]」を参照してください。

必要なロール:次の表は、プレイブックの各ステージに必要なロールを示しています。

表 : 1. 各プレイブックステージに必要なロール

ステージ	ロール
必須条件	アドミン
セットアップ	SGC-Admin (sn_cmdb_int_util.sgc_admin) または admin

注:

バックグラウンドスクリプトを実行し、SGC-Admin ユーザーにグローバルテーブルへのアクセス権を付与するには、admin ユーザーロールが必要です。サービスグラフコネクタのユーザーロールの詳細については、「サービスグラフコネクタ ユーザーロール」を参照してください。

このタスクについて

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

注:

または、 SGC セントラル のインストール済み接続またはドラフト接続から既に利用可能なデフォルトの接続を構成することもできます。検索項目 すべて > サービスグラフコネクタをクリックし、メニューからコネクタの [セットアップ ] を選択します。インストール済み接続とドラフト接続の詳細については、「 SGC セントラル で サービスグラフコネクタ用に追加された接続の管理」を参照してください。

手順

1. 移動先 ワークスペース > CMDB ワークスペース.
2. CMDB ワークスペースで SGC セントラル を選択します。
3. [概要] ページで、[接続を作成] を選択します。
   ヒント:

   または、 [すべての接続] ページで [接続を作成] を選択することもできます。
4. [接続を作成] ウィンドウで、MuleSoft コネクタタイプを選択し、[接続を作成] を選択します。
5. コネクタを使用して初めて接続を設定するための最初の前提条件を満たします。
   注:

   この手順は、初回セットアップ時にのみ必要です。「SGC セントラルで接続を作成するときの初期セットアップタスクの実行」を参照してください。
6. 接続の詳細を入力し、MuleSoft データをインポートするための API 接続をテストします。
   1. プレイブックの [セットアップ (Setup)] ステージで、[接続を作成してテスト (Create and test connection)] アクティビティを選択します。
   2. フォームのフィールドに入力します。

      表 : 2. [接続を作成してテスト (Create and test connection)] フォーム

      フィールド	説明
      接続名	MuleSoft接続レコードを識別する名前です。 たとえば、 MuleSoft 接続などです。
      接続 URL	MuleSoft Anypoint Platform API サービスにコネクトするためのベース URL。 注: このフィールドは、アプリケーションにコネクトするための URL に自動的に設定されます。フィールド値はそのままにします。
      OAuth クライアント ID	「事前準備」セクションに記載されている、MuleSoft接続済みアプリのクライアント ID。
      OAuth クライアントシークレット	「事前準備」セクションで説明されている、MuleSoft接続済みアプリのクライアントシークレット。
      OAuth トークン URL	ID を安全に認証し、API を介して MuleSoft Anypoint Platform API アカウントへのアクセスを許可するために使用されるトークンエンドポイント URL。

   3. [接続の作成とテスト (Create and test connection)] を選択します。
   4. 接続テストが完了したら、[続行] を選択します。
7. 接続の構成プロパティを設定します。
   1. プレイブックの [セットアップ (Setup)] ステージで、[構成プロパティを設定 (Set configuration properties)] アクティビティを選択します。
   2. プロパティの詳細を入力します。

      表 : 3. MuleSoftの構成プロパティ

      プロパティ	説明
      データ検索構成
      組織 ID	MuleSoft API データのインポート元の組織識別子。複数の組織がある場合は、それぞれに個別の接続を作成します。 複数の組織の場合は、それぞれに個別の接続を作成します。
      環境フィルター	MuleSoft 接続に含める環境。 環境が複数ある場合は、カンマで区切ります。Environment filterプロパティにリストされている環境の API プロキシのみがインポートされます。 このフィールドを空のままにすると、コネクタ内のデータソースはすべての環境から API プロキシをインポートします。
      API Manager フィルター	API Manager インスタンスステータスフィルター。 単一の値 ( アクティブ、 非アクティブ、または 未登録) を受け入れます。指定すると、そのステータスに一致する API のみがインポートされます。 このフィールドを空のままにすると、ステータスに関係なくすべての API がインポートされます。
      展開済み API マネージャーのみ	現在ランタイムインスタンスに展開されている API のみをインポートするオプション。
      展開されたアプリケーションをインポート	展開されたアプリケーションをランタイムマネージャーからデータサービスインスタンスとして収集するオプション。
      収集期間 (日数)	API 使用状況データを収集する期間 (日数)。
      使用状況データを収集 (Collect usage data)	使用状況データ収集を有効にして、指定された期間の API 使用状況メトリクスを取得するオプション。
      タグ設定
      タグのインポート	MuleSoft API マネージャーからタグを取り込むオプション。
      タグキー/値インジケーター	タグのキーと値のセパレーター。

   3. [続行] を選択します。
8. 定期的にデータをインポートするようにインポートスケジュールを構成します。
   1. プレイブックの [セットアップ] ステージで、[インポートスケジュールの構成] アクティビティを選択します。
   2. [スケジュール済みインポート] リスト内の [スケジュール設定済み親データインポート] を展開して、接続に関連付けられている Gateway インポートスケジュールを選択します。
      注:

      接続名には、スケジュール名のプリフィックスが付きます。
   3. [インポートスケジュールの構成] ダイアログボックスで、[アクティブ] チェックボックスをオンにして、実行スケジュールと時間の詳細を入力します。

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

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

次のタスク

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

その後、CMDB ワークスペースのSGC セントラルビューから接続を管理できます。詳細については、「SGC セントラル で サービスグラフコネクタ用に追加された接続の管理」を参照してください。