Apigee Edge Enterprise エディションの検出

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：6分

    • ServiceNow ディスカバリー アプリケーションでは、APIGee パターンを使用して Apigee Edge Enterprise エディションのバージョン 4.x.x を検索します。 これらのリソースを検出するには、ServiceNow Store から ディスカバリーとサービスマッピングパターン アプリケーションをアップデートする必要があります。

    APIGee パターンでは、組み込みのキャッシュメカニズムを使用して、各 API サービスからローカルキャッシュファイルにデータを収集します。サービスマッピング は、こうしたキャッシュファイルに対してトップダウンディスカバリーを実行し、Apigee Edge の発信接続を検出します。

    ストアでアプリを要求する

    ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。

    前提条件

    Linux ユーザー
    Linux オペレーティングシステム (OS) ユーザーに、cat、ls、netstat、および stat コマンドを実行するための昇格した権限を付与します。詳細については、「特権ユーザーを必要とする サービスマッピング コマンド」を参照してください。
    さらに、この Linux ユーザーに、OS ユーザーのホームフォルダーで次のコマンドを実行する権限を付与します。
    コマンド 説明
    "date +%s" 現在の日付を取得します。
    "ls -d $HOME/APIGee_Cache/cache_folder*" 最新のキャッシュフォルダーを取得します。
    "mkdir-p $HOME/APIGee_Cache/cache_folder_" + $today + ";ls -d$HOME/APIGee_Cache/cache_folder_" + $today キャッシュファイルが空の場合、キャッシュファイルを作成します。
    "ls -d $HOME/APIGee_Cache/cache_folder*" キャッシュファイルが作成されたことを確認します。
    "echo `expr " + $today + " -" + $current_date+ "`” フォルダー作成時間と現在の日付との差を計算します。
    "if [ " + $diff + " -ge" + $week_seconds+ " ]; then echo true; fi” フォルダーを再作成する必要があるかどうかを確認します。
    "ls" + $cache_folder+ "/* | sort | xargsgrep -l " + $entry_point.source_url 既存のキャッシュファイルに、サービスのエントリーポイントとして入力するソース URL が含まれているかどうかを確認します。
    "rm-rf" + $cache_folder+ ";mkdir-p $HOME/APIGee_Cache/cache_folder_" + $today + ";ls -d $HOME/APIGee_Cache/cache_folder_" + $today 古いキャッシュファイルを削除します。
    “curl -k -X GETurl-H '<ClientID>: <Token>’” 指定されたトークンの API 応答を取得します。
    "ls" + $cache_folder+ "/* | sort | xargsgrep -l " + $entry_point.source_url キャッシュファイルから URL 定義を取得します。
    適用可能な認証情報
    次のように、アプリケーションの認証情報を設定します。
    表 : 1. 適用可能な認証情報フォーム
    フィールド 説明
    名前 認証情報名 (例：Apigee トークン)。
    アクティブ この認証情報をディスカバリーで有効にするためのチェックボックス。
    ユーザー名 この適用可能な認証情報のユーザーの名前。情報はローカルキャッシュから抽出されるため、このパターンの認証情報の任意のユーザーを使用できます。
    パスワード この適用可能な認証情報の実際のユーザーパスワード。
    CI タイプ この認証情報が使用される CI タイプ：APIGee サービス [cmdb_ci_appl_apigee_srv]。
    注:
    ServiceNowアプリケーションは、構成アイテム (CI) としてアプリケーションサービスを構成するデバイスおよびアプリケーションを参照します。
    適用先 これらの認証情報をネットワーク内の [すべての MID サーバー] または 1 つ以上の [特定の MID サーバー] に適用するかどうかを選択します。[MID サーバー] フィールドでこれらの認証情報を使用する MID サーバーを指定します。
    順序 プラットフォームがデバイスにログオンしようとするときに、この認証情報を試行する順序 (シーケンス) を入力します。番号が小さいほど、この認証情報がリストの上位に表示されます。多くの認証情報を使用する場合、またはログイン試行が 3 回失敗してセキュリティによってユーザーがロックアウトされた場合、認証情報の順序を確立します。すべての認証情報の順序番号が同じ (または順序番号がない) 場合、インスタンスは認証情報をランダムな順序で試行します。
    curl コマンド
    curl コマンドが、Apigee Edge をホストする Linux サーバーにインストールされていることを確認します。
    システムのプロパティを構成する
    • トップダウンの Apigee Edge 発信接続を作成するには、Apigee URLs (apigee.urls) システムのプロパティを次の構文を使用して構成します。

      01#DVL#https://<url1>.com/dashboard/v1/targetServers/dvl### 02#QA#https://<url2>.com/dashboard/v2/targetServers/qa###

      どこで

      01 は URL 番号です。

      DVL は、開発などの環境タイプです。

      # は、属性間の区切り文字です。上記の例と同じ場所に正確に配置します。

      ### は、URL 間の区切り文字です。

    • [値] フィールドに Apigee API クライアント ID を入力して、Apigee API クライアント ID (apigee.api.client.id) システム プロパティを構成します。このパターンでは、トークンを含む curl コマンドのヘッダーとして、このプロパティを使用します。

      curl -k -X GET " + url + " -H ' apigee.api.client.id: " + token

    このパターンでは Add Apigee URL and Apigee api client id sa_pre_task_script を使用して、これら 2 つのシステムのプロパティを設定します。

    Apigee Edge Enterprise エディションで ディスカバリー によって収集されるデータ

    ディスカバリー APIGee パターンの実行時に CMDB にデータを入力します。

    表 : 2. APIGee サービス [cmdb_ci_appl_apigee_srv]
    Field (フィールド) 説明
    名前 [name] Apigee Edge をホストするサーバーの名前。
    バージョン [version] Apigee Edge のバージョン。
    インストールディレクトリ [install_directory] すべての Apigee Edge ライブラリおよび実行可能ファイルを格納するフォルダー。
    構成ディレクトリ [config_directory] すべての Apigee Edge 構成ファイルを格納するフォルダー。

    CI 関係

    APIGee パターンでは CI 関係を作成しません。

    トップダウンディスカバリー中に サービスマッピング によって収集されるデータ

    APIGee パターンでは、パターンの接続セクションで設定する URL に基づいて、Apigee Edge から他の CI への接続を識別します。