macOS への エージェントクライアントコレクター の手動インストール

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

    • エージェントがインスタンスに接続されていないか、拡張されたカスタマイズオプションを希望する場合は、macOS を使用しているマシンに エージェントクライアントコレクター を手動でインストールします。

    始める前に

    • エージェントクライアントコレクター Web サーバーが構成されていることを確認します。
    • 「エージェントクライアントコレクター のインストール」に記載したように、サーバーの OS とバージョンがサポート対象 OS バージョンのリストと一致していることを確認します。
    • /Library/Preferences/acc.rc.plist にあるゴールデンイメージマーカーを設定して、追加のエージェントをクローンするためのゴールデンイメージモードを有効にします。
    • 移動先 エージェントクライアントコレクター > 展開 > エージェントのダウンロード をクリックし、お使いの OS に関連する署名付き .pkg をダウンロードします。
    • インストールされているエージェントのいずれかに .pkg インストールパッケージを保存します。

    必要なロール：agent_client_collector_admin

    手順

    1. インストールファイルをローカルマシンにダウンロードします。 
      curl -L <download link from the Agent Downloads page on the instance>
    2. インストールファイルの署名を検証します。 
      pkgutil --check-signature agent-client-collector-<version number>-macos-catalina_x64.pkg
      注:
      pkg 証明書チェーンに ServiceNow 開発者 ID インストーラー証明書があることを確認します。
    3. エージェントクライアントコレクター パッケージをインストールします。 
      sudo installer -pkg agent-client-collector-<version number>-macos-catalina_x64.pkg -target /
    4. インストールファイルをコピーします。
      1. 構成ファイルの例：
        sudo cp -p /Library/Application\ Support/servicenow/agent-client-collector/acc.yml.example /Library/Application\ Support/servicenow/agent-client-collector/acc.yml
      2. 許可リストファイルの例：
        sudo cp -p /Library/Application\ Support/servicenow/agent-client-collector/check-allow-list.json.default /Library/Application\ Support/servicenow/agent-client-collector/check-allow-list.json
    5. オプション: 許可リストに含める新しいチェック定義を作成するには、最初に acc.yml ファイルの allow-list パラメーターをコメントアウトして、許可リストを無効にします。

      sudo -H -u _servicenow vi /Library/Application\ Support/servicenow/agent-client-collector/acc.yml

      注:
      このアクションはシステムのセキュリティ侵害になるので、許可リストの更新が完了するまでの一時的な手段として限定的に使用することをお勧めします。更新が完了したら、構成ファイルの許可リストパラメーターをコメント解除し、許可リストを再度有効化します。

      カスタムチェックを許可リストに追加する方法の詳細については、「エージェントクライアントコレクター 許可リストの生成」を参照してください。

    6. 構成ファイルを保存します。
    7. 構成ファイルで、エージェントを MID サーバー に接続します。
      1. MID サーバー 接続を設定します。 
        "wss://<MID Server IP>:<Web Socket Port>/ws/events"

        WebSocket ポートは、エージェントクライアントコレクター リスナーとして設定された場合は、MID サーバー で構成されています。

      2. api-key パラメーターを検索し、API キー値を次のように二重引用符で囲んで指定します。
        api-key:"111111111"
        指定した API キーは、エージェントの初回実行時に暗号化されます。
    8. 構成ファイルが有効なエンドポイントを指すようにするには、次のコマンドを実行して、エージェントクライアントコレクターを再起動します。 
      sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist
sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist
      注:
      デフォルトでは、インストールプログラムを終了するとすぐに再起動します。終了後もプログラムが停止したままになるようにするには、/Library/LaunchDaemons/com.sn.acc.plist ファイルの KeepAlive プロパティを false に設定します。