Amazon Web Services プロトコルの構成オプション
Amazon Web Services (AWS) プロトコルは、AWS CloudWatch のログ、Amazon Kinesis のデータ・ストリーム、および Amazon Simple Queue Service (SQS) メッセージを収集する IBM QRadar のアウトバウンド/アクティブ・プロトコルです。
Amazon Web Services プロトコルは、 Amazon Kinesis データ・ストリーム、 AWS CloudWatch ログ、または Amazon Simple Queue Service (SQS)のいずれかで使用できます。
Amazon Kinesis データ・ストリーム
以下の表には、Amazon Web Services プロトコルを使用して Amazon Kinesis データ・ストリームを収集するためのプロトコル固有のパラメーターの説明が示されています。
| パラメーター | 説明 |
|---|---|
| プロトコル構成 | 「プロトコル構成」リストから「Amazon Web Services」を選択します。 |
| 認証方式 |
|
| アクセス・キー | AWS ユーザー・アカウント用のセキュリティー資格情報を構成したときに生成されたアクセス・キー ID。 「アクセス・キー ID (Access Key ID)/ 秘密鍵 (Secret Key)」または「IAM ロールの指定」を選択した場合は、「アクセス・キー (Access Key)」パラメーターが表示されます。 |
| 秘密鍵 | AWS ユーザー・アカウント用のセキュリティー資格情報を構成したときに生成された秘密鍵。 「アクセス・キー ID (Access Key ID)/ 秘密鍵 (Secret Key)」または「IAM ロールの指定」を選択した場合は、「秘密鍵 (Secret Key)」パラメーターが表示されます。 |
| IAM ロールの指定 | アクセス・キーまたは EC2 インスタンス IAM ロールで認証するには、このオプションを有効にします。 これにより、アクセス用の IAM ロールを一時的に指定することができます。 |
| ロール ARN の指定 (assume Role ARN) | 指定するロールのフル ARN。 先頭は arn:でなければならず、先頭や末尾にスペースや ARN 内のスペースを含めることはできません。 「IAM ロールの指定」を有効にすると、「ロール ARN の指定 (assume Role ARN)」パラメーターが表示されます。 |
| ロール・セッション名を想定 | 指定するロールのセッション名。 デフォルトは QRadarAWSSessionです。 変更する必要がない場合は、デフォルトのままにしてください。 このパラメーターで使用できる文字は、英数字の大文字と小文字、アンダースコアー、および =,.@- のみです。 「IAM ロールの指定」を有効にすると、「ロール・セッション名の指定 (Assume Role Session Name)」パラメーターが表示されます。 |
| ロール外部 ID を想定 | 「ロール外部 ID を想定」 は、別のアカウントのロールを引き受けるために必要なオプションの ID です。 役割が属するアカウント管理者から外部 ID が提供された場合は、その値を 「役割外部 ID を想定」 パラメーターに挿入します。 この値には、ストリング、パスフレーズ、GUID、またはアカウント番号のいずれかを指定できます。 詳しくは、 AWS の資料「 Using an external ID for third-Party access」を参照してください。 |
| リージョン | ログの収集元の Amazon Web Service に関連付けられている各リージョンを切り替えます。 |
| AWS サービス | 「AWS サービス」 リストから、 「Kinesis データ・ストリーム (Kinesis Data Streams)」を選択します。 |
| Kinesis データ・ストリーム (Kinesis Data Streams) | データの取り込み元の Kinesis データ・ストリーム。 |
| Kinesis 拡張オプションを有効にする (Enable Kinesis Advanced Options) | 以下のオプションの拡張構成値を有効にします。 拡張オプション値は、このオプションが選択されている場合にのみ使用されます。それ以外の場合は、デフォルト値が使用されます。
|
| 元のイベントの抽出 (Extract Original Event) | Kinesis データ・ストリームに追加された元のイベントのみを転送します。 Kinesis ログは、受信したイベントを追加のメタデータでラップします。 AWS に送信された元のイベントのみを収集し、Kinesis での追加のストリーム・データは不要な場合は、このオプションを選択します。 元のイベントは、Kinesis ログから抽出されるメッセージ・キーの値です。 次の Kinesis ログ・イベントの例では、Kinesis ログから抽出された元のイベントが強調表示されたテキストで示されています。
|
| ゲートウェイ・ログ・ソースとして使用 (Use as a Gateway Log Source) | 収集されたイベントが QRadar トラフィック分析エンジンを通過し、 QRadar が 1 つ以上のログ・ソースを自動的に検出するようにするには、このオプションを選択します。 このオプションを選択すると、オプションでログ・ソース ID パターンを使用して、処理中のイベントのカスタムログ・ソース IDを定義できます。 |
| ログ・ソース ID パターン (Log Source Identifier Pattern) | ゲートウェイ・ログ・ソースとして使用を選択した場合は、処理中のイベントのカスタム・ログ・ソース ID と、該当する場合に自動的に検出されるログ・ソースのカスタム・ログ・ソース ID を定義できます。 ログ・ソース ID パターン を構成しない場合、QRadar は、不明な汎用ログ・ソースとしてイベントを受け取ります。 カスタム・ログ・ソース ID を定義するには、キーと値のペアを使用します。 このキーは ID フォーマット・ストリングであり、生成されたソース値またはオリジン値です。 この値は、現在のペイロードを評価するために使用される、関連付けられた正規表現パターンです。 この値は、キーをさらにカスタマイズするために使用できるキャプチャー・グループもサポートします。 各パターンを新しい行に入力して、複数のキーと値のペアを定義します。 複数のパターンは、リストされている順序で評価されます。 一致が見つかると、カスタム・ログ・ソース ID が表示されます。 次の例では複数のキーと値のペアの機能を示します。
|
| 予測解析を使用 | このパラメーターを有効にすると、アルゴリズムはイベントごとに正規表現を実行せずにイベントからログ・ソース ID パターンを抽出するため、解析速度が向上します。 ヒント: まれに、アルゴリズムが誤った予測を行うことがあります。 予測解析は、高いイベント率を受け取ることが予想され、より高速な解析を必要とするログ・ソース・タイプに対してのみ有効にします。
|
| プロキシーの使用 (Use Proxy) | QRadar がプロキシーを使用して Amazon Web Service にアクセスする場合は、このオプションを選択します。 プロキシーが認証を必要とする場合、「プロキシー・サーバー」、「プロキシー・ポート」、「プロキシー・ユーザー名」、「プロキシー・パスワード」の各フィールドを構成します。 プロキシーが認証を必要としない場合、「プロキシー IP またはホスト名 (Proxy IP or Hostname)」フィールドを構成します。 |
| EPS スロットル | QRadar が取り込む 1 秒当たりのイベントの最大数。 データ・ソースが EPS スロットルを超える場合、データ収集は遅延されます。 データは引き続き収集され、データ・ソースが EPS スロットルを超えて停止すると取り込まれます。 デフォルトは 5000 です。 |
- Kinesis詳細オプションでKinesisアプリケーションが設定されていない場合、自動生成されたテーブル名QRadarApplicationXXXは、XXXが設定されたログソースインスタンスの内部値に関連する場合に使用される。
- Kinesisアプリケーションが指定されている場合、テーブル名はその値を取ります。
DynamoDB AWS 管理者が希望する場合は、あらかじめ必要なパラメータを指定してテーブルを作成することもできます。その場合は、Kinesis 詳細オプションで Kinesis アプリケーションの値を手動で指定し、それに一致するテーブル名を作成します。 テーブルを手動で作成している場合、 DynamoDB:CreateTable のパーミッションがIAMパーミッションのリストから漏れている可能性があります。 QRadar®
AWS CloudWatch ログ
以下の表には、Amazon Web Services プロトコルを使用して Amazon CloudWatch ログを収集するためのプロトコル固有のパラメーターの説明が示されています。
| パラメーター | 説明 |
|---|---|
| プロトコル構成 | 「プロトコル構成」リストから「Amazon Web Services」を選択します。 |
| 認証方式 |
|
| アクセス・キー | AWS ユーザー・アカウント用のセキュリティー資格情報を構成したときに生成されたアクセス・キー ID。 「アクセス・キー ID (Access Key ID)/ 秘密鍵 (Secret Key)」または「IAM ロールの指定」を選択した場合は、「アクセス・キー (Access Key)」パラメーターが表示されます。 |
| 秘密鍵 | AWS ユーザー・アカウント用のセキュリティー資格情報を構成したときに生成された秘密鍵。 「アクセス・キー ID (Access Key ID)/ 秘密鍵 (Secret Key)」または「IAM ロールの指定」を選択した場合は、「秘密鍵 (Secret Key)」パラメーターが表示されます。 |
| IAM ロールの指定 | このオプションを有効にするには、アクセス・キーまたは EC2 インスタンスの IAM ロールを使用して認証を行います。 これにより、アクセス用の IAM ロールを一時的に指定することができます。 |
| ロール ARN の指定 (assume Role ARN) | 指定するロールのフル ARN。 先頭は arn:でなければならず、先頭や末尾にスペースや ARN 内のスペースを含めることはできません。 「IAM ロールの指定」を有効にすると、「ロール ARN の指定 (assume Role ARN)」パラメーターが表示されます。 |
| ロール・セッション名を想定 | 指定するロールのセッション名。 デフォルトは QRadarAWSSessionです。 変更する必要がない場合は、デフォルトのままにしてください。 このパラメーターで使用できる文字は、英数字の大文字と小文字、アンダースコアー、および =,.@- のみです。 「IAM ロールの指定」を有効にすると、「ロール・セッション名の指定 (Assume Role Session Name)」パラメーターが表示されます。 |
| ロール外部 ID を想定 | 「ロール外部 ID を想定」 は、別のアカウントのロールを引き受けるために必要なオプションの ID です。 役割が属するアカウント管理者から外部 ID が提供された場合は、その値を 「役割外部 ID を想定」 パラメーターに挿入します。 この値には、ストリング、パスフレーズ、GUID、またはアカウント番号のいずれかを指定できます。 詳細については、 AWS ドキュメントサードパーティ・アクセスのための外部IDの使用 を参照のこと。 |
| リージョン | ログの収集元の Amazon Web Service に関連付けられている各リージョンを切り替えます。 |
| AWS サービス | 「AWS サービス」 リストから、 「CloudWatch ログ」を選択します。 |
| ログ・グループ | ログを収集する Amazon CloudWatch 内のログ・グループの名前。
ヒント: 単一のログ・ソースが、一度に 1 つのログ・グループから CloudWatch ログを収集します。 複数のログ・グループからログを収集する場合は、ログ・グループごとに別個のログ・ソースを作成します。
|
| CloudWatch 拡張オプションを有効にする (Enable CloudWatch Advanced Options) | 以下のオプションの拡張構成値を有効にします。 拡張オプション値は、このオプションが選択されている場合にのみ使用されます。それ以外の場合は、デフォルト値が使用されます。
|
| 元のイベントの抽出 (Extract Original Event) | CloudWatch ログに追加された元のイベントのみを転送します。 CloudWatch ログは、受信したイベントを追加のメタデータでラップします。 AWS に送信された元のイベントのみを収集し、CloudWatch での追加のストリーム・データは不要な場合は、このオプションを選択します。 元のイベントは、CloudWatch ログから抽出されるメッセージ・キーの値です。 次の CloudWatch ログ・イベントの例では、CloudWatch ログから抽出された元のイベントが強調表示されたテキストで示されています。
|
| ゲートウェイ・ログ・ソースとして使用 (Use as a Gateway Log Source) | 収集されたイベントが QRadar トラフィック分析エンジンを通過し、 QRadar が 1 つ以上のログ・ソースを自動的に検出するようにするには、このオプションを選択します。 このオプションを選択すると、オプションでログ・ソース ID パターンを使用して、処理中のイベントのカスタムログ・ソース IDを定義できます。 |
| ログ・ソース ID パターン (Log Source Identifier Pattern) | ゲートウェイ・ログ・ソースとして使用を選択した場合は、処理中のイベントのカスタム・ログ・ソース ID と、該当する場合に自動的に検出されるログ・ソースのカスタム・ログ・ソース ID を定義できます。 ログ・ソース ID パターン を構成しない場合、QRadar は、不明な汎用ログ・ソースとしてイベントを受け取ります。 カスタム・ログ・ソース ID を定義するには、キーと値のペアを使用します。 このキーは ID フォーマット・ストリングであり、生成されたソース値またはオリジン値です。 この値は、現在のペイロードを評価するために使用される、関連付けられた正規表現パターンです。 この値は、キーをさらにカスタマイズするために使用できるキャプチャー・グループもサポートします。 各パターンを新しい行に入力して、複数のキーと値のペアを定義します。 複数のパターンは、リストされている順序で評価されます。 一致が見つかると、カスタム・ログ・ソース ID が表示されます。 次の例では複数のキーと値のペアの機能を示します。
|
| 予測解析を使用 | このパラメーターを有効にすると、アルゴリズムはイベントごとに正規表現を実行せずにイベントからログ・ソース ID パターンを抽出するため、解析速度が向上します。 ヒント: まれに、アルゴリズムが誤った予測を行うことがあります。 予測解析は、高いイベント率を受け取ることが予想され、より高速な解析を必要とするログ・ソース・タイプに対してのみ有効にします。
|
| プロキシーの使用 (Use Proxy) | QRadar がプロキシーを使用して Amazon Web Service にアクセスする場合は、このオプションを選択します。 プロキシーが認証を必要とする場合、「プロキシー・サーバー」、「プロキシー・ポート」、「プロキシー・ユーザー名」、「プロキシー・パスワード」の各フィールドを構成します。 プロキシーが認証を必要としない場合、「プロキシー IP またはホスト名 (Proxy IP or Hostname)」フィールドを構成します。 |
| EPS スロットル | QRadar が取り込む 1 秒当たりのイベントの最大数。 データ・ソースが EPS スロットルを超える場合、データ収集は遅延されます。 データは引き続き収集され、データ・ソースが EPS スロットルを超えて停止すると取り込まれます。 デフォルトは 5000 です。 |
Amazon Simple Queue Service (SQS)
以下の表には、Amazon Web Services プロトコルを使用して Amazon SQS ログ・ソースを収集するためのプロトコル固有のパラメーターの説明が示されています。
| パラメーター | 説明 |
|---|---|
| プロトコル構成 | 「プロトコル構成」リストから「Amazon Web Services」を選択します。 |
| 認証方式 |
|
| アクセス・キー | AWS ユーザー・アカウント用のセキュリティー資格情報を構成したときに生成されたアクセス・キー ID。 「アクセス・キー ID (Access Key ID)/ 秘密鍵 (Secret Key)」または「IAM ロールの指定」を選択した場合は、「アクセス・キー (Access Key)」パラメーターが表示されます。 |
| 秘密鍵 | AWS ユーザー・アカウント用のセキュリティー資格情報を構成したときに生成された秘密鍵。 「アクセス・キー ID (Access Key ID)/ 秘密鍵 (Secret Key)」または「IAM ロールの指定」を選択した場合は、「秘密鍵 (Secret Key)」パラメーターが表示されます。 |
| IAM ロールの指定 | このオプションを有効にするには、アクセス・キーまたは EC2 インスタンスの IAM ロールを使用して認証を行います。 これにより、アクセス用の IAM ロールを一時的に指定することができます。 |
| ロール ARN の指定 (assume Role ARN) | 指定するロールのフル ARN。 先頭は arn:でなければならず、先頭や末尾にスペースや ARN 内のスペースを含めることはできません。 「IAM ロールの指定」を有効にすると、「ロール ARN の指定 (assume Role ARN)」パラメーターが表示されます。 |
| ロール・セッション名を想定 | 指定するロールのセッション名。 デフォルトは QRadarAWSSessionです。 変更する必要がない場合は、デフォルトのままにしてください。 この名前で使用できる文字は、英数字の大文字と小文字、アンダースコアー、および =,.@- のみです。 「IAM ロールの指定」を有効にすると、「ロール・セッション名の指定 (Assume Role Session Name)」パラメーターが表示されます。 |
| ロール外部 ID を想定 | 「ロール外部 ID を想定」 は、別のアカウントのロールを引き受けるために必要なオプションの ID です。 役割が属するアカウント管理者から外部 ID が提供された場合は、その値を 「役割外部 ID を想定」 パラメーターに挿入します。 この値には、ストリング、パスフレーズ、GUID、またはアカウント番号のいずれかを指定できます。 詳細については、 AWS ドキュメント第三者アクセス用の外部IDの使用 を参照。 |
| リージョン | ログの収集元の Amazon Web Service に関連付けられている各リージョンを切り替えます。 |
| AWS サービス | 「AWS サービス」 リストから、 「SQS キュー」を選択します。 |
| SQS キューの URL (SQS Queue URL) | https:// から始まる、データのプル元の SQS キューの完全な URL (例: https://sqs.us-east-2.amazonaws.com/1234567890123/CloudTrail_SQS_QRadar)。 詳しくは Amazon S3 Event Notifications ( https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html ). |
| 元のイベントの抽出 (Extract Original Event) | SQS キューに追加された元のイベントのみを QRadarに転送します。このオプションを選択します。 |
| 元のイベントの JSON エレメント (Original Event JSON Element) | このオプションを使用して SQS で元のイベントを抽出する場合、元のイベントは特定の JSON エレメントに含まれている可能性があります。 その場合は、元のイベントが含まれている最上位 JSON エレメントの名前を指定する必要があります。 このオプションは、そのエレメント内に含まれているデータもすべてアンエスケープします。 例えば、
これにより、アンエスケープされたデータは、以下のような抽出された元のイベントとして表示されます。
|
| ゲートウェイ・ログ・ソースとして使用 (Use as a Gateway Log Source) | イベントのカスタム・ログ・ソース ID を定義しない場合は、チェック・ボックスをクリアします。 「ゲートウェイ・ログ・ソースとして使用」 を選択せず、 「ログ・ソース ID パターン」を構成しない場合、 QRadar はイベントを不明な汎用ログ・ソースとして受信します。 |
| ログ・ソース ID パターン (Log Source Identifier Pattern) | 「ゲートウェイ・ログ・ソースとして使用 (Use As A Gateway Log Source)」を選択した場合は、カスタム・ログ・ソース ID を定義できます。 このオプションは、処理するイベントに対して、および該当する場合に自動的に検出されるログ・ソースのカスタム・ログ・ソース ID に対して定義することができます。 ログ・ソース ID パターン を構成しない場合、QRadar は、不明な汎用ログ・ソースとしてイベントを受け取ります。 カスタム・ログ・ソース ID を定義するには、キーと値のペアを使用します。 このキーは ID フォーマット・ストリングであり、生成されたソース値またはオリジン値です。 この値は、現在のペイロードを評価するために使用される、関連付けられた正規表現パターンです。 この値は、キーをさらにカスタマイズするために使用できるキャプチャー・グループもサポートします。 各パターンを新しい行に入力して、複数のキーと値のペアを定義します。 複数のパターンは、リストされている順序で評価されます。 一致が見つかると、カスタム・ログ・ソース ID が表示されます。 次の例では複数のキーと値のペアの機能を示します。
|
| 予測解析を使用 | このパラメーターを有効にすると、アルゴリズムはイベントごとに正規表現を実行せずにイベントからログ・ソース ID パターンを抽出するため、解析速度が向上します。 ヒント: まれに、アルゴリズムが誤った予測を行うことがあります。 予測解析は、高いイベント率を受け取ることが予想され、より高速な解析を必要とするログ・ソース・タイプに対してのみ有効にします。
|
| プロキシーの使用 (Use Proxy) | QRadar がプロキシーを使用して Amazon Web Service にアクセスする場合は、このオプションを選択します。 プロキシーが認証を必要とする場合、「プロキシー・サーバー」、「プロキシー・ポート」、「プロキシー・ユーザー名」、「プロキシー・パスワード」の各フィールドを構成します。 プロキシーが認証を必要としない場合、「プロキシー IP またはホスト名 (Proxy IP or Hostname)」フィールドを構成します。 |
| EPS スロットル | QRadar が取り込む 1 秒当たりのイベントの最大数。 データ・ソースが EPS スロットルを超える場合、データ収集は遅延されます。 データは引き続き収集され、データ・ソースが EPS スロットルを超えて停止すると取り込まれます。 デフォルトは 5000 です。 |