[GAS]SentinelOne APIを利用して指定したPCのアプリケーション情報を取得

2022.12.01
  • t_o_dと申します。
  • SentinelOneでの脆弱性管理の際に、SentinelOne APIを利用すると容易に情報を取得することができます。
  • そこでGASとSentinelOne APIを利用して、指定したPCにインストールされているアプリケーション一覧を取得する方法を記録いたします。

環境

  • mac OS Monterey 13.0
  • Google Apps Script

手順

APIトークンの生成

  • SentinelOneから情報を取得するために必要なトークンを生成します。
  • まず、SentinelOneの管理画面にアクセスして右上から「My User」をクリックしてください。

  • 次にポップアップされた画面の「Options」から「generate API token」もしくは「Regenerate API token」をクリックしてください。

  • クリック後、APIトークンが表示されるのでメモしておいてください。

プロパティ設定

  • GASのスクリプトエディタを開いたら、スクリプトプロパティに以下の内容を設定してください。
プロパティ
SENTINEL_BASE SentinelOne API URL
例: https://xxxxxx.sentinelone.net/web/api/v2.1

xxxxxxの部分は契約しているSentinelOneアカウントです。
SENTINEL_TOKEN 上記手順で取得したAPIトークン

コード記述

  • プロパティ設定後、以下の内容をスクリプトエディタの任意のgsファイルに記述。
const properties = PropertiesService.getScriptProperties().getProperties();
const sentinelBase = properties.SENTINEL_BASE
const sentinelToken = properties.SENTINEL_TOKEN

function main(){
  // 対象PC名
  const pcName = '対象PC名';

  // sentineloneからのアプリケーション情報取得
  const sentinelPcId = getSentinelPcId(sentinelToken, pcName)
  if(sentinelPcId === '') throw new Error('PC名が見つかりませんでした。')
  const sentinelApplications = getSentinelApplications(sentinelToken, sentinelPcId)

  // アプリケーション情報出力
  console.log(sentinelApplications)
}

// PC名からsentinelone上のPCのIDを取得
function getSentinelPcId(token, pcName){
  try {
    const res = UrlFetchApp.fetch(`${sentinelBase}/agents?computerName=${pcName}`,{
      method: 'get',
      headers: {
        'Authorization': `ApiToken ${token}`,
      }
    })
    const json = JSON.parse(res.getContentText())
    return json.data[0].id
  }catch(e){
    return '';
  }
}

// PCのIDからアプリケーション情報を取得
function getSentinelApplications(token, pcId){
  const res = UrlFetchApp.fetch(`${sentinelBase}/agents/applications?ids=${pcId}`,{
    method: 'get',
    headers: {
      'Authorization': `ApiToken ${token}`,
    }
  })
  const json = JSON.parse(res.getContentText())
  return json.data.map(app => app.name)
}

実行

  • コード記述後、コード内の「対象PC名」を任意の値に修正します。
  • 修正後、main関数を実行して実行ログが以下のようなアプリケーション一覧が出力されることを確認します。

  • 以上です。

まとめ

  • 今後もSentinelOne APIのさまざまなサービスを適宜利用していき、日々の業務改善に努めてまいります。

参考

  • 公式ドキュメント_全体 : https://xxxxxx.sentinelone.net/api-doc/
  • 公式ドキュメント_アプリケーション情報 : https://xxxxxx.sentinelone.net/api-doc/api-details?category=agents&api=applications

アノテーション株式会社について

アノテーション株式会社は、クラスメソッド社のグループ企業として「オペレーション・エクセレンス」を担える企業を目指してチャレンジを続けています。「らしく働く、らしく生きる」のスローガンを掲げ、様々な背景をもつ多様なメンバーが自由度の高い働き方を通してお客様へサービスを提供し続けてきました。現在当社では一緒に会社を盛り上げていただけるメンバーを募集中です。少しでもご興味あれば、アノテーション株式会社WEBサイトをご覧ください。