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 を構成する
- Thinkst Canary コンソール(
https://<DOMAIN_HASH>.canary.tools)にログインします。 - 右上にある歯車アイコンをクリックし、[グローバル設定] を選択します。
- メニューで [API] をクリックします。
- API が無効になっている場合は、[API を有効にする] をクリックします。
既存のデフォルトの API キーを使用するか、[+ 新しい API キーを追加] をクリックして専用の API キーを作成します。
- API キーの種類: [読み取り専用] を選択します。これはログの収集に十分です。
- 注: 鍵の名前(
Google SecOps Integrationなど)を入力します。
次の情報をコピーして安全な場所に保存します。
- ドメインハッシュ: コンソールの識別子。API ホスト名は
<DOMAIN_HASH>.canary.toolsです。 - 認証トークン: リクエストの認証に使用される API キー。
- ドメインハッシュ: コンソールの識別子。API ホスト名は
Thinkst Canary のログを取り込むように Google SecOps でフィードを構成する
- [設定] > [データ管理] > [フィード] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [フィード] に移動します。
- [Add New Feed] をクリックします。
- 次のページで、[単一のフィードを構成する] をクリックします。
- [フィード名] フィールドに、フィードの名前を入力します(例:
Thinkst Canary Logs)。 - [ソースタイプ] として [サードパーティ API] を選択します。
- [Log type] として [Thinkst Canary] を選択します。
- [次へ] をクリックします。
次の入力パラメータの値を指定します。
- 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: このフィードのイベントに適用されるラベル。
- Authentication HTTP ヘッダー: 以前に生成されたトークン(
[次へ] をクリックします。
[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 のプロフェッショナルから回答を得ることができます。