設定ポリシーのステータスと詳細の確認 - AWSSecurity Hub
設定ポリシーの関連付けステータスの確認関連付けの失敗のトラブルシューティング

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

設定ポリシーのステータスと詳細の確認

AWS Security Hub CSPM の委任管理者は、組織の設定ポリシーとその詳細を表示できます。これには、ポリシーが関連付けられているアカウントと組織単位 (OU) が含まれます。

中央設定の利点とその仕組みについては、「Security Hub CSPM での中央設定について」を参照してください。

任意の方法を選択し、その手順に従って設定ポリシーを表示します。

Security Hub CSPM console
設定ポリシーを表示するには (コンソール)

  1. AWS Security Hub CSPM コンソール (https://console.aws.amazon.com/securityhub/) を開きます。

    ホームリージョンの委任された Security Hub CSPM 管理者アカウントの認証情報を使用してサインインします。

  2. ナビゲーションペインで、[設定]、[設定] の順に選択します。

  3. 設定ポリシーの概要については、[ポリシー] タブを選択します。

  4. 設定ポリシーを選択し、[詳細を表示] を選択すると、関連付けられているアカウントや OU など、そのポリシーに関するその他の詳細が表示されます。

Security Hub CSPM API

すべての設定ポリシーの概要リストを表示するには、Security Hub CSPM API の ListConfigurationPolicies オペレーションを使用します。AWS CLI を使用する場合は、 list-configuration-policies コマンドを実行します。委任 Security Hub CSPM 管理者アカウントは、ホームリージョンでオペレーションを呼び出す必要があります。

$ aws securityhub list-configuration-policies \
--max-items 5 \
--starting-token U2FsdGVkX19nUI2zoh+Pou9YyutlYJHWpn9xnG4hqSOhvw3o2JqjI23QDxdf

特定の設定ポリシーの詳細を表示するには、GetConfigurationPolicy オペレーションを使用します。AWS CLI を使用する場合は、get-configuration-policy を実行します。委任管理者アカウントは、ホームリージョンでオペレーションを呼び出す必要があります。詳細を表示する設定ポリシーの Amazon リソースネーム (ARN) または ID を指定します。

$ aws securityhub get-configuration-policy \
--identifier "arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"

すべての設定ポリシーとそのアカウント関連付けの概要リストを表示するには、ListConfigurationPolicyAssociations オペレーションを使用します。AWS CLI を使用する場合は、list-configuration-policy-associations コマンドを実行します。委任管理者アカウントは、ホームリージョンでオペレーションを呼び出す必要があります。オプションで、ページ分割パラメータを指定したり、特定のポリシー ID、関連付けタイプ、または関連付けステータスで結果をフィルタリングしたりできます。

$ aws securityhub list-configuration-policy-associations \
--filters '{"AssociationType": "APPLIED"}'

特定のアカウントの関連付けを表示するには、GetConfigurationPolicyAssociationオペレーションを使用します。AWS CLI を使用する場合は、get-configuration-policy-association コマンドを実行します。委任管理者アカウントは、ホームリージョンでオペレーションを呼び出す必要があります。target の場合、アカウント番号、OU ID、またはルート ID を指定します。

$ aws securityhub get-configuration-policy-association \
--target '{"AccountId": "123456789012"}'

設定ポリシーの関連付けステータスの確認

以下の中央設定 API オペレーションは、AssociationStatus というフィールドを返します。

  • BatchGetConfigurationPolicyAssociations

  • GetConfigurationPolicyAssociation

  • ListConfigurationPolicyAssociations

  • StartConfigurationPolicyAssociation

このフィールドは、基礎となる設定が設定ポリシーの場合とセルフマネージド型の動作の場合の両方で返されます。

AssociationStatus の値は、特定のアカウントにおけるポリシーの関連付けが保留中か、成功または失敗の状態かを示します。ステータスが PENDING から SUCCESS または FAILED に変わるまで、最大 24 時間かかることがあります。ステータスが SUCCESS の場合、設定ポリシーで指定されたすべての設定がアカウントに関連付けられていることを意味します。ステータスが FAILED の場合、設定ポリシーで指定された 1 つ以上の設定がアカウントとの関連付けに失敗したことを意味します。FAILED ステータスにかかわらず、アカウントはポリシーに従って部分的に設定できます。たとえば、Security Hub CSPM (有効)、AWS Foundational Security Best Practices (有効)、CloudTrail.1 (無効) を設定ポリシーに指定したアカウントを関連付けるとします。最初の 2 つの設定は成功し、CloudTrail.1 の設定は失敗した場合、一部の設定が正しく設定されていても、関連付けステータスは FAILED になります。

親 OU またはルートの関連付けステータスは、子のステータスによって異なります。すべての子の関連付けステータスが SUCCESS の場合、親の関連付けステータスは SUCCESS です。1 人以上の子の関連付けステータスが FAILED の場合、親の関連付けステータスは FAILED です。

AssociationStatus の値は、関連するすべてのリージョンのポリシーの関連付けステータスによって異なります。ホームリージョンとリンクされているすべてのリージョンで関連付けが成功すると、AssociationStatus の値は SUCCESS になります。これらの 1 つ以上のリージョンで関連付けに失敗すると、AssociationStatus の値は FAILED になります。

以下の動作は、AssociationStatus の値にも影響します。

  • ターゲットが親 OU またはルートの場合、すべての子が SUCCESS または FAILED ステータスの場合にのみ SUCCESS または FAILED の AssociationStatus が含まれます。最初に親を設定に関連付けた後に、子アカウントまたは OU の関連付けステータスが変更された場合 (リンクされたリージョンが追加または削除された場合など)、StartConfigurationPolicyAssociation API を再度呼び出さない限り、その変更によって親の関連付けステータスは更新されません。

  • ターゲットがアカウントの場合、関連付けにホームリージョンとすべてのリンクされたリージョンの SUCCESS または FAILED の結果がある場合に限り、そのアカウントには SUCCESS または FAILED の AssociationStatus があります。ターゲットアカウントを初めて設定に関連付けた後に、ターゲットアカウントの関連付けステータスが変更された場合 (リンクされたリージョンが追加または削除された場合など)、その関連付けステータスは更新されます。ただし、StartConfigurationPolicyAssociation API を再度呼び出さない限り、変更によって親の関連付けステータスは更新されません。

リンクされた新しいリージョンを追加すると、Security Hub CSPM は、新しいリージョンの PENDING、SUCCESS、FAILED ステータスにある既存の関連付けをレプリケートします。

関連付けステータスが SUCCESS であっても、ポリシーの一部である標準の有効化ステータスは不完全な状態に移行する可能性があります。その場合、Security Hub CSPM は標準コントロールの検出結果を生成できません。詳細については、「標準のステータスをチェックする」を参照してください。

関連付けの失敗のトラブルシューティング

AWS Security Hub CSPM では、設定ポリシーの関連付けは、次の一般的な原因で失敗することがあります。

  • Organizations 管理アカウントがメンバーではない – 設定ポリシーを Organizations 管理アカウントに関連付ける場合、そのアカウントの AWS Security Hub CSPM は既に有効になっている必要があります。これにより、管理アカウントが組織内のメンバーアカウントになります。

  • AWS Config が有効になっていない、または正しく設定されていない — 設定ポリシーで標準を有効にするには、AWS Config を有効にして、関連するリソースを記録するように設定する必要があります。

  • 委任管理者アカウントから関連付ける必要がある – Security Hub CSPM 委任管理者アカウントにサインインすると、ポリシーをターゲットアカウントと OU にのみ関連付けることができます。

  • ホームリージョンから関連付ける必要がある — ホームリージョンにサインインすると、ポリシーをターゲットアカウントと OU にのみ関連付けることができます。

  • オプトイン地域が有効化されていない — 委任管理者が有効化していないオプトインリージョンの場合、リンクされたリージョンのメンバーアカウントまたは OU に対するポリシーの関連付けが失敗します。委任管理者アカウントからリージョンを有効化した後で再試行できます。

  • メンバーアカウントが一時停止している — 一時停止されたメンバーアカウントにポリシーを関連付けようとすると、ポリシーの関連付けが失敗します。