macOS 用のタスクマイニングエージェントをインストールする

  • リリースバージョン: Australia
  • 更新日 2026年04月27日
  • 所要時間：8分

    • macOS ワークステーションにタスクマイニングデスクトップエージェントをインストールし、JAMF を使用して管理対象 macOS デバイスにタスクマイニングエージェントを展開します。この手順では、エンタープライズ展開に必要なパッケージ、スクリプト、ポリシー、および構成プロファイルを作成します。

    始める前に

    必要なロール: タスクマイニング エージェントのインストール
    注:
    タスクマイニング エージェントをインストールするには、ロール itil、sn_tm_core.service_user、および agent_client_collector_admin を持つ タスクマイニング エージェントインストールグループの一員である必要があります。グループが存在しない場合は、その名前とロールを持つグループを手動で作成します。詳細については、「グループへのロールのアサイン」を参照してください。

    このタスクについて

    macOS 用のタスクマイニングエージェントは、 .pkg アーカイブとして提供されます。ダウンロードと構成全体を自動的に処理する 1 行のターミナルスクリプトを使用してインストールすることも、インストーラーパッケージを手動でダウンロードして構成することもできます。

    JAMF 展開では、2 つのスクリプト、2 つのポリシー、および 1 つの構成プロファイルが作成されます。最初のスクリプトは、インストーラーに必要な JSON 構成ファイルを生成します。2 番目のスクリプトは、エージェントがインストールされているかどうかを確認し、インストールされていない場合は再インストールをトリガーします。最初のポリシーは、パッケージと構成スクリプトを組み合わせてカスタムトリガーで実行します。2 番目のポリシーは、繰り返しスケジュールでプロビジョニングスクリプトを実行します。構成プロファイルは、エージェントがデータキャプチャに必要なアクセシビリティ権限を付与します。

    手順

    1. インスタンス URL と登録キーを取得します。
      インスタンス URL と登録キーの値は、Windows エージェントと macOS エージェントで同じです。
      1. 移動先 すべて > タスクマイニング > エージェントのインストール.
      2. 既存のキーを選択するか、作成します。

        登録キーの選択のスクリーンショット

      3. [エージェントのインストール] ページでインスタンス URL と 登録キー をコピーします。

      インスタンス URL と登録キーのスクリーンショット

    2. ターミナルスクリプトを実行して、macOS エージェントをインストールします。
      1. [エージェントのインストール] ページで macOS タブを選択します。
      2. [ダウンロードとインストール] の横にある [コピー] を選択して、1 行の macOS コマンドラインスクリプトを収集します。
        macOS コマンドラインのスクリーンショット。
      3. macOS ターミナル アプリケーションを開きます。
      4. スクリプトを貼り付け、 Enter キーを押します。
      このスクリプトは、インストーラーパッケージをダウンロードし、インスタンス URL と登録キーを使用して必要な構成ファイルを生成して、インストーラーを自動的に実行します。
      注:
      手動インストールの場合は、Intel と Apple のシリコンファイルと JSON ファイルをダウンロードします。両方のファイルを同じフォルダーに配置します。JSON ファイルの名前は変更しないでください。.pkgファイルをダブルクリック (またはキーボードショートカットを使用) してインストーラーを起動し、画面の指示に従います。
      JSON と Intel & Apple Silicon のスクリーンショット。
    3. エージェントパッケージを JAMF に追加します。
      1. [JAMF 設定] で、[ パッケージ] を検索します。
      2. [新規] を選択します。
      3. パッケージ名を入力し、エージェントをアーカイブ .pkg アップロードして、パッケージを保存します。
    4. 構成スクリプトを作成します。
      1. [JAMF 設定] で、[ スクリプト] を検索します。
      2. [新規] を選択します。
      3. スクリプトに 「タスクマイニングスクリプト」という名前を付けます。
      4. [ スクリプト] タブを選択し、適切なスクリプトタイプを選択して、次のスクリプトを入力します。 
        #!/bin/bash
#set these variables in the param sections 4 and 5
REGAPIURL=$4
REGKEY=$5
TARGET="/Library/Application Support/JAMF/Downloads/"
JSON="tm-macos-agent_installer.json"

if [[ -z "REGAPIURL" || -z "REGKEY" ]]; then
    echo "reg api url and reg key must be set as 4 and 5 arguments"
    exit 1
fi

cd "$TARGET" || {
    echo "failed to change dir"
    exit 2
}

cat <<EOF > "$JSON"
{
    "agent": {
        "reg-api-url": "$REGAPIURL",
        "reg-key": "$REGKEY"
    }
}
EOF
      5. [Save (保存)] を選択します。
    5. プロビジョニングスクリプトを作成します。
      1. [ 新規 ] を選択して、別のスクリプトを追加します。
      2. スクリプトに「 Task Mining Provisioning」という名前を付けます。
      3. [ スクリプト] タブを選択し、次のスクリプトを入力します。 
        #!/bin/bash
APP_PATH="/Applications/Task Mining Agent.app"

if [ ! -d "$APP_PATH" ]; then
    echo "taskmining is not installed -> triggering install via Jamf policy"
    if ! jamf policy -event taskmining_provisioning; then
        echo "error triggering jamf policy"
        exit
    fi
else
    echo "taskmining app already installed"
fi
      4. [Save (保存)] を選択します。
    6. インストーラーポリシーを作成します。
      1. [JAMF コンピューター ] カテゴリで、 コンテンツ管理 > ポリシー をクリックし、[ 新規] を選択します。
      2. ポリシーに 「タスクマイニングインストーラー」という名前を付けます。
      3. [トリガー] で [カスタム] を選択し、[カスタムイベント] フィールドにtaskmining_provisioningを入力します。
      4. [実行頻度] を [進行中] に設定します。
      5. [Save (保存)] を選択します。
      6. [ スコープ] タブで [ 追加] を選択し、ターゲット コンピューターまたはグループを選択して、[ 完了] を選択します。
      7. サイドバーで、 オプション > パッケージ > 構成.
      8. タスクマイニングエージェントパッケージの横にある [追加 ] を選択します。
      9. サイドバーの [スクリプト ] と [構成] をクリックします。
      10. タスク マイニングスクリプト (タスクマイニングプロビジョニングではない) を見つけて、[ 追加] を選択します。
      11. [ 優先度] で [ 前] を選択します。
      12. インスタンス URL を パラメーター 4 に、登録キーを パラメーター 5 に貼り付けます。
      13. [Save (保存)] を選択します。
    7. プロビジョニングポリシーを作成します。
      1. 移動先 コンテンツ管理 > ポリシー をクリックし、[ 新規] を選択します。
      2. ポリシーに「 タスクマイニングプロビジョニング」という名前を付けます。
      3. [トリガー] で、[スタートアップ]、[ログイン]、および [繰り返しチェックイン] を選択します。
      4. [実行頻度] を [進行中] に設定します。
      5. [ スコープ] タブで、インストーラーポリシーと同じ展開ターゲットを追加します。
      6. サイドバーで、[スクリプトと構成] を選択します。
      7. (タスクマイニングスクリプトではない) タスク マイニングプロビジョニング を見つけて、[ 追加] を選択します。
        パラメーターは必要ありません。
      8. このポリシーにパッケージを追加しないでください。
      9. [Save (保存)] を選択します。
    8. 構成プロファイルを作成します。
      1. [JAMF コンピューター ] カテゴリで、 コンテンツ管理 > 構成プロファイル をクリックし、[ 新規] を選択します。
      2. プロファイルに 「タスクマイニング」という名前を付けます。
      3. サイドバーで、[ プライバシー設定ポリシーコントロール ]を選択し、[ 構成]を選択します。
      4. 次の値を入力し、[識別子タイプ] リストから [バンドル ID] を選択します。
        • 識別子: com.servicenow.taskmining.agent
        • コード要件: 
          identifier "com.servicenow.taskmining.agent" and anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] /* exists */ and certificate leaf[field.1.2.840.113635.100.6.1.13] /* exists */ and certificate leaf[subject.OU] = AS2BZHDV7Q
        注:
        コード要件は静的な値です。これを取得するには、次のターミナルコマンドを実行します: codesign -dr - ./Task\ Mining\ Agent.app
      5. [追加] を選択します。
      6. [ アプリ] または [サービス] で、[ アクセシビリティ] を選択します。
      7. [ アクセス] で [ 許可] を選択します。
      8. アクセシビリティアクセス許可の [保存 ] を選択し、プロファイル全体のページの下部にある [保存] をもう一度選択します。
    9. デーモンを管理対象ログインアイテムとしてマークします。
      1. 構成プロファイルで、[ 管理対象ログインアイテム] を選択します。
      2. 次の値を持つルールを追加します。
        • ルールラベル: com.servicenowtaskmining.daemon
        • チーム識別子: AS2BZHDV7Q
        注:
        チーム識別子は件名と同じ値です 。 前の手順のコード要件の OU。
      3. [Save (保存)] を選択します。

    次のタスク

    macOS デバイスでポリシーをデバッグするには、ターミナルから手動でトリガーします。ポリシー識別子は、そのポリシーを編集するときの JAMF URL の ID 値です。
    sudo jamf policy -id policy-id