事前構築済みパーサーを管理する
このドキュメントでは、Google Security Operations 内でパーサーを管理する方法について説明します。事前構築済みパーサーのアップデートの処理方法、パーサー拡張機能の作成方法、パーサー管理へのアクセス制御方法について詳しく説明します。
パーサーとは
Google Security Operations では、パーサーはさまざまなソースからの未加工ログデータを統合データモデル（UDM）形式に変換する一連の指示です。未加工ログを UDM に正規化することは、元のログ形式に関係なく、取り込まれたすべてのデータに対して Google SecOps がセキュリティ イベントを効果的に分析、検索、関連付けを行うために不可欠です。ログ解析の概要については、ログ解析の概要をご覧ください。
パーサーが必要な理由
パーサーは、Google SecOps 内でセキュリティ データを使用可能にするために不可欠です。適切な解析を行わないと、未加工ログは構造化されないため、効果的に検索したり、他のセキュリティ イベントと関連付けたり、検出ルールで使用したりすることはできません。正規化プロセスでは、未加工データが強化され、主要なフィールドが Google SecOps の分析機能を強化する標準化されたスキーマにマッピングされます。
プラットフォームに表示されるパーサー
Google SecOps プラットフォームの [Parsers] ページには、すでにデータを取り込んでいるログタイプの事前構築済みパーサーのみが表示されます。特定のログタイプのログをまだ取り込んでいない場合、対応する事前構築済みパーサーはプラットフォームに表示されません。
たとえば、UDM（udmevents API を使用して取り込まれたログ、または未加工ログなしで取り込まれたログ）や特定の Mandiant ログ（CreateEntities API を使用して取り込まれたログ）などのログタイプは、すでに構造化された形式であるため、パーサーを必要とせず、関連付けられたパーサーもありません。そのため、これらのログは [Parsers] ページに表示されません。
プラットフォームに事前構築済みパーサーを表示するには、その特定のログタイプのデータが正常に取り込まれていることを確認してください。
このドキュメントでは、パーサー管理の次の重要な側面について説明します。
パーサーのタイプ
パーサーのタイプとその機能について説明します。
| パーサーのタイプ | 説明 |
|---|---|
| 事前構築済み | 元のログデータを UDM フィールドに変換するためのマッピングが組み込まれた、Google SecOps によって作成されたパーサー。 |
| 事前構築済み拡張 | 追加のマッピング指示を使用してお客様が作成した事前構築済みパーサー。元の未加工ログから追加データを抽出し、UDM レコードに挿入します。 |
| カスタム | 事前構築済みではなく、元のログデータを UDM フィールドに変換するためのカスタム データ マッピング指示があるパーサー。詳細については、カスタム パーサーを構成するをご覧ください。 |
| カスタム機能の拡張 | パーサー拡張機能を使用して追加のマッピング指示を行い、元の未加工ログから追加データ を抽出し UDM レコードに挿入する、お客様が作成するカスタム パーサー。 |
事前構築済みパーサーのアップデートを管理する
Google SecOps は通常、毎月 4 週目に事前構築済みパーサーをアップデートします。これらのアップデートは、まず早期アクセスとテストのために提供されます。今後のパーサーのアップデートが利用可能になると、パーサーのリストでアップデートが [Pending] とマークされます。以前のパーサー バージョンと新しいパーサー バージョンの違いを確認したり、パーサーのアップデートを早期に有効にしてテストしたり、アップデートをスキップしてカスタム パーサーを作成したりできます。
保留中のアップデートを表示するには、次の操作を行います。
ログインして Google SecOps インスタンスにアクセスします。
[Settings] > [SIEM Settings] > [Parsers] を選択します。
[ Filter] をクリックします。
リストから [Prebuilt]、[Active]、および [Prebuilt Extended] を選択します。
有効な（デフォルトの）構築済みパーサーのリストが表示されます。今後行われるパーサーのアップデートは、[Update] 列に [Pending] と表示されます。
[Menu] をクリックし、リストから [View pending update] を選択します。
[Compare parsers] ページが表示されます。ここで、次の内容を表示できます。
現在のパーサー バージョンと今後のもののコード差異
[Change logs] タブの変更ログ
サンプリングされた未加工ログ用に生成された UDM イベント
パーサーが作成された日時
パーサーコードが最後に更新された日時
パーサーのアップデートを早期に有効にするか、アップデートをスキップして カスタム パーサーを作成するか、月の 第 4 週にアップデートが自動適用されるまで待つことができます。
パーサーのアップデートを早期に有効にする
パーサー管理機能を使用すると、パーサーのアップデートを早期に有効にできます。たとえば、テストする場合などです。
パーサーのアップデートを早期に有効にするには、次の手順を行います。
[Compare parsers] ページで、[Make parser update active] をクリックします。
[Confirm parser update] ダイアログが表示されます。
[確認] をクリックします。
20 分後に、正規化プロセスでパーサーが有効になります。
構築済みパーサーのアップデートをスキップする
現在の構築済みパーサーと今後の構築済みパーサーのアップデートをスキップするには、次のようにカスタム パーサーを作成します。
[Compare parsers] ページで、[Skip update] をクリックします。
[Skip update and create custom parser] ウィンドウが表示されます。
[Create custom parser] をクリックします。
[Type of parser to start with] で、現在の [Prebuilt Parser] または [Pending Parser Update] を選択します。
[作成] をクリックします。
選択したバージョンは、20 分後に正規化プロセスで有効になります。これは、[Parsers] ページのパーサー リストに、[Custom] と [Active] と表示されます。以前の構築済みバージョンは [Prebuilt] と [Inactive] として表示されます。
事前構築されたパーサーの早期アップデートを元に戻す
パーサーのアップデートを早期に有効にした場合は、アップデートが自動的に有効になる月の第 4 週まで、以前のバージョンに戻すことができます。
以前のパーサー バージョンに戻すには、次の手順に沿って操作します。
[Application menu] から、 [Settings] > [Parsers] を選択します。
元に戻すパーサーの [Menu] をクリックします。
[表示] をクリックします。
[View prebuilt parser] ページが表示されます。
[以前のバージョンに戻す] をクリックします。
[Revert to previous] ダイアログが表示されます。ダイアログで [パーサーを比較] をクリックすると、現在のバージョンと以前のものとの違いを確認できます。
[Confirm] をクリックして、パーサーを以前のバージョンに戻します。
20 分後に、パーサーが以前のバージョンに戻ります。
今後のパーサー バージョンの影響を分析する
影響チェック を使用すると、変更を適用する前に、今後のパーサー バージョンが検出ルールに与える可能性のある影響を評価できます。悪影響を受けるルールについては、リンクをクリックして調査し、必要に応じてルールを更新できます。
単一イベント ルールの場合、分析では、検出ルールによって過去 30 日間に生成された検出を確認します。これらの検出に対応するイベントに対して、現在のパーサー バージョンと今後のパーサー バージョンの両方が実行されます。このプロセスでは、検出を再生成して不一致がないか確認します。
マルチイベント ルールの場合、分析では、すべてのイベントではなくイベントのサンプルを使用して、ヒューリスティック分析を行います。イベントが一致しない場合、この分析では結果が [Potentially failing] とマークされます。
今後のパーサー バージョンが検出ルールに与える影響の分析を実行するには、次の操作を行います。
- Google SecOps コンソールで、[Settings] > [SIEM Settings] > [Parsers] に移動します。
- 特定の [Log type]（事前構築済みパーサー）を選択します。
- パーサーの更新オプション（[Update to latest version]、[Rollback to last used version]、[Opt-in to a Release Candidate]）のいずれかを選択します。
- パーサーの [Impact] タブに移動し、[Check impact on rules] をクリックします。影響チェックが完了するまでに時間がかかることがあります。
完了すると、次の情報が表示されます。
- パーサーのメタデータと、新しいバージョンが影響するルールのリスト。ルールのタイプと、違いを示す UDM フィールドの詳細が表示されます。
悪影響を受けるルールは、次のように分類されます。
- 失敗: 新しいパーサーでは検出が生成されませんでしたが、現在のパーサーでは検出が生成されました。
- Potentially failing: ルールロジックの UDM フィールドが変更されたルール（マルチイベントを含む）。これらのルールをさらに調査する必要があります。
これらのそれぞれについて、ルールエディタへのリンクをクリックして調査し、新しいパーサー バージョンで動作するようにルールを編集します。
事前構築済みパーサーのバージョンを管理する
Google SecOps は、ログが正しく解析されるように、事前構築済みパーサーを提供し、保守しています。組織のニーズに合わせて、新しいパーサー バージョンを環境に適用する方法を制御できます。
このセクションでは、Google SecOps でのパーサー バージョンの管理ライフサイクル全体について説明します。これには、自動更新のオプトインとオプトアウト、バージョン間のロジックの比較、新しいバージョンへの手動更新、以前のバージョンへのロールバックが含まれます。
パーサーの自動更新をオプトインまたはオプトアウトする
自動更新をオフにすると、自動更新をオンにするか手動で更新するまで、パーサーは現在のバージョンのままになります。自動更新をオフにする手順は次のとおりです。
[Application menu] から、 [Settings] > [Parsers] を選択します。
必要な 事前構築済みパーサーの [Menu] をクリックします。
[Turn off auto updates] をクリックします。
自動更新が有効になっている場合、パーサーは新しい安定版リリースごとに更新されます。自動更新を有効にする手順は次のとおりです。
[Application menu] から、 [Settings] > [Parsers] を選択します。
必要な 事前構築済みパーサーの [Menu] をクリックします。
[Turn on auto updates] をクリックします。
パーサー バージョンを手動で更新する
自動更新がオフになっている場合は、パーサーを新しいバージョンに更新するタイミングを選択できます。これにより、変更を適用する前に確認できます。
[Application menu] から、 [Settings] > [Parsers] を選択します。
必要な パーサーの [Menu] をクリックします。
[Update to latest version] を選択します。
[Compare parsers] ページが表示されます。表示される情報は次のとおりです。
現在のパーサー バージョンと新しいパーサー バージョンのコードの違い。
変更の概要を示す [変更ログ] タブ。
サンプリングされた未加工ログの UDM 出力。別のログに対して出力をテストするには、 [Edit] をクリックして、サンプリングされた未加工ログを編集します。
パーサーコードが最後に更新された日時。
[Update parser] をクリックして、最新バージョンに更新します。
パーサー バージョンをロールバックする
パーサーは、自動更新のステータスに関係なく、最後に使用したバージョンに戻すことができます。パーサー バージョンをロールバックする手順は次のとおりです。
[Application menu] から、 [Settings] > [Parsers] を選択します。
必要な パーサーの [Menu] をクリックします。
[最後に使用したバージョンにロールバック] を選択します。
[Compare parsers] ページが表示されます。表示される情報は次のとおりです。
現在のパーサー バージョンと最後に使用したパーサー バージョンのコードの違い。
変更を示す [Change log] タブ。
サンプリングされた未加工ログの UDM 出力。別のログに対して出力をテストするには、 [Edit] をクリックして、サンプリングされた未加工ログを編集します。
パーサーコードが最後に更新された日時。
[Proceed to roll back] をクリックして、最後に使用したバージョンにロールバックします。
パーサーは、最後に使用したバージョンにロールバックされます。たとえば、バージョン 17.0 から 24.0 にアップグレードした場合、ロールバックすると 23.0 ではなく 17.0 に戻ります。
連続してロールバックできるのは 1 回のみです。ロールバックを実行すると、[Roll back] オプションは使用できなくなります。
以前のパーサー バージョンのサポート ポリシー
事前構築済みパーサーの最新の安定版バージョンのみが、バグ修正と機能強化を受け取ります。自動更新を無効にして、以前のパーサー バージョンを使用している場合、そのバージョンはパッチや更新を受け取りません。この以前のバージョンに関する問題を報告した場合、次の安定版リリースに修正が含まれます。修正を受け取るには、パーサーを最新の安定版バージョンに手動でアップグレードする必要があります。
拡張機能を作成する
パーサー拡張機能を使用すると、既存の構築済み（デフォルト）パーサーの機能を柔軟に拡張できます。事前構築済みパーサーを置き換えるものではありません。代わりに、元の未加工ログから追加フィールドを UDM レコードにシームレスに抽出できます。パーサー拡張機能はカスタム パーサーとは異なります。
パーサー拡張機能を作成するには、パーサー拡張機能を使用するをご覧ください。
パーサー管理へのアクセスを制御する
デフォルトでは、管理者と編集者のロールを持つユーザーは、パーサーのアップデートを管理できます。これらのアップデートを表示、管理できるユーザーを制御する新しい権限を付与できます。
ユーザーとグループの管理、または ロールの割り当ての詳細については、 ロールベース アクセス制御ユーザーガイドをご覧ください。
さらにサポートが必要な場合コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。