Amazon GuardDuty を Google SecOps と統合する
このドキュメントでは、Amazon GuardDuty を Google Security Operations(Google SecOps)と統合する方法について説明します。
前提条件
コネクタの実行など、統合への読み取り専用権限が必要な場合は、AmazonGuardDutyReadOnlyAccess ポリシーを使用します。
すべての統合機能に完全にアクセスするには、AmazonGuardDutyFullAccess ポリシーを使用します。
ポリシーの使用方法については、AWS マネージド ポリシーをご覧ください。
AWS の Google Cloud ウェブ ID(OIDC)連携を構成する
Google SecOps の統合とコネクタは、OpenID Connect(OIDC)ウェブ ID 連携を使用して AWS に対する認証を行うことができます。これにより、有効期間の長い AWS アクセスキーとシークレット キーをプラットフォームに保存する必要がなくなります。
OIDC 連携を設定するには、Google Cloud 環境と AWS 環境の間に信頼関係を構成する必要があります。
ステップ 1: Google Cloud サービス アカウントを構成する
- Google Cloud コンソールで、AWS 統合専用のターゲット Google Cloud サービス アカウントを作成または選択します。
- サービス アカウントにサービス アカウント トークン作成者のロール(
roles/iam.serviceAccountTokenCreator)を割り当てて、トークンの生成と権限借用を有効にします。 - このサービス アカウントの OAuth 2.0 クライアント ID(一意の ID またはサブジェクト ID とも呼ばれます)をコピーします。この値は、AWS を構成するときに必要になります。
- Google SecOps 環境がこのターゲット サービス アカウントとして認証されるように構成します。
- Workload Identity(推奨): Google SecOps エージェントまたは環境が Google Cloudでネイティブに実行されている場合は、Workload Identity を使用してこのターゲット サービス アカウントの権限を借用する権限があることを確認します。
- サービス アカウント キー: 環境またはエージェントが外部またはオンプレミスで実行されている場合は、このターゲット サービス アカウントの JSON サービス アカウント キー ファイルをダウンロードし、認証に使用するようにプラットフォーム環境を構成します。
ステップ 2: AWS に OIDC ID プロバイダを追加する
- AWS マネジメント コンソールで、[IAM] > [Identity Providers] に移動します。
- [プロバイダを追加] をクリックし、[OpenID Connect] を選択します。
- [プロバイダ URL] に「
https://accounts.google.com」と入力します。 - [Audience] に、ステップ 1 でコピーした Google Cloudサービス アカウントの OAuth 2.0 クライアント ID を入力します。
ステップ 3: 連携 AWS IAM ロールを作成する
- AWS IAM コンソールで、新しい IAM ロールを作成します。
- 信頼できるエンティティ タイプとして [Web Identity] を選択し、Amazon Security Token Service(
sts:AssumeRoleWithWebIdentity)を使用して信頼ポリシーを自動的に構成します。 - 統合またはコネクタに必要な特定の権限ポリシー(AmazonGuardDutyReadOnlyAccess など)をアタッチします。
ロールの [Trust Relationships] タブを表示し、[Edit trust policy] をクリックして、次の JSON 構成を適用します。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Federated": "arn:aws:iam::<AWS_ACCOUNT_ID>:oidc-provider/accounts.google.com" }, "Action": "sts:AssumeRoleWithWebIdentity", "Condition": { "StringEquals": { "accounts.google.com:aud": "<GCP_SERVICE_ACCOUNT_CLIENT_ID>", "accounts.google.com:sub": "<GCP_SERVICE_ACCOUNT_CLIENT_ID>" } } } ] }
統合のパラメータ
次のパラメータを使用して統合を構成します。
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| AWS アクセスキー ID | 文字列 | なし | いいえ | 統合で使用する AWS アクセスキー ID。 Google CloudWeb Identity(OIDC)連携を使用する場合は、空欄のままにします。 |
| AWS シークレット キー | パスワード | なし | いいえ | 統合で使用する AWS シークレット キー。 Google Cloud Web Identity(OIDC)連携を使用する場合は、空欄のままにします。 |
| AWS のデフォルト リージョン | 文字列 | なし | ○ | 統合で使用する AWS のデフォルト リージョン(例: us-west-1)。 |
| リモートで実行 | チェックボックス | オフ | いいえ | 構成した統合をリモートで実行するには、フィールドのチェックボックスをオンにします。 オンにすると、リモート ユーザー(エージェント)を選択するオプションが表示されます。 |
Google SecOps で統合を構成する方法については、統合を構成するをご覧ください。
必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法の詳細については、複数のインスタンスのサポートをご覧ください。
ユースケース
- ハンドブックまたは手動アクションを使用して、AWS システムの脅威を検出して管理します。
- Amazon GuardDuty の検出結果を取り込み、GuardDuty アーカイブに移動します。
操作
アクションの詳細については、 デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。
Ping
Amazon GuardDuty への接続をテストします。
パラメータ
なし
実行
このアクションはエンティティに対しては実行されず、必須入力パラメータもありません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | 成功した場合: 「指定された接続パラメータを使用して AWS GuardDuty サーバーに正常に接続されました。」 それ以外の場合: 「AWS への接続に失敗しました。成功した場合: 「指定された接続パラメータを使用して AWS GuardDuty サーバーに正常に接続されました。」 それ以外の場合: 「AWS GuardDuty サーバーへの接続に失敗しました。エラー: {0}」 |
全般 |
検出機能を作成する
1 つの Amazon GuardDuty 検出機能を作成します。検出機能は、GuardDuty サービスを表すリソースです。アカウントごと、リージョンごとに 1 つの検出機能のみを使用できます。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 有効にする | チェックボックス | オフ | はい | 検出機能を有効にするかどうかを指定します。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 成功した場合: 「検出機能 <新しい検出機能 ID> が作成されました。」 検出機能が作成されていない場合(is_success=false): 「アクションは検出機能を作成できませんでした。理由: 現在のアカウントに検出機能がすでに存在します。 「ErrorCode」が報告された場合(is_success=false):「アクションは検出機能を作成できませんでした。エラー: {}」.format (ErrorMessage)" アクションが失敗し、Playbook の実行を停止します 無効な検出機能 ID も例外を発生させ、ハンドブックを停止し、is_success を false に設定する必要があります。 間違った認証情報、接続なし、その他など、致命的なエラー、SDK エラーが報告された場合:「アクション「検出機能の作成」の実行エラー。理由: {0}」.format(error.Stacktrace) |
全般 |
検出機能を削除する
検出機能 ID で指定された Amazon GuardDuty 検出機能を削除します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | 削除する検出機能の一意の ID。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 検出機能が削除されていない場合(is_success=false): 「アクションは <detector_ID> 検出機能を削除できませんでした。エラー: {}」.format(ErrorMessage)" 検出機能が正常に削除された場合(is_success=true):「検出機能 <検出機能 ID> が削除されました。」 アクションが失敗し、Playbook の実行を停止します 無効な検出機能 ID も例外を発生させ、ハンドブックを停止し、is_success を false に設定する必要があります。 間違った認証情報、接続なし、その他など、致命的なエラー、SDK エラーが報告された場合:「アクション「検出機能の削除」の実行エラー。理由: {0}」.format(error.Stacktrace) |
全般 |
検出機能を更新する
検出機能 ID で指定された Amazon GuardDuty 検出機能を更新します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | 更新する検出機能の一意の ID。 |
| 有効にする | チェックボックス | オフ | いいえ | 検出機能を有効にするかどうかを指定します。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 「ErrorCode」が報告された場合(is_success=false):「アクションは検出機能を作成できませんでした。エラー: {}」.format(ErrorMessage)" 検出機能が正常に更新された場合(is_success=true):「検出機能 <検出機能 ID> が更新されました。」 アクションが失敗し、Playbook の実行を停止します 無効な検出機能 ID の場合も例外が発生し、ハンドブックが停止して is_success が false に設定されます。 致命的なエラーや SDK エラー(認証情報の誤り、接続がないなど)が報告される場合: "Error executing action "Update a Detector". 理由: {0}」.format(error.Stacktrace) |
全般 |
検出機能の詳細を取得する
検出機能 ID で指定された Amazon GuardDuty 検出機能を取得します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | 取得する検出機能の一意の ID。カンマ区切り値。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
JSON の結果
{
"DetectorId": "DETECTOR_ID",
"CreatedAt": "response['CreatedAt']",
"ServiceRole": "response['ServiceRole']",
"Status": "response['Status']",
"UpdatedAt": "response['UpdatedAt']",
}
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 成功した場合: 「インジケーター <Indicator ID> に関する情報が正常に取得されました。」 注: 一部の検出機能 ID が見つかり、一部が見つからない場合は、関連する検出機能 ID に基づいて両方のメッセージが表示されます。 アクションが失敗し、ハンドブックの実行が停止します。 無効な検出機能 ID の場合も例外が発生し、ハンドブックが停止して is_success が false に設定されます。 間違った認証情報、接続なし、その他など、致命的なエラー、SDK エラーが報告された場合:「アクション「検出機能の詳細の取得」の実行エラー。理由: {0}」.format(error.Stacktrace) |
全般 |
| CSV テーブル | テーブルのタイトル: 検出機能の詳細 テーブル列:
|
全般 |
検出機能を一覧表示する
既存のすべての Amazon GuardDuty 検出機能リソースの detectorId を一覧表示します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 返される検出機能の最大数 | Integer | 50 | いいえ | 返される検出機能の数を指定します。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
JSON の結果
{
"detectorIds": ["ID1,ID2"]
}
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 200 ステータス コードが報告された場合(is_success=true): 「Amazon GuardDuty で利用可能な検出機能が正常に一覧表示されました。インジケーター ID:<値>" 他のステータス コードが報告された場合(is_success=false):「アクションは利用可能な検出機能を一覧表示できませんでした」 アクションが失敗し、ハンドブックの実行が停止します。 致命的なエラー、SDK エラー(認証情報が間違っている、サーバーへの接続がないなど)が報告される場合: "Error executing action "List Detectors". 理由: {0}」.format(error.Stacktrace) |
全般 |
検出機能の検出結果を一覧表示する
指定された検出機能 ID のすべての Amazon GuardDuty の検出結果を一覧表示します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | 取得する検出機能の一意の ID。 |
| 返される最大検出結果数 | Integer | 50 | いいえ | 返される検出機能の数を指定します。 |
| 並べ替え | 文字列 | なし | いいえ | 検出結果を並べ替える検出結果属性(accountId など)を表します。 |
| Order By | DDL | 昇順 値は次のいずれかです。
|
いいえ | 並べ替えられた検出結果が表示される順序。 |
| AWS リージョン | 文字列 | なし | いいえ | 必要に応じて、アクションで使用する AWS リージョンを指定します。これは、統合構成ページで指定されたデフォルトのリージョンとは異なる場合があります。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
JSON の結果
{"FindingIds": ["10ba96ae50733ae38b9cae95431b7558"]}
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 「ErrorCode」が報告された場合(is_success=false):「アクションは、<検出機能 ID> 検出機能の検出結果を取得できませんでした。エラー: {}」.format(ErrorMessage)" 成功した場合: 「検出機能 {detector ID} で利用可能な検出結果 ID が正常に取得されました」 アクションが失敗し、ハンドブックの実行が停止します。 致命的なエラー、SDK エラー(認証情報が間違っている、接続がないなど)が報告される場合: "Error executing action "List Findings for a Detector". 理由: {0}」.format(error.Stacktrace) |
全般 |
検出結果をアーカイブする
検出結果 ID で指定された GuardDuty の検出結果をアーカイブします。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出結果 ID | 文字列 | なし | はい | 取得する検出結果の ID。 カンマ区切りの ID。 |
| 検出項目 ID | 文字列 | なし | はい | 検出機能の一意の ID |
| AWS リージョン | 文字列 | なし | いいえ | 必要に応じて、アクションで使用する AWS リージョンを指定します。これは、統合構成ページで指定されたデフォルトのリージョンとは異なる場合があります。 |
AWS IAM ポリシーの権限:
- 効果: 許可
- アクション: guardduty:ArchiveFindings
検出結果をアーカイブできるのは、管理者アカウントのみです。メンバー アカウントには、アカウントから検出結果をアーカイブする権限がありません。
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 「ErrorCode」が報告された場合(is_success=false):「アクションは検出結果をアーカイブできませんでした。エラー: {}」.format(ErrorMessage)。すべての検出結果 ID が正しいかどうかを確認してください。」 成功した場合: 「検出結果が正常にアーカイブされました」→「次の検出結果が正常にアーカイブされました: <ids>」に変更 1 つまたはすべての検出結果 ID が無効な場合、アクションは失敗しませんが、is_success は false に設定されます。「次の検出結果をアーカイブできませんでした: <ids>」 注: エラーコードは、いずれかの ID に対応するものではありません。検出結果 ID が間違っている場合は、次のエラーを含む例外がスローされます。「ArchiveFindings オペレーションの呼び出し時(最大再試行回数 4 に到達): 内部サーバーエラー。」 ここでも同様に、まず検出結果が有効かどうかを確認します。 次の検出結果をアーカイブしました: 88bac20f959084244a2b91778d12e883 次の検出結果をアーカイブできませんでした: 1abac689941ae6f3e3e24d02ac4cf612 アクションが失敗し、ハンドブックの実行が停止します。 無効な検出機能 ID も例外を発生させ、ハンドブックを停止し、is_success を false に設定する必要があります。 致命的なエラー、SDK エラー(認証情報が間違っている、接続がないなど)が報告される場合: "Error executing action "Archive Findings". 理由: {0}「.format(error.Stacktrace)」 |
全般 |
検出結果のアーカイブを解除する
検出結果 ID で指定された GuardDuty の検出結果を抽出します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出結果 ID | 文字列 | なし | はい | 取得する検出結果の ID。カンマ区切り値。 |
| 検出項目 ID | 文字列 | なし | はい | 検出機能の一意の ID。 |
AWS IAM ポリシーの権限:
- 効果: 許可
- Action: guardduty:UnarchiveFindings
検出結果をアーカイブできるのは、管理者アカウントのみです。メンバー アカウントには、アカウントから検出結果をアーカイブする権限がありません。
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 成功した場合: 「次の検出結果が正常にアーカイブされました: <ids>」 1 つまたはすべての検出結果 ID が無効な場合、アクションは失敗しませんが、is_success は false に設定されます。「次の検出結果のアーカイブを解除できませんでした: <ids> アクションが失敗し、ハンドブックの実行が停止します。 無効な検出機能 ID も例外を発生させ、ハンドブックを停止し、is_success を false に設定する必要があります。 致命的なエラー、SDK エラー(認証情報が間違っている、接続がないなど)が報告される場合: 「アクション「検出結果のアーカイブ解除」の実行エラー。理由: {0}「.format(error.Stacktrace)」 注: エラーコードは、いずれかの ID に対応するものではありません。検出結果 ID が間違っている場合は、次のエラーを含む例外がスローされます。「ArchiveFindings オペレーションの呼び出し時(最大再試行回数 4 に到達): 内部サーバーエラー。」 同じく、まず検出結果が有効かどうかを確認します。 次の検出結果をアーカイブしました: 88bac20f959084244a2b91778d12e883 次の検出結果をアーカイブできませんでした: 1abac689941ae6f3e3e24d02ac4cf612 |
全般 |
サンプルの検出結果を作成する
検出結果のリストで指定されたタイプの検出結果の例を生成します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | サンプル検出結果を作成する検出機能の一意の ID。 |
| 検出結果のタイプ | 文字列 | なし | いいえ | 生成するサンプル検出結果のタイプ。カンマ区切り値。 タイプは、UI の [検出結果] セクションの [検出結果タイプ] 列で確認できます。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 「ErrorCode」が報告された場合(is_success=false):「アクションはサンプルの検出結果を作成できませんでした。エラー: {}」.format(ErrorMessage)" 成功した場合: 「サンプル検出結果が正常に作成されました」 入力(検出結果タイプ)のいずれかが無効な場合は、次の例外をキャッチします。「入力パラメータとして無効な値または範囲外の値が指定されているため、リクエストは拒否されました。」set、is_sucess=false: 「検出結果タイプ パラメータとして無効な値が見つかったため、アクションはサンプル検出結果を作成できませんでした。 更新: 検出結果タイプが無効な場合、アクションは失敗し、次のメッセージが表示されます。「検出結果タイプ パラメータとして無効な値が見つかったため、アクションはサンプル検出結果を作成できませんでした。エラー: <traceback>
アクションが失敗し、ハンドブックの実行が停止します。 無効な検出機能 ID も例外を発生させ、ハンドブックを停止し、is_success を false に設定する必要があります。 間違った認証情報、接続なし、その他など、致命的なエラー、SDK エラーが報告された場合: 「アクション「サンプル検出結果の作成」の実行エラー。理由: {0}」.format(error.Stacktrace) |
全般 |
検出結果のフィードバックを更新する
指定された Amazon GuardDuty の検出結果を「有用」または「有用でない」としてマークします。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | フィードバックを更新する検出結果に関連付けられた検出機能の一意の ID。 |
| 役に立ちましたか? | チェックボックス | オフ | はい | 検出結果のフィードバック。 |
| 検出結果 ID | 文字列 | なし | はい | 有用または有用でないとしてマークする検出結果の ID。カンマ区切り値。 |
| コメント | 文字列 | なし | いいえ | GuardDuty の検出結果に関する追加のフィードバック。 |
| AWS リージョン | 文字列 | なし | いいえ | 必要に応じて、アクションで使用する AWS リージョンを指定します。これは、統合構成ページで指定されたデフォルトのリージョンとは異なる場合があります。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 「ErrorCode」が報告された場合(is_success=false):「アクションは検出結果のフィードバックを更新できませんでした。エラー: {}」.format(ErrorMessage) 成功した場合:「検出結果のフィードバックが更新されました。」 いずれかの検出結果 ID でエラーが発生した場合、または見つからなかった場合、レスポンス オブジェクトは空のレスポンスを返します。 検出結果が見つからない場合:「フィードバックを更新できません。<finding id> は無効です。」 アクションが失敗し、Playbook の実行を停止します 無効な検出機能 ID も例外を発生させ、ハンドブックを停止し、is_success を false に設定する必要があります。 致命的なエラー、SDK エラー(認証情報の誤り、接続がないなど)が報告される場合: 「アクション「検出結果のフィードバックの更新」の実行エラー。理由: {0}「.format(error.Stacktrace)」 |
全般 |
信頼できる IP リストを削除する
ID で指定された IPSet を削除します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | IP セットの削除に使用する検出機能 ID を指定します。 このパラメータは [設定] タブにあります。 |
| 信頼できる IP リストの ID | 文字列 | なし | はい | IP セットの ID のカンマ区切りのリストを指定します。 例: id_1,id_2 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 成功した場合(is_success=true):「次の信頼できる IP リストを正常に削除しました: <ids>」 一部の ID で成功しなかった場合(is_success=true): 「アクションは、Amazon GuardDuty から次の信頼できる IP リストを削除できませんでした:\n{0}」.format(list_of_ids)" アクションが失敗し、ハンドブックの実行が停止します。 無効な検出機能 ID も例外を発生させ、ハンドブックを停止し、is_success を false に設定する必要があります。 間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーが報告された場合:「アクション「信頼できる IP リストの削除」の実行エラー。理由: {0}」.format(error.Stacktrace" |
全般 |
検出結果の詳細を取得する
AWS Guard Duty の検出結果に関する詳細情報を返します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出結果 ID | 文字列 | なし | はい | 取得する検出結果の ID。カンマ区切りの ID。 |
| 検出項目 ID | 文字列 | なし | はい | 取得する検出機能の一意の ID。 |
| AWS リージョン | 文字列 | なし | いいえ | 必要に応じて、アクションで使用する AWS リージョンを指定します。これは、統合構成ページで指定されたデフォルトのリージョンとは異なる場合があります。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
JSON の結果
{
"Findings": [{
"AccountId": "ACCOUNT_ID",
"Arn": "arn:aws:guardduty:us-east-1:ACCOUNT_ID:detector/DETECTOR_ID/finding/FINDING_ID",
"CreatedAt": "2020-10-06T05:19:50.794Z",
"Description": "203.0.113.9 is performing RDP brute force attacks against i-INSTANCE_ID. Brute force attacks are used to gain unauthorized access to your instance by guessing the RDP password.", "Id": "ID",
"Partition": "aws",
"Region": "us-east-1",
"Resource": {
"InstanceDetails": {
"AvailabilityZone": "us-east-1e",
"ImageId": "ami-IMAGE_ID",
"InstanceId": "i-INSTANCE_ID",
"InstanceState": "running",
"InstanceType": "t2.micro",
"LaunchTime": "2020-05-27T08:54:03Z", "NetworkInterfaces": [{
"Ipv6Addresses": [],
"NetworkInterfaceId": "eni-012d9b8a1a3b4e40a",
"PrivateDnsName": "ip-192.0.2.1.ec2.internal",
"PrivateIpAddress": "192.0.2.1",
"PrivateIpAddresses": [{
"PrivateDnsName": "ip-192.0.2.1.ec2.internal",
"PrivateIpAddress": "192.0.2.1"
}],
"PublicDnsName": "ec2-54-234-69-236.compute-1.amazonaws.com",
"PublicIp": "198.51.100.236",
"SecurityGroups": [{
"GroupId": "sg-0fa42e04e9cd15407",
"GroupName": "Windows Server 2016"
}],
"SubnetId": "subnet-2edddf10",
"VpcId": "vpc-48a7ac32"
}],
"Platform": "windows",
"ProductCodes": [],
"Tags": [{
"Key": "Name",
"Value": "CiscoAMP-win2012"
}]},
"ResourceType": "Instance"
},
"SchemaVersion": "2.0",
"Service": {
"Action": {
"ActionType": "NETWORK_CONNECTION", "NetworkConnectionAction": {
"Blocked": false,
"ConnectionDirection": "INBOUND",
"LocalPortDetails": {
"Port": 3389, "PortName": "RDP"
},
"Protocol": "TCP",
"LocalIpDetails": {
"IpAddressV4": "192.0.2.1"
},
"RemoteIpDetails": {
"IpAddressV4": "203.0.113.9",
"Organization": {
"Asn": "24875",
"AsnOrg": "Example Inc.",
"Isp": "Example Inc.",
"Org": "Example Inc."
}},
"RemotePortDetails": {
"Port": 1549,
"PortName": "Unknown"
}}},
"Archived": false,
"Count": 5,
"DetectorId": "DETECTOR_ID",
"EventFirstSeen": "2020-10-06T05:10:58Z",
"EventLastSeen": "2020-10-06T05:46:59Z",
"ResourceRole": "TARGET",
"ServiceName": "guardduty"
},
"Severity": 2,
"Title": "203.0.113.9 is performing RDP brute force attacks against i-INSTANCE_ID.",
"Type": "UnauthorizedAccess:EC2/RDPBruteForce",
"UpdatedAt": "2020-10-06T06:01:46.380Z"
}]
}
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 「ErrorCode」が報告された場合(is_success=false):「アクションは検出結果の詳細を取得できませんでした。エラー: {}」.format(ErrorMessage)" 成功した場合: 「次の検出結果 <取得された検出結果 ID> の情報が正常に取得されました」 いずれかの ID でエラーが報告された場合、レスポンス オブジェクトには、問題のない ID の結果のみが含まれます。レスポンス オブジェクトに一部の ID が含まれていないかどうかを確認し、適切なメッセージを出力します。
アクションが失敗し、ハンドブックの実行が停止します。 致命的なエラー、SDK エラー(認証情報が間違っている、接続がないなど)が報告される場合: "Error executing action "Get Findings". 理由: {0}「.format(error.Stacktrace)」 |
全般 |
| Case Wall テーブル | 注: 存在する場合。 テーブル列:
|
全般 |
すべての信頼できる IP リストを取得する
説明
検出機能 ID で指定された GuardDuty サービスの信頼できる IP リスト(IPSet)をすべて取得します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | IP セットの一覧表示に使用する検出機能 ID を指定します。 このパラメータは [設定] タブにあります。 |
| 返される信頼できる IP リストの最大数 | Integer | 50 | いいえ | 返される信頼できる IP リストの数を指定します。 |
| AWS リージョン | 文字列 | なし | いいえ | 必要に応じて、アクションで使用する AWS リージョンを指定します。これは、統合構成ページで指定されたデフォルトのリージョンとは異なる場合があります。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
JSON の結果
{
"IpSetIds": ['', '' , '']
}
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 利用可能なセットが正常に一覧表示された場合(is_success=true):「利用可能な信頼できる IP リストが正常に取得されました。」 アクションが失敗し、ハンドブックの実行が停止します。 致命的なエラー、SDK エラー(認証情報が間違っている、サーバーへの接続がないなど)が報告される場合: "Error executing action "Get all Trusted IP Lists". 理由: {0}」.format(error.Stacktrace) |
全般 |
信頼できる IP リストを取得する
説明
Amazon GuardDuty の信頼できる IP リストの詳細を取得します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | IP セットの取得に使用する検出機能 ID を指定します。 このパラメータは [設定] タブにあります。 |
| 信頼できる IP リストの ID | CSV | なし | はい | IP セットの ID のカンマ区切りのリスト( |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
JSON の結果
{
"ip_set_id": {
"Format": "response['Format']",
"Location": "response['Location']",
"Name": "response['Name']",
"Status": "response['Status']"
}
}
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 詳細が正常に返された場合(is_success=true):「Amazon GuardDuty から次の信頼できる IP リストに関する詳細が正常に取得されました:\n{0}」.format(list_of_ids) 一部の ID で成功しなかった場合(is_success=true): 「アクションは、Amazon GuardDuty から次の信頼できる IP リストの詳細を取得できませんでした:\n{0}」.format(list_of_ids) ID が使用されていない場合(is_success=false): 「指定された信頼できる IP リストに関する詳細が取得されませんでした」.format(list_of_ids)" アクションが失敗し、ハンドブックの実行が停止します。 致命的なエラー、SDK エラー(認証情報が間違っている、サーバーへの接続がないなど)が報告される場合: "Error executing action "List Trusted IP Lists". 理由: {0}」.format(error.Stacktrace) |
一般 |
| CSV | テーブル名: 信頼できる IP リストの詳細 テーブル列:
|
全般 |
信頼できる IP リストを更新する
説明
Amazon GuardDuty で信頼できる IP リストを更新します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | 信頼できる IP リストの更新に使用する検出機能 ID を指定します。 このパラメータは [設定] タブにあります。 |
| 信頼できる IP リストの ID | 文字列 | なし | はい | 更新する信頼できる IP リストの ID を指定します。 |
| 名前 | 文字列 | なし | いいえ | 信頼できる IP リストの新しい名前を指定します。 |
| ファイルのロケーション | 文字列 | https://s3.amazonaws.com/{bucket-name}/file.txt |
いいえ | ファイルが配置されている新しい URI の場所を指定します。 |
| 有効化 | チェックボックス | オン | はい | 有効にすると、信頼できる IP リストが有効になります。 |
| AWS リージョン | 文字列 | なし | いいえ | 必要に応じて、アクションで使用する AWS リージョンを指定します。これは、統合構成ページで指定されたデフォルトのリージョンとは異なる場合があります。 |
実行
このアクションはエンティティに対しては実行されません。
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
JSON の結果
N/A
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 1 つのセットが正常に更新された場合(is_success=true): 「Amazon GuardDuty で信頼できる IP リスト「{0}」が正常に更新されました。」.format(Threat ID) 1 つのセットの更新に失敗した場合(is_success=false):「Amazon GuardDuty で信頼できる IP リスト「{0}」を更新できませんでした。」.format(Threat ID) アクションが失敗し、ハンドブックの実行が停止します。 致命的なエラー、SDK エラー(認証情報が間違っている、サーバーへの接続がないなど)が報告される場合: "Error executing action "Update Trusted IP list". 理由: {0}」.format(error.Stacktrace) |
全般 |
信頼できる IP リストを作成する
AWS インフラストラクチャおよびアプリケーションとの安全な通信のために、動的リストに含まれていた信頼できる IP アドレス(IPSet)の新しいリストを作成します。
GuardDuty は、IPSet に含まれる IP アドレスの検出結果を生成しません。このオペレーションを使用できるのは、管理者アカウントのユーザーのみです。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | 信頼できる IP リストの作成に使用する検出機能 ID を指定します。 このパラメータは [設定] タブにあります。 |
| 名前 | 文字列 | なし | はい | 信頼できる IP リストの名前を指定します。 |
| ファイル形式 | DDL | 平文 | はい | 信頼できる IP リストの作成に使用するファイルの形式を選択します。 値は次のいずれかです。
|
| ファイルのロケーション | 文字列 | https://s3.amazonaws.com/{bucket-name}/file.txt |
はい | ファイルが配置されている URI の場所を指定します。 |
| 有効化 | チェックボックス | オン | はい | 有効にすると、新しく作成された信頼できる IP リストが有効になります。 |
| AWS リージョン | 文字列 | なし | いいえ | 必要に応じて、アクションで使用する AWS リージョンを指定します。これは、統合構成ページで指定されたデフォルトのリージョンとは異なる場合があります。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
JSON の結果
{
"TrustedIPID": "TRUSTED_IP_ID"
}
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 セットが正常に作成された場合(is_success=true):「Amazon GuardDuty で新しい信頼できる IP リスト「{0}」が正常に作成されました。」.format(Name)" セットの作成に失敗した場合(is_success=false):「アクションは Amazon GuardDuty で新しい信頼できる IP リスト「{0}」を作成できませんでした。」.format(name)" アクションが失敗し、ハンドブックの実行が停止します。 間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「信頼できる IP リストの作成」の実行エラー。理由: {0}「.format(error.Stacktrace)」 |
全般 |
脅威インテリジェンス セットを一覧表示する
Amazon GuardDuty で利用可能な脅威インテリジェンス セットを一覧表示します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | 脅威インテリジェンス セットの一覧表示に使用する検出機能 ID を指定します。 このパラメータは [設定] タブにあります。 |
| 返す脅威インテリジェンス セットの最大数 | Integer | 50 | いいえ | 返される脅威インテリジェンス セットの数を指定します。 |
| AWS リージョン | 文字列 | なし | いいえ | 必要に応じて、アクションで使用する AWS リージョンを指定します。これは、統合構成ページで指定されたデフォルトのリージョンとは異なる場合があります。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
JSON の結果
{
"ThreatIntelSetIds": ["14ba8b942b76c1be6d985715eb7443eb",
"32ba8b92e553fe04d06dab543ed57a70",
"8aba8b93ba6e08e8fd5349b2c2b57709"
]
}
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 利用可能なセットが正常に一覧表示された場合(is_success=true): 「利用可能な脅威インテリジェンス セットが正常に一覧表示されました。」 アクションが失敗し、ハンドブックの実行が停止します。 致命的なエラー、SDK エラー(認証情報が間違っている、サーバーへの接続がないなど)が報告される場合: "Error executing action "List Threat Intelligence Sets". 理由: {0}」.format(error.Stacktrace) |
全般 |
脅威インテリジェンス セットの詳細を取得する
Amazon GuardDuty で設定された脅威インテリジェンス セットの詳細を取得します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | 脅威インテリジェンス セットの詳細を取得するために使用する検出機能 ID を指定します。 このパラメータは [設定] タブにあります。 |
| 脅威インテリジェンス セット ID | 文字列 | 50 | はい | 脅威インテリジェンス セットの ID のカンマ区切りのリストを指定します。 例: id_1,id_2 |
| AWS リージョン | 文字列 | なし | いいえ | 必要に応じて、アクションで使用する AWS リージョンを指定します。これは、統合構成ページで指定されたデフォルトのリージョンとは異なる場合があります。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
JSON の結果
{
"Format": "TXT",
"Location": "https: //example.s3.amazonaws.com/test.txt",
"Name": "API Test",
"ResponseMetadata": {
"HTTPHeaders": {
"connection": "keep-alive",
"content-length": "149",
"content-type": "application/json",
"date": "Mon,19 Oct 2020 06: 23: 22 GMT",
"x-amz-apigw-id": "ID",
"x-amzn-requestid": "REQUEST_ID",
"x-amzn-trace-id": "TRACE_ID"
},
"HTTPStatusCode": 200,
"RequestId": "REQUEST_ID",
"RetryAttempts": 0
},
"Status": "ERROR",
"Tags": {}
}
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 少なくとも 1 つのセットに関する詳細が正常に返された場合(is_success=true): 「Amazon GuardDuty から次の脅威インテリジェンス セットに関する詳細が正常に取得されました:\n{0}」.format(list_of_ids)" 一部の ID で失敗した場合(is_success=true): 「Amazon GuardDuty から次の脅威インテリジェンス セットの詳細を取得できませんでした:\n{0}。」.format(list_of_ids)" ID が使用されていない場合: "No details were retrieved about the provided Threat Intelligence Sets.".format(list_of_ids) アクションが失敗し、ハンドブックの実行が停止します。 致命的なエラー、SDK エラー(認証情報が間違っている、サーバーへの接続がないなど)が報告される場合: "Error executing action "List Threat Intelligence Sets". 理由: {0}」.format(error.Stacktrace) |
一般 |
| CSV | テーブル名: 脅威インテリジェンス セットの詳細 テーブル列:
|
脅威インテリジェンス セットを作成する
Amazon GuardDuty で脅威インテリジェンス セットを作成します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | 脅威インテリジェンス セットの作成に使用する検出機能 ID を指定します。 このパラメータは [設定] タブにあります。 |
| 名前 | 文字列 | なし | はい | 脅威インテリジェンス セットの名前を指定します。 |
| ファイル形式 | DDL | 平文 値は次のいずれかです。
|
はい | 脅威インテリジェンス セットの作成に使用するファイルの形式を選択します。 |
| ファイルのロケーション | 文字列 | https://s3.amazonaws.com/{bucket-name}/file.txt |
はい | ファイルが配置されている URI の場所を指定します。 |
| 有効 | チェックボックス | オン | はい | 有効にすると、新しく作成された脅威インテリジェンス セットが有効になります。 |
| タグ | CSV | なし | いいえ | 脅威インテリジェンス セットに追加する追加のタグを指定します。 形式: key_1:value_1,key_2:value_1 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
JSON の結果
{
"ThreatIntelSetId": "b6f0c884a54449cc8e29eed3094e9c31"
}
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 セットが正常に作成された場合(is_success=true):「Amazon GuardDuty で脅威インテリジェンス セット「{0}」が正常に作成されました。」.format(Name) セットの作成に失敗した場合(is_success=false):「アクションは Amazon GuardDuty で脅威インテリジェンス セット「{0}」を作成できませんでした。」.format(name) アクションが失敗し、ハンドブックの実行が停止します。 致命的なエラー、SDK エラー(認証情報が間違っている、サーバーへの接続がないなど)が報告される場合: "Error executing action "Create Threat Intelligence Set". 理由: {0}」.format(error.Stacktrace) |
全般 |
脅威インテリジェンス セットを更新する
Amazon GuardDuty で脅威インテリジェンス セットを更新します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | はい | 脅威インテリジェンス セットの更新に使用する検出機能 ID を指定します。 このパラメータは [設定] タブにあります。 |
| ID | 文字列 | なし | はい | 更新する脅威インテリジェンス セットの ID を指定します。 |
| 名前 | 文字列 | なし | いいえ | 脅威インテリジェンス セットの新しい名前を指定します。 |
| ファイルのロケーション | 文字列 | https://s3.amazonaws.com/{bucket-name}/file.txt |
いいえ | ファイルが配置されている新しい URI の場所を指定します。 |
| 有効 | チェックボックス | オン | はい | 有効にすると、脅威インテリジェンス セットが有効になります。 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 1 つのセットが正常に更新された場合(is_success=true): 「Amazon GuardDuty で脅威インテリジェンス セット「{0}」が正常に更新されました。」.format(脅威 ID) セットの更新に失敗した場合(is_success=false):「アクションは Amazon GuardDuty で脅威インテリジェンス セット「{0}」を更新できませんでした。」.format(Threat ID) アクションが失敗し、ハンドブックの実行が停止します。 致命的なエラーや SDK エラー(認証情報の誤り、サーバーへの接続がないなど)が報告される場合: "Error executing action "Update Threat Intelligence Set". 理由: {0}」.format(error.Stacktrace) |
全般 |
脅威インテリジェンス セットを削除する
Amazon GuardDuty で脅威インテリジェンス セットを削除します。
パラメータ
| パラメータ名 | 種類 | デフォルト値 | ウォーターマーク | 必須 | 説明 |
|---|---|---|---|---|---|
| 検出項目 ID | 文字列 | なし | 該当なし | はい | 脅威インテリジェンス セットの詳細を取得するために使用する検出機能 ID を指定します。 このパラメータは [設定] タブにあります。 |
| 脅威インテリジェンス セット ID | CSV | なし | 該当なし | はい | 脅威インテリジェンス セットの ID のカンマ区切りのリストを指定します。 例: id_1,id_2 |
実行
このアクションはエンティティに対しては実行されません。
アクションの結果
スクリプトの結果
| スクリプトの結果名 | 値のオプション | 例 |
|---|---|---|
| is_success | 正誤問題 | is_success=False |
ケースウォール
| 結果のタイプ | 説明 | 種類 |
|---|---|---|
| 出力メッセージ * | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 少なくとも 1 つのセットに関する詳細が正常に返された場合(is_success=true): 「Amazon GuardDuty で次の脅威インテリジェンス セットが正常に削除されました:\n{0}」。format(list_of_ids) 一部の ID で失敗した場合(is_success=true): 「アクションでは、Amazon GuardDuty で次の脅威インテリジェンス セットを削除できませんでした:\n{0}。」.format(list_of_ids) ID が使用されていない場合: 「脅威インテリジェンス セットは削除されませんでした。」.format(list_of_ids) アクションが失敗し、ハンドブックの実行が停止します。 無効な検出機能 ID も例外を発生させ、ハンドブックを停止し、is_success を false に設定する必要があります。 間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合:「アクション「脅威インテリジェンス セットの削除」の実行エラー。理由: {0}」.format(error.Stacktrace) |
一般 |
コネクタ
Google SecOps でコネクタを構成する方法については、データを取り込む(コネクタ)をご覧ください。
AWS GuardDuty - 検出結果コネクタ
Amazon GuardDuty から検出結果を pull します。
コネクタの入力
次のパラメータを使用してコネクタを構成します。
| パラメータ名 | 種類 | デフォルト値 | 必須 | 説明 |
|---|---|---|---|---|
| プロダクト フィールド名 | 文字列 | プロダクト名 | はい |
商品名が保存されるフィールドの名前。 商品名は主にマッピングに影響します。コネクタのマッピング プロセスを合理化して改善するため、デフォルト値はコードから参照されるフォールバック値に解決されます。このパラメータに無効な入力があると、デフォルトでフォールバック値に解決されます。 デフォルト値は |
| イベント フィールド名 | 文字列 | 種類 | はい | イベント名(サブタイプ)を決定するフィールドの名前。 |
| 環境フィールド名 | 文字列 | "" | いいえ | 環境名が保存されるフィールドの名前。 environment フィールドがない場合、コネクタはデフォルト値を使用します。 |
Environment Regex Pattern |
文字列 | .* | いいえ |
デフォルト値 正規表現パターンが null か空の場合、または環境値が null の場合、最終的な環境の結果はデフォルト環境になります。 |
| スクリプトのタイムアウト(秒) | 整数 | 180 | はい | 現在のスクリプトを実行する Python プロセスのタイムアウト上限(秒単位)。 |
| AWS アクセスキー ID | 文字列 | なし | いいえ | 統合で使用する AWS アクセスキー ID。 Google CloudWeb Identity(OIDC)連携を使用する場合は、空欄のままにします。 |
| AWS シークレット キー | パスワード | なし | いいえ | 統合で使用する AWS シークレット キー。 Google Cloud Web Identity(OIDC)連携を使用する場合は、空欄のままにします。 |
| AWS のデフォルト リージョン | 文字列 | なし | はい | 統合で使用する AWS のデフォルト リージョン。 例: us-west-2 |
| Google Cloud ウェブ ID(OIDC)を使用する | チェックボックス | オフ | いいえ | 静的な AWS 認証情報の代わりに Google Cloud Web Identity(OIDC)連携を使用して安全に認証するには、このチェックボックスをオンにします。 |
| 検出項目 ID | 文字列 | なし | はい | 検出機能の ID。[設定] タブで確認できます。 |
| 取得する最も低い重大度 | Integer | 1 | はい | 取得するアラートの最も低い重大度。 このパラメータを構成しない場合、コネクタはすべての重大度レベルのアラートを取り込みます。 有効な値の範囲は 注: Amazon GuardDuty は、次の順序で整数値をマッピングします。
|
| 遡る取得の最大時間数 | 整数 | 1 | いいえ | 検出結果を取得するまでの時間数。 このパラメータは、コネクタを初めて有効にした後の最初のコネクタ イテレーション、または期限切れのコネクタ タイムスタンプのフォールバック値に適用できます。 |
| 取得する最大検出結果数 | 整数 | 50 | いいえ | 1 回のコネクタのイテレーションで処理する検出結果の数。 最大: 50 これは GuardDuty の制限事項です。 |
Use whitelist as a blacklist |
チェックボックス | オフ | はい | 選択すると、コネクタは動的リストを拒否リストとして使用します。 |
| プロキシ サーバーのアドレス | 文字列 | なし | いいえ | 使用するプロキシ サーバーのアドレス。 |
| プロキシのユーザー名 | 文字列 | なし | いいえ | 認証に使用するプロキシのユーザー名。 |
| プロキシ パスワード | パスワード | なし | いいえ | 認証に使用するプロキシ パスワード。 |
コネクタルール
コネクタはプロキシをサポートしています。
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。