Thinkst Canary のログを収集する

以下でサポートされています。

このドキュメントでは、サードパーティ API を使用して Google Security Operations フィードを設定し、Thinkst Canary ログを収集する方法について説明します。

Thinkst Canary は、デセプション ベースの脅威検出を提供します。ハードウェア、仮想、クラウドの Canary が実際の資産になりすまし、Canarytoken がファイル、認証情報、URL のトリップワイヤーとして機能します。攻撃者が Canary に触れたり、トークンをトリップしたりすると、Canary コンソールにインシデントが記録されます。フィードは、Console API からこれらのインシデントを取得します。

始める前に

次の前提条件を満たしていることを確認してください。

  • Google SecOps インスタンス
  • Thinkst Canary コンソールへの特権アクセス

Thinkst Canary で REST API を構成する

  1. Thinkst Canary コンソール(https://<DOMAIN_HASH>.canary.tools)にログインします。
  2. 右上にある歯車アイコンをクリックし、[グローバル設定] を選択します。
  3. メニューで [API] をクリックします。
  4. API が無効になっている場合は、[API を有効にする] をクリックします。
  5. 既存のデフォルトの API キーを使用するか、[+ 新しい API キーを追加] をクリックして専用の API キーを作成します。

    • API キーの種類: [読み取り専用] を選択します。これはログの収集に十分です。
    • 注: 鍵の名前(Google SecOps Integration など)を入力します。
  6. 次の情報をコピーして安全な場所に保存します。

    • ドメインハッシュ: コンソールの識別子。API ホスト名は <DOMAIN_HASH>.canary.tools です。
    • 認証トークン: リクエストの認証に使用される API キー。

Thinkst Canary のログを取り込むように Google SecOps でフィードを構成する

  1. [設定] > [データ管理] > [フィード] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [フィード] に移動します。
  2. [Add New Feed] をクリックします。
  3. 次のページで、[単一のフィードを構成する] をクリックします。
  4. [フィード名] フィールドに、フィードの名前を入力します(例: Thinkst Canary Logs)。
  5. [ソースタイプ] として [サードパーティ API] を選択します。
  6. [Log type] として [Thinkst Canary] を選択します。
  7. [次へ] をクリックします。
  8. 次の入力パラメータの値を指定します。

    • Authentication HTTP ヘッダー: 以前に生成されたトークン(auth_token:<TOKEN> 形式、例: auth_token:AAAABBBBCCCC111122223333)。
    • API Hostname: Thinkst Canary REST API エンドポイントの完全修飾ドメイン名。<DOMAIN_HASH>.canary.tools 形式(例: myinstance.canary.tools)。
    • Asset namespace: アセットの名前空間。
    • Ingestion labels: このフィードのイベントに適用されるラベル。
  9. [次へ] をクリックします。

  10. [Finalize] 画面で新しいフィードの設定を確認し、[送信] をクリックします。

設定が完了すると、フィードは Thinkst Canary インスタンスからログを時系列で取得し始めます。

インシデントの更新と再配信

Canary Console API は、インシデントが作成されたときだけでなく、インシデントが更新されるたびにインシデントを返します。Canary は、同じソースからの後続の類似イベントを既存のインシデントにバンドルします。たとえば、ブルート フォース攻撃の試行は、1 つのインシデント内のイベントになります。インシデントのその他の変更によっても、再配信がトリガーされることがあります。

Google SecOps では、次の動作が想定されます。

  • すでに配信されたインシデントは、更新後にフィードに再表示されます。
  • 再配信されたインシデントは、再配信された時点よりもかなり古いイベント タイムスタンプで表示されることがあります。これは、パーサーがインシデントの元の作成時刻とバンドルされたイベント自体の発生時刻からイベントのタイムスタンプを導出するためです。更新時刻からは導出されません。

再配信自体は、インシデント収集 API の文書化された動作(インシデントの更新カウンタでフィルタリング)であり、データの損失やパーサーの欠陥ではありません。

UDM マッピング テーブル

ログフィールド UDM マッピング ロジック
_canary_uptime_label additional.fields 統合済み
desc_events_n_func_code_label additional.fields 統合済み
desc_events_n_func_name_label additional.fields 統合済み
desc_events_n_sfunc_code_label additional.fields 統合済み
desc_events_n_sfunc_name_label additional.fields 統合済み
desc_events_n_timestamp_std_label additional.fields 統合済み
desc_events_n_unit_id_label additional.fields 統合済み
description_created_std_label additional.fields 統合済み
description_events_list_label additional.fields 統合済み
event_data_list additional.fields 統合済み
event_descrip_label additional.fields 統合済み
events_url_label additional.fields 統合済み
local_time_label additional.fields 統合済み
locale_label additional.fields 統合済み
lt_label additional.fields 統合済み
offline_text_label additional.fields 統合済み
updated_label additional.fields 統合済み
updated_std_label additional.fields 統合済み
_auth extensions.auth 名前変更 / マッピング
_metadata metadata 名前変更 / マッピング
_event_time metadata.event_timestamp UNIX として解析
_metadata_event_timestamp metadata.event_timestamp UNIX として解析
description.created_std metadata.event_timestamp UNIX_MS として解析
elem.timestamp_std metadata.event_timestamp yyyy-MM-dd HH:mm:ss ZZZ+0000 として解析
updated metadata.event_timestamp EEE, dd MMM yyyy HH:mm:ss ZZZ として解析
updated_std metadata.event_timestamp UNIX_MS として解析
format metadata.event_type マッピング済み: grok → STATUS_UPDATE、grok → GENERIC_EVENT
has_principal_hostname metadata.event_type マッピング済み: true → STATUS_UPDATE
_network network 名前変更 / マッピング
_observer observer 名前変更 / マッピング
_principal principal 名前変更 / マッピング
ThinkstCanary_Process principal.application 直接マッピングされます。
ThinkstCanary_Process principal.asset.hostname 直接マッピングされます。
ThinkstCanary_Hostname principal.hostname 直接マッピングされます。
_md_product_event_type security_result マッピングされた値(合計 10 個、例: Shared File Opened → _security_result、Host Port Scan → ...
_security_result security_result 統合済み
format security_result マッピング済み: kv → _security_result、json → _security_result
_source src 名前変更 / マッピング
_target target 名前変更 / マッピング
なし metadata.event_type 定数: STATUS_UPDATE

変更ログ

このパーサーの変更ログを表示する

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。