AWS Identity and Access Management(IAM)を Google SecOps と統合する

このドキュメントでは、AWS Identity and Access Management を Google Security Operations と統合する方法について説明します。

ユースケース

AWS IAM との統合では、Google SecOps の機能を使用して次のユースケースをサポートします。

  • ユーザー侵害の封じ込め: インシデント対応ワークフローでインライン拒否ポリシーを適用して、侵害された疑いのある IAM ユーザーのアクセス権を自動的に取り消します。

  • アクセス権の取り消しと権限の調整: 異常な動作が検出されたときに、機密性の高い IAM グループからユーザーを削除して、重要な AWS リソースへのアクセスを直ちに制限します。

  • ポリシーとグループの管理: 管理対象の IAM ポリシーとグループの作成と割り当てを自動化して、最小権限のアクセス制御を適用します。

  • ID の監査とポスチャー検出: ユーザー、グループ、マネージド ポリシーのリストを取得して、AWS 環境全体のセキュリティ アラートを強化し、IAM 構成を監査します。

  • ID の自動プロビジョニング: 自動オンボーディングまたは封じ込め修復タスクの一環として、IAM ユーザーを作成し、事前定義された機能グループに割り当てます。

始める前に

Google SecOps で AWS IAM 統合を構成する前に、ネットワーク環境と AWS 認証情報がすべての運用上の前提条件を満たしていることを確認します。

統合用に環境を準備するには、次の操作を完了してください。

  1. Google SecOps と AWS IAM グローバル サービス エンドポイント(iam.amazonaws.com)間のネットワークの可視性を確認します。

  2. 適切な IAM 権限を持つ AWS プログラム API 認証情報(アクセスキー ID とシークレット アクセスキー)を取得します。

  3. Google SecOps 内でインテグレーション インスタンスを構成してテストする。

ネットワークの要件

Google SecOps は、HTTPS REST API と AWS Python SDK(boto3)を使用して、AWS IAM サービス エンドポイントと直接通信します。

ネットワーク環境が次の接続ルールを満たしていることを確認します。

  • アウトバウンド HTTPS アクセス: Google SecOps インスタンスまたはリモート エージェントからポート 443/TCP 経由で AWS IAM グローバル エンドポイント(iam.amazonaws.com)へのアウトバウンド HTTPS 通信を有効にします。

    AWS エンドポイントの詳細については、AWS ドキュメントの AWS サービス エンドポイントをご覧ください。

  • プロキシ構成: 組織がアウトバウンド トラフィックを HTTP/HTTPS プロキシ経由でルーティングする場合は、Google SecOps サーバーまたはリモート エージェント ホストで標準環境プロキシ変数(HTTP_PROXY、HTTPS_PROXY、NO_PROXY)を構成します。

認証と認証情報

AWS IAM 統合では、AWS 署名バージョン 4 を使用してリクエストを認証するために、プログラムによる API 認証情報が必要です。

AWS 環境が次の認証要件を満たしていることを確認します。

  • プログラムによる認証情報: AWS IAM ユーザーまたはロールに関連付けられた有効な AWS アクセスキー ID と AWS 秘密鍵を取得します。

    IAM ID の作成と認証情報の生成については、AWS ドキュメントの IAM ユーザーのアクセスキーの管理と IAM ID をご覧ください。

  • 最小権限: 権限を自動化されたワークフローに必要なアクションのみに制限し、認証情報を定期的にローテーションします。

    セキュリティに関する推奨事項の詳細については、AWS ドキュメントの IAM のセキュリティに関するベスト プラクティスをご覧ください。

アクションの権限を構成する

認証を行う AWS IAM ID に、Google SecOps プレイブックが実行するアクションに必要な特定の権限を付与します。

次の表で、AWS IAM アクションの最小権限を確認してください。

アクション名 必要な AWS IAM 権限(ActionName:Permission) 前提条件の権限 説明 / リソース スコープ
ユーザーをグループに追加する iam:AddUserToGroup iam:GetAccountSummary IAM ユーザーを IAM グループに追加します。リソース: ターゲット IAM グループの ARN。
ポリシーを適用する iam:AttachUserPolicy
iam:AttachGroupPolicy
iam:AttachRolePolicy
iam:ListPolicies 管理ポリシーを IAM ユーザー、グループ、またはロールに関連付けます。名前でポリシー ARN を検索するには、iam:ListPolicies が必要です。
グループを作成する iam:CreateGroup iam:GetAccountSummary 新しい IAM グループを作成します。リソース: ターゲット IAM グループの ARN。
ポリシーの作成 iam:CreatePolicy iam:GetAccountSummary 新しい顧客管理ポリシーを作成します。リソース: ターゲット IAM ポリシーの ARN。
ユーザーを作成する iam:CreateUser iam:GetAccountSummary 新しい IAM ユーザーを作成します。リソース: ターゲット IAM ユーザーの ARN。
ユーザー アクセスを無効にする iam:PutUserPolicy — インライン拒否ポリシー(DisableUserAccessPolicy)を適用して、ユーザーのアクセス権を取り消します。リソース: ターゲット IAM ユーザーの ARN。
グループを一覧表示する iam:ListGroups iam:GetAccountSummary アカウント内の IAM グループを一覧表示します。リソース: *。
ポリシーを一覧表示する iam:ListPolicies iam:GetAccountSummary アカウントの管理ポリシーを一覧表示します。リソース: *。
ユーザーを一覧表示する iam:ListUsers iam:GetAccountSummary アカウントの IAM ユーザーを一覧表示します。リソース: *。
ping iam:GetAccountSummary — 統合の接続を検証します。リソース: *。
グループからユーザーを削除する iam:RemoveUserFromGroup iam:GetAccountSummary IAM グループから IAM ユーザーを削除します。リソース: ターゲット IAM グループの ARN。

クイック リファレンス(ActionName:Permission)

次のクイック リファレンスを使用して、各アクションに必要な権限を確認してください。

Ping: iam:GetAccountSummary
Add a User to a Group: iam:AddUserToGroup, iam:GetAccountSummary
Attach a Policy: iam:ListPolicies, iam:AttachUserPolicy, iam:AttachGroupPolicy, iam:AttachRolePolicy
Create a Group: iam:CreateGroup, iam:GetAccountSummary
Create a Policy: iam:CreatePolicy, iam:GetAccountSummary
Create a User: iam:CreateUser, iam:GetAccountSummary
Disable User Access: iam:PutUserPolicy
List Groups: iam:ListGroups, iam:GetAccountSummary
List Policies: iam:ListPolicies, iam:GetAccountSummary
List Users: iam:ListUsers, iam:GetAccountSummary
Remove a User from a Group: iam:RemoveUserFromGroup, iam:GetAccountSummary

IAM ポリシーの例(最小権限)

次のポリシーの例は、Google SecOps で AWS IAM アクションをすべて実行するために必要な権限を示しています。

IAM ポリシーの作成とアタッチの手順については、AWS ドキュメントの IAM ポリシーの作成をご覧ください。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "SecOpsIAMDiscovery",
      "Effect": "Allow",
      "Action": [
        "iam:GetAccountSummary",
        "iam:ListUsers",
        "iam:ListGroups",
        "iam:ListPolicies"
      ],
      "Resource": "*"
    },
    {
      "Sid": "SecOpsIAMManagement",
      "Effect": "Allow",
      "Action": [
        "iam:CreateUser",
        "iam:CreateGroup",
        "iam:CreatePolicy",
        "iam:AddUserToGroup",
        "iam:RemoveUserFromGroup",
        "iam:PutUserPolicy",
        "iam:AttachUserPolicy",
        "iam:AttachGroupPolicy",
        "iam:AttachRolePolicy"
      ],
      "Resource": [
        "arn:aws:iam::*:user/*",
        "arn:aws:iam::*:group/*",
        "arn:aws:iam::*:role/*",
        "arn:aws:iam::*:policy/*"
      ]
    }
  ]
}

統合のパラメータ

次のパラメータを使用して統合を構成します。

パラメータの表示名 種類 デフォルト値 必須 説明
AWS アクセスキー ID 文字列 なし ○ 統合で使用する AWS アクセスキー ID。
AWS シークレット キー パスワード なし ○ 統合で使用する AWS シークレット キー。
SSL を確認する ブール値 正しい × 選択すると、統合は AWS IAM サーバーに接続するときに SSL 証明書を検証します。

Google SecOps で統合を構成する手順については、統合を構成するをご覧ください。

必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できるようになります。複数のインスタンスの構成とサポートの詳細については、複数のインスタンスのサポートをご覧ください。

操作

アクションの詳細については、 デスクから保留中のアクションに対応すると手動による対策を実行するをご覧ください。

ユーザーをグループに追加する

指定されたユーザーを指定された IAM グループに追加します。グループを使用すると、複数のユーザーに同じ権限ポリシーを一度に適用できます。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
グループ名 文字列 なし ○ 更新するグループの名前。注: グループ名にスペースを含めることはできません。また、英数字と次の文字(+=.@_-)のみを使用する必要があります。
ユーザー名 文字列 なし ○ 追加するユーザーの名前。注: ユーザー名にスペースは使用できません。使用できるのは、英数字と +=.@_- のみです。値はカンマで区切ります。

このアクションは Google SecOps エンティティに対して実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • 成功した場合: 「ユーザー <ユーザー名> を IAM グループ <グループ名> に追加しました」と出力されます。
  • エラーの場合 - グループが存在しない、またはユーザーが存在しない場合:
    グループが存在しない場合: 「<UserName> を <Group name> に追加できませんでした。グループ <group name> が見つかりません。」と出力します。
    ユーザーが存在しない場合 / 両方の場合: 「<UserName> を <Group name> に追加できませんでした。ユーザー <user name> が見つかりません。」と出力します。
  • エラーの場合
    ユーザーの制限 - IAM ユーザーは 10 個のグループのメンバーになることができます
    グループの制限 - 1 つのグループに 5,000 人のユーザーを含めることができます
    「現在の AWS アカウントの制限を超えるリソースを作成しようとしたため、<UserName> を <Group name> に追加できませんでした」と出力します。

アクションが失敗し、ハンドブックの実行が停止します。

  • 成功しなかった場合(認証情報が間違っている、接続がない、その他の SDK エラー): 「アクション「グループにユーザーを追加」の実行エラー。理由: {exception.stacktrace}
全般

ポリシーを適用する

指定されたマネージド ポリシーを ID(ユーザー、グループ、ロール)にアタッチします。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
ID タイプ

DDL
(ユーザー、グループ、ロール)

グループ ○ IAM ID タイプ。
ID 名 文字列 なし ○ ポリシーを関連付ける ID の名前(フレンドリ名、ARN ではない)。ID 名にスペースを含めることはできません。また、英数字と +=.@_-. のみを使用する必要があります。
ポリシー名 文字列 なし ○ ポリシーをアタッチするポリシーの名前(フレンドリ名。ARN ではありません)。ポリシー名にスペースを含めることはできません。ポリシー名に使用できるのは、英数字と +=.@_-. のみです。

このアクションは Google SecOps エンティティに対して実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • 成功した場合: 「ポリシーが <Identity Type>: <Identity Name> に関連付けられました」と出力されます。

アクションが失敗し、ハンドブックの実行が停止します。

  • エラーの場合 -: 「<ポリシー名> ポリシーを作成できませんでした。ポリシー名はアカウント内で一意である必要があります。
  • エラーが発生した場合 - ID 名が無効だった場合: 「Could not attach <policy name> to <Identity Type>: <Identity Name>. Names must contain only alphanumeric characters and/or the following: +=,.@_-.」と出力します。
  • 成功しなかった場合(認証情報が誤っている、サーバーに接続できない、その他のサーバーエラー): 「アクション「ポリシーを添付」の実行エラー。理由: {exception.stacktrace}
全般

グループを作成

AWS アカウントの新しい IAM グループを作成します。グループを設定するには、グループを作成する必要があります。次に、グループ内のユーザーに期待する作業の種類に基づいて、グループに権限を付与します。最後に、グループにユーザーを追加します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
グループ名 文字列 なし ○ 作成するグループの名前。カンマ区切り値。注: グループ名にスペースを含めることはできません。また、英数字と +=.@_- のみを使用できます。名前はアカウント内で一意である必要があります。

このアクションは Google SecOps エンティティに対して実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
[{
   "Arn":"arn:aws:iam::582302349248:group/ZivGroup",
   "CreateDate":"2020-12-05 16:18:36+00:00",
   "Path":"/",
   "GroupId":"'AGPAYPE7MW7AMKCWMJPMX",
   "GroupName":"ZivGroup"
}]
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • 成功した場合(一部またはすべてのグループ名が有効だった場合): 「次のグループを IAM に正常に追加しました: <グループ名>」と出力します。
  • エラー - グループがすでに存在する場合: 「次のグループを IAM に追加できませんでした: <グループ名>。名前はアカウント内で一意である必要があります。」と出力します。
  • エラーの場合(無効なグループ名がいくつかある場合): 「次のグループを IAM に追加できませんでした: <グループ名>。グループ名に使用できるのは、英数字と次の記号のみです: +=,.@_-。」と出力します。
  • エラーが発生した場合(制限を引き上げます。アカウントあたりのグループ数の上限は 500 個です。「次のグループを IAM に追加できませんでした: <グループ名>。AWS アカウントのグループ数の上限に達しました。


アクションが失敗し、ハンドブックの実行が停止されました:

  • 成功しなかった場合(すべての名前が無効、認証情報が間違っている、接続がない、その他のエラー): 「アクション「グループの作成」の実行エラー。理由: {exception.stacktrace}
全般

ポリシーを作成する

AWS アカウントの IAM カスタマー管理ポリシーを作成します。このアクションにより、バージョン ID が v1 のポリシー バージョンが作成され、v1 がポリシーのデフォルト バージョンとして設定されます。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
ポリシー名 文字列 なし ○ 作成するポリシーの名前。ポリシー名にスペースを含めることはできません。使用できるのは、英数字と +=.@_- のみです。ポリシー名はアカウント内で一意である必要があります。
ポリシー ドキュメント 文字列 なし ○ 新しいポリシーのコンテンツとして使用する JSON ポリシー ドキュメント。
説明 文字列 なし × ポリシーの説明。通常、ポリシーで定義された権限に関する情報を保存するために使用されます。たとえば、「本番環境の DynamoDB テーブルへのアクセス権を付与します」などです。ポリシーの説明は不変です。値を割り当てた後は変更できません。

このアクションは Google SecOps エンティティに対して実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "PolicyName": "S3-read-only-bucket",
    "PolicyId": "ANPAYPE7MW7AFKUDK3HD7",
    "Arn": "arn:aws:iam::582302349248:policy/S3-read-only-bucket",
    "Path": "/",
    "DefaultVersionId": "v1",
    "AttachmentCount": 0,
    "PermissionsBoundaryUsageCount": 0,
    "IsAttachable": true,
    "CreateDate": "2020-12-6T17:16:45",
    "UpdateDate": "2020-12-6T17:16:45"
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • 成功した場合: 「<Policy name> policy was successfully created」と出力されます。

アクションが失敗し、ハンドブックの実行が停止します。

  • エラーの場合 - ポリシーがすでに存在する場合: 「<policy name> ポリシーを作成できませんでした。ポリシー名はアカウント内で一意である必要があります。
  • エラー - ポリシー名が無効だった場合: 「<ポリシー名> ポリシーを作成できませんでした。ポリシー名に使用できるのは、英数字と +=,.@_-. のみです。
  • エラーの場合 - ポリシー ドキュメントの形式が正しくない場合 : 「<ポリシー名> ポリシーを作成できませんでした。ポリシー ドキュメントの形式が正しくありませんでした。理由: {exception.stacktrace}

成功しなかった場合(LimitExceededException、認証情報が間違っている、接続がない、その他のエラー): 「アクション「ポリシーの作成」の実行中にエラーが発生しました。理由: {exception.stacktrace}

全般

ユーザーを作成する

AWS アカウントの新しい IAM ユーザーを作成します。カンマ区切り値を使用すると、複数のユーザーを一度に追加できます。この段階ではポリシーは適用されません。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
ユーザー名 文字列 なし ○ 作成するユーザーの名前。カンマ区切り値。注: ユーザー名にスペースを含めることはできません。また、英数字と +=.@_- のみを使用する必要があります。アカウント内で一意の名前を付ける必要があります。

このアクションは Google SecOps エンティティに対して実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
[{
   "Arn":"arn:aws:iam::582302349248:user/ziv",
   "CreateDate":"2020-12-03T12:12:20",
   "Path":"/",
   "UserId":"AIDAYPE7MW7AFMHK4WCHS",
   "UserName":"ziv"
}]
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • 成功した場合(有効なユーザー名がいくつかあった場合): 「次のユーザーを IAM に正常に追加しました: <ユーザー名>」と出力されます。
  • エラー - ユーザーがすでに存在する場合: 「次のユーザーを IAM に追加できませんでした: <ユーザー名>。アカウント内で名前は一意である必要があります。
  • エラーが発生した場合(無効なユーザー名がいくつかあった場合): 「次のユーザーを IAM に追加できませんでした: <ユーザー名>。ユーザー名には、英数字と +=,.@-. のみを含める必要があります。」と印刷します。
  • エラーの場合(制限を引き上げます。(アカウントあたりのユーザー数の上限は 5,000 人): 「次のユーザーを IAM に追加できませんでした: <ユーザー名>。aws アカウントのユーザー数の上限に達しました。

注: 何も起こらなかった場合: すべてのユーザーが無効/存在/制限 → アクションは失敗するはずです

アクションが失敗し、ハンドブックの実行が停止します。

  • 成功しなかった場合(すべてのユーザー名が無効、認証情報が間違っている、接続がない、その他のエラー): 「アクション「ユーザーの作成」の実行中にエラーが発生しました。理由: {exception.stacktrace}

注: すべてのユーザー名が無効な場合は、「アクション「ユーザーの作成」の実行エラー。理由: {invalid usernames}: ユーザー名に使用できるのは、英数字と +=,.@-. のみです。{existing usernames}: 名前はアカウント内で一意である必要があります。

全般

ユーザー アクセスを無効にする

明示的なインライン拒否ポリシーを追加して、AWS でのユーザー アクセスを無効にします。

このアクションは、通常の AWS ユーザーのみをサポートし、フェデレーション ユーザーや IAM ロールはサポートしていません。

エンティティ

このアクションはユーザー エンティティに対して実行されます。

アクションの入力

なし

アクションの出力

アクションの出力タイプ
ケースウォールのアタッチメント なし
ケースのウォールのリンク なし
ケースウォール テーブル なし
拡充テーブル なし
JSON の結果 利用可能
スクリプトの結果 利用可能
JSON の結果
[
  {
    "Entity": "//iam.googleapis.com/projects/example/serviceAccounts/service-account@example.iam.gserviceaccount.com",
    "EntityResult": [
      {
        "fullResourceName": "//iam.googleapis.com/projects/example/serviceAccounts/service-account@example.iam.gserviceaccount.com",
        "activityType": "serviceAccountLastAuthentication",
        "observationPeriod": {
          "startTime": "2023-05-23T07:00:00Z",
          "endTime": "2023-08-20T07:00:00Z"
        },
        "activity": {
          "lastAuthenticatedTime": "2023-08-20T07:00:00Z",
          "serviceAccount": {
            "serviceAccountId": "example-account-id",
            "projectNumber": "example-project-id",
            "fullResourceName": "//iam.googleapis.com/projects/example/serviceAccounts/service-account@example.iam.gserviceaccount.com"
          }
        }
      }
    ]
  }
]
スクリプトの結果
スクリプトの結果名 値
is_success True/False
ケースウォール

このアクションでは、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明

Successfully added deny policy to the following users in AWS IAM: USERNAME_LIST

Action wasn't able to find the following users in AWS IAM: USERNAME_LIST

Action wasn't able to add deny policy to the following users in AWS IAM: USERNAME_LIST

アクションが成功しました。
Successfully added deny policy to the following users in AWS IAM: USERNAME_LIST

操作を実行できませんでした。

エラーが発生したため、指定されたユーザーの少なくとも 1 人に拒否ポリシーを適用できませんでした。

Error executing action "Disable User Access". Reason: ERROR_REASON

操作を実行できませんでした。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

グループの一覧表示

IAM 内のすべてのグループのリストを取得します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
返されるグループの最大数 Integer 50 × 返すグループの数を指定します。最大 1,000 個のグループ。デフォルトは 50 です。

このアクションは Google SecOps エンティティに対して実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
[{
   "Arn":"arn:aws:iam::582302349248:group/ZivGroup",
   "CreateDate":"2020-12-05 16:18:36+00:00",
   "Path":"/",
   "GroupId":"AGPAYPE7MW7AMKCWMJPMX",
   "GroupName":"ZivGroup"
}]
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功した場合: 「AWS IAM で利用可能なグループを一覧表示しました」と出力されます。

データがない場合: 「AWS IAM にグループが見つかりませんでした」と出力します。


アクションが失敗し、ハンドブックの実行が停止されました:

成功しなかった場合(認証情報が誤っている、サーバーへの接続がない、その他のサーバーエラー、「最大グループ数」が 1,000 を超えている場合): 「アクション「グループの一覧表示」の実行エラー。理由: {exception.stacktrace}

全般
CSV テーブル

タイトル: IAM グループ

列:

グループ名

グループ ID

ARN

作成日

全般

ポリシーの一覧表示

独自のユーザー定義の管理ポリシーとすべての AWS 管理ポリシーを含む、AWS アカウントで使用可能なすべての管理ポリシーを一覧表示します。返されるポリシーのリストは、省略可能な Only Attached、Scope、Policy Usage パラメータを使用してフィルタできます。たとえば、AWS アカウントのユーザー管理ポリシーのみを一覧表示するには、スコープを [ローカル] に設定します。AWS マネージド ポリシーのみを一覧表示するには、[Scope] を [AWS] に設定します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
添付ファイルのみ ブール値 いいえ × オンにすると、IAM ユーザー、グループ、ロールにアタッチされているポリシーのみに結果がフィルタされます。チェックを外すと、すべてのポリシーが返されます。
範囲

DDL
(すべて、AWS、ローカル)

すべて × 結果のフィルタリングに使用するスコープ。AWS マネージド ポリシーのみを一覧表示するには、[Scope] を [AWS] に設定します。AWS アカウントのカスタマー管理ポリシーのみを一覧表示するには、スコープを [ローカル] に設定します。デフォルトでは、すべてのポリシーが返されます。
返される最大ポリシー数 Integer 100 × 返すポリシーの数を指定します。デフォルトは 100 です。最大値は 1,000 です。

このアクションは Google SecOps エンティティに対して実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
[{
'PolicyName': 'string',
'PolicyId': 'string',
'Arn': 'string',
'Path': 'string',
'DefaultVersionId': 'string',
'AttachmentCount': 123,
'PermissionsBoundaryUsageCount': 123,
'IsAttachable': True|False,
'Description': 'string',
'CreateDate': "2020-12-6T17:16:45",
'UpdateDate':"2020-12-6T17:16:45"
}]
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • 成功した場合: 「AWS IAM で利用可能なポリシーを一覧表示しました」と出力されます。
  • [Max Policies] の値 < フィルタに基づく一致するポリシーの場合: 「AWS IAM で利用可能なポリシーを一覧表示しました。なお、指定されたフィルタに一致するポリシーが他にもあります。」
  • データがない場合: 「AWS IAM でポリシーが見つかりませんでした」と出力します。


アクションが失敗し、ハンドブックの実行が停止されました:

  • 成功しなかった場合(認証情報が誤っている、サーバーへの接続がない、その他のサーバーエラー、max>1000): 「アクション「ポリシーの一覧表示」の実行エラー。理由: {exception.stacktrace}
全般
CSV テーブル

タイトル: IAM ポリシー

列:

ポリシー名

ポリシー ID

作成日

更新日

全般

ユーザーの一覧表示

IAM 内のすべてのユーザーのリストを取得します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
返されるユーザーの最大数 Integer 50 × 返すユーザーの数を指定します。最大 1,000 人のユーザー。デフォルトは 50 です。

このアクションは Google SecOps エンティティに対して実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
[{
   "Arn":"arn:aws:iam::582302349248:user/ziv",
   "CreateDate":"2020-12-03T12:12:20",
   "Path":"/",
   "UserId":"AIDAYPE7MW7AFMHK4WCHS",
   "UserName":"ziv"
}]
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功した場合: 「AWS IAM で利用可能なユーザーを一覧表示しました」と出力されます。

データがない場合: 「AWS IAM でユーザーが見つかりませんでした」と出力します。


アクションが失敗し、ハンドブックの実行が停止されました:

成功しなかった場合(認証情報が誤っている、サーバーへの接続がない、その他のサーバーエラー、max>10000 の場合): 「アクション「ユーザーの一覧表示」の実行エラー。理由: {exception.stacktrace}

全般
CSV テーブル

タイトル: IAM ユーザー

列:

ユーザー名

ユーザー ID

ARN

作成日

全般

Ping

Google Security Operations の [Marketplace] タブの統合構成ページで提供されているパラメータを使用して、AWS IAM への接続をテストします。

このアクションは Google SecOps エンティティに対して実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

成功した場合: 「指定された接続パラメータを使用して AWS IAM サーバーに正常に接続されました。」と出力されます。

アクションが失敗し、ハンドブックの実行が停止します。

成功しなかった場合: 次の内容が出力されます。「AWS IAM サーバーへの接続に失敗しました。エラーは {0}」.format(exception.stacktrace)

全般

グループからユーザーを削除する

指定されたユーザーを指定された IAM グループに追加します。グループを使用すると、複数のユーザーに同じ権限ポリシーを一度に適用できます。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
グループ名 文字列 なし ○ 更新するグループの名前。注: グループ名にスペースを含めることはできません。また、英数字と次の文字(+=.@_-)のみを使用する必要があります。
ユーザー名 文字列 なし ○ 削除するユーザーの名前。注: ユーザー名にスペースは使用できません。使用できるのは、英数字と +=.@_- のみです。値はカンマで区切ります。

このアクションは Google SecOps エンティティに対して実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • 成功した場合: 「<ユーザー名> がグループ <グループ名> から削除されました」と出力されます。
  • エラーの場合 - グループが存在しない、またはユーザーが存在しない場合:
    グループが存在しない場合: 「<UserName> を <Group name> から削除できませんでした。グループ <group name> が見つかりません。」と出力します。
    ユーザーが存在しない場合 / 両方の場合: 「<UserName> を <Group name> から削除できませんでした。ユーザー <user name> が見つかりません。」と出力します。
  • エラーの場合
    ユーザーの制限 - IAM ユーザーは 10 個のグループのメンバーになることができます
    グループの制限 - 1 つのグループに 5,000 人のユーザーを含めることができます
    「現在の AWS アカウントの制限を超えるリソースを作成しようとしたため、<UserName> を <Group name> から削除できませんでした」と出力します。

アクションが失敗し、ハンドブックの実行が停止します。

  • 成功しなかった場合(認証情報が間違っている、接続がない、その他の SDK エラー): 「アクション「グループからユーザーを削除する」の実行エラー。理由: {exception.stacktrace}
全般

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