このページでは、組織のポリシー サービスのカスタム制約を使用して、次の Google Cloud リソースに対する特定のオペレーションを制限する方法について説明します。
securitycenter.googleapis.com/BigQueryExport
securitycenter.googleapis.com/MuteConfig
securitycenter.googleapis.com/NotificationConfig
securitycenter.googleapis.com/ResourceValueConfig
securitycenter.googleapis.com/ContainerThreatDetectionSettings
securitycenter.googleapis.com/EventThreatDetectionSettings
securitycenter.googleapis.com/SecurityHealthAnalyticsSettings
securitycenter.googleapis.com/VirtualMachineThreatDetectionSettings
securitycenter.googleapis.com/WebSecurityScannerSettings
securitycentermanagement.googleapis.com/SecurityCenterService
securitycentermanagement.googleapis.com/SecurityHealthAnalyticsCustomModule
securitycentermanagement.googleapis.com/EventThreatDetectionCustomModule
組織のポリシーの詳細については、カスタムの組織のポリシーをご覧ください。
組織のポリシーと制約について
Google Cloud 組織のポリシー サービスを使用すると、組織のリソースをプログラマティックに一元管理できます。組織のポリシー管理者は組織のポリシーを定義できます。組織のポリシーは、Google Cloud リソース階層内のGoogle Cloud リソースやそれらのリソースの子孫に適用される、制約と呼ばれる一連の制限です。組織のポリシーは、組織レベル、フォルダレベル、またはプロジェクト レベルで適用できます。
組織のポリシーは、さまざまな Google Cloud サービスに事前に定義された制約を提供します。ただし、組織のポリシーで制限されている特定のフィールドをカスタマイズ可能な方法でよりきめ細かく制御する必要がある場合は、カスタム制約を作成して、組織のポリシーでそれらのカスタム制約を使用することもできます。
ポリシーの継承
デフォルトでは、組織のポリシーは、そのポリシーを適用したリソースの子孫に継承されます。たとえば、フォルダにポリシーを適用した場合、 Google Cloud はそのフォルダ内のすべてのプロジェクトにそのポリシーを適用します。この動作の詳細と変更方法については、階層評価ルールをご覧ください。
始める前に
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- 組織 ID を確実に把握します。
必要なロール
組織のポリシーを管理するために必要な権限を取得するには、組織のリソースに対する組織のポリシー管理者(roles/orgpolicy.policyAdmin
)の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
カスタム制約を作成する
カスタム制約は、組織のポリシーを適用しているサービスでサポートされるリソース、メソッド、条件、アクションを使用して YAML ファイルで定義されます。カスタム制約の条件は、Common Expression Language(CEL)を使用して定義されます。CEL を使用してカスタム制約で条件を作成する方法については、カスタム制約の作成と管理の CEL セクションをご覧ください。
カスタム制約を作成するには、次の形式で YAML ファイルを作成します。
name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resourceTypes:
- RESOURCE_NAME
methodTypes:
- CREATE
- UPDATE
condition: "CONDITION"
actionType: ACTION
displayName: DISPLAY_NAME
description: DESCRIPTION
次のように置き換えます。
ORGANIZATION_ID
: 組織 ID(123456789
など)。CONSTRAINT_NAME
: 新しいカスタム制約に付ける名前。カスタム制約はcustom.
で始まる必要があり、大文字、小文字、数字のみを含めることができます。例:custom.SccNotificationConfig
。このフィールドの最大長は 70 文字です。RESOURCE_NAME
: 制限するオブジェクトとフィールドを含むGoogle Cloud リソースの完全修飾名。例:securitycenter.googleapis.com/NotificationConfig
CONDITION
: サポート対象のサービス リソースの表現に対して書き込まれる CEL 条件。このフィールドの最大長は 1000 文字です。条件の書き込み先として使用できるリソースの詳細については、サポート対象のリソースをご覧ください。例:"resource.pubsubTopic != 'projects/PROJECT_ID/topics/TOPIC_ID'"
ACTION
:condition
が満たされている場合に実行するアクション。有効な値はALLOW
とDENY
です。DISPLAY_NAME
: 制約の名前。わかりやすい名前を入力してください。このフィールドの最大長は 200 文字です。DESCRIPTION
: ポリシー違反時にエラー メッセージとして表示される制約の説明。わかりやすい説明を入力してください。このフィールドの最大長は 2,000 文字です。
カスタム制約の作成方法については、カスタム制約の定義をご覧ください。
カスタム制約を設定する
新しいカスタム制約の YAML ファイルを作成したら、組織内の組織のポリシーで使用できるように設定する必要があります。カスタム制約を設定するには、gcloud org-policies set-custom-constraint
コマンドを使用します。gcloud org-policies set-custom-constraint CONSTRAINT_PATH
CONSTRAINT_PATH
は、カスタム制約ファイルのフルパスに置き換えます。たとえば、/home/user/customconstraint.yaml
です。完了すると、カスタム制約が組織のポリシーとして Google Cloud 組織のポリシーのリストに表示されます。カスタム制約が存在することを確認するには、gcloud org-policies list-custom-constraints
コマンドを使用します。gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
ORGANIZATION_ID
は、組織リソースの ID に置き換えます。詳細については、組織のポリシーの表示をご覧ください。カスタムの組織のポリシーを適用する
ブール型制約を適用するには、それを参照する組織のポリシーを作成し、その組織のポリシーを Google Cloud リソースに適用します。Console
- Google Cloud コンソールで、[組織のポリシー] ページに移動します。
- プロジェクト選択ツールで、組織のポリシーを設定するプロジェクトを選択します。
- [組織のポリシー] ページのリストで制約を選択して、その制約の [ポリシーの詳細] ページを表示します。
- このリソースの組織のポリシーを構成するには、[ポリシーを管理] をクリックします。
- [ポリシーの編集] ページで、[Override parent's policy] を選択します。
- [ルールを追加] をクリックします。
- [適用] セクションで、この組織のポリシーの適用を有効にするかどうかを選択します。
- 省略可: タグで組織のポリシーに条件を設定するには、[条件を追加] をクリックします。組織のポリシーに条件付きルールを追加する場合は、少なくとも 1 つは無条件のルールを追加する必要があります。そうしないとポリシーを保存できないのでご注意ください。詳細については、タグ付きの組織のポリシーの設定をご覧ください。
- カスタム制約の場合は、[変更内容をテスト] をクリックして、組織のポリシーの効果をシミュレートできます。詳細については、Policy Simulator で組織のポリシーの変更をテストするをご覧ください。
- 組織のポリシーを完成させて適用するには、[ポリシーを設定] をクリックします。ポリシーが有効になるまでに最大 15 分かかります。
gcloud
ブール型制約を適用する組織のポリシーを作成するには、制約を参照するポリシー YAML ファイルを作成します。
name: projects/PROJECT_ID/policies/CONSTRAINT_NAME spec: rules: - enforce: true
次のように置き換えます。
-
PROJECT_ID
: 制約を適用するプロジェクト。 -
CONSTRAINT_NAME
: カスタム制約に定義した名前。たとえば、custom.SccNotificationConfig
のようにします。
制約を含む組織のポリシーを適用するには、次のコマンドを実行します。
gcloud org-policies set-policy POLICY_PATH
POLICY_PATH
は、組織のポリシーの YAML ファイルのパスに置き換えます。ポリシーが有効になるまでに最大 15 分かかります。
カスタム組織のポリシーをテストする
次の例では、securitycenter.googleapis.com/NotificationConfig
リソースのカスタム制約を作成します。この制約により、ユーザーは指定された Pub/Sub トピックにサブスクライブされている通知構成のみを作成または変更できます。
始める前に、次のことを理解しておく必要があります。
- 組織の ID
- プロジェクト ID
- Pub/Sub トピック ID
制約を作成する
カスタム制約を定義する
notificationConfig_constraint.yaml
という名前の YAML ファイルを作成します。name: organizations/ORGANIZATION_ID/customConstraints/custom.SccNotificationConfig resourceTypes: - securitycenter.googleapis.com/NotificationConfig methodTypes: - CREATE - UPDATE condition: "resource.pubsubTopic != 'projects/PROJECT_ID/topics/TOPIC_ID'" actionType: DENY displayName: Only let users create or modify notification configs that are subscribed to a specific Pub/Sub topic. description: "Can't create or modify notification configs that are subscribed to the specified Pub/Sub topic."
制約を適用します。
gcloud org-policies set-custom-constraint ~/notificationConfig_constraint.yaml
制約が存在することを確認します。
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID --filter="RESOURCE_TYPES='securitycenter.googleapis.com/NotificationConfig'"
ポリシーを作成する
組織のポリシーを定義する
notificationConfig_policy.yaml
という名前の YAML ファイルを作成します。name: projects/PROJECT_ID/policies/custom.SccNotificationConfig spec: rules: - enforce: true
ポリシーを適用します。
gcloud org-policies set-policy ~/notificationConfig_policy.yaml
ポリシーが存在することを確認します。
gcloud org-policies list --organization=ORGANIZATION_ID --filter="constraint:custom.SccNotificationConfig"
ポリシーのテスト
組織のポリシーに違反する通知構成を作成してみます。
gcloud scc notifications create NOTIFICATION_CONFIG_ID \
--pubsub-topic=projects/PROJECT_ID/topics/example_topic \
--project=PROJECT_ID \
--filter="state=\"ACTIVE\""
次のような出力が表示されます。
Operation denied by custom org policies:
["customConstraints/SccNotificationConfig": "Can't create or modify
notification configs that are subscribed to the specified Pub/Sub
topic."]
一般的なユースケースのカスタム組織ポリシーの例
次の表に、一般的なユースケースのカスタム制約の構文を示します。
説明 | 制約の構文 |
---|---|
特定の Pub/Sub トピックに登録されている通知構成のみをユーザーが作成または変更できるようにします。 |
name: organizations/ORGANIZATION_ID/customConstraints/custom.SccNotificationConfig resourceTypes: - securitycenter.googleapis.com/NotificationConfig methodTypes: - CREATE - UPDATE condition: "resource.pubsubTopic != 'projects/PROJECT_ID/topics/TOPIC_ID'" actionType: DENY displayName: Only let users create or modify notification configs that are subscribed to a specific Pub/Sub topic. description: "Can't create or modify notification configs that are subscribed to the specified Pub/Sub topic." |
ユーザーが特定の BigQuery データセットのみをエクスポートできるようにします。 |
name: organizations/ORGANIZATION_ID/customConstraints/custom.SccBigQueryExport resourceTypes: - securitycenter.googleapis.com/BigQueryExport methodTypes: - CREATE - UPDATE condition: "resource.dataset != 'projects/PROJECT_ID/datasets/DATASET_ID'" actionType: DENY displayName: Only let users export a specific BigQuery dataset. description: "Can't export the specified BigQuery dataset." |
ユーザーが Container Threat Detection 設定リソースのサービス有効化状態を変更できないようにします。このユースケースは、Event Threat Detection、Security Health Analytics、Virtual Machine Threat Detection、Web Security Scanner の設定リソースにも適用されます。 |
name: organizations/ORGANIZATION_ID/customConstraints/custom.SccKtdSettings resourceTypes: - securitycenter.googleapis.com/securitycenter.googleapis.com/ContainerThreatDetectionSettings methodTypes: - CREATE - UPDATE condition: "resource.serviceEnablementState != ENABLED" actionType: DENY displayName: Prevent users from changing the Container Threat Detection service enablement state. description: "Can't change the Container Threat Detection service enablement state." |
ユーザーが Security Health Analytics カスタム モジュール リソースの有効化状態を変更できないようにします。このユースケースは、Event Threat Detection カスタム モジュール リソースにも適用されます。 |
name: organizations/ORGANIZATION_ID/customConstraints/custom.SccShaCustomModule resourceTypes: - securitycentermanagement.googleapis.com/SecurityHealthAnalyticsCustomModule methodTypes: - CREATE - UPDATE condition: "resource.serviceEnablementState != ENABLED" actionType: DENY displayName: Prevent users from changing the Security Health Analytics custom module enablement state. description: "Can't change the Security Health Analytics custom module enablement state." |
Security Command Center でサポートされているリソース
次の表に、カスタム制約で参照できる Security Command Center リソースを示します。リソース | フィールド |
---|---|
securitycenter.googleapis.com/BigQueryExport |
resource.dataset
|
resource.description
| |
resource.name
| |
securitycenter.googleapis.com/ContainerThreatDetectionSettings |
resource.modules
|
resource.name
| |
resource.serviceEnablementState
| |
securitycenter.googleapis.com/EventThreatDetectionSettings |
resource.modules
|
resource.name
| |
resource.serviceEnablementState
| |
securitycenter.googleapis.com/MuteConfig |
resource.description
|
resource.expiryTime
| |
resource.name
| |
resource.type
| |
securitycenter.googleapis.com/NotificationConfig |
resource.description
|
resource.name
| |
resource.pubsubTopic
| |
securitycenter.googleapis.com/ResourceValueConfig |
resource.cloudProvider
|
resource.description
| |
resource.name
| |
resource.resourceLabelsSelector
| |
resource.resourceType
| |
resource.resourceValue
| |
resource.scope
| |
resource.tagValues
| |
securitycenter.googleapis.com/SecurityHealthAnalyticsSettings |
resource.modules
|
resource.name
| |
resource.serviceEnablementState
| |
securitycenter.googleapis.com/VirtualMachineThreatDetectionSettings |
resource.modules
|
resource.name
| |
resource.serviceEnablementState
| |
securitycenter.googleapis.com/WebSecurityScannerSettings |
resource.modules
|
resource.name
| |
resource.serviceEnablementState
| |
securitycentermanagement.googleapis.com/EventThreatDetectionCustomModule |
resource.description
|
resource.displayName
| |
resource.enablementState
| |
resource.name
| |
resource.type
| |
securitycentermanagement.googleapis.com/SecurityCenterService |
resource.intendedEnablementState
|
resource.modules
| |
resource.name
| |
securitycentermanagement.googleapis.com/SecurityHealthAnalyticsCustomModule |
resource.customConfig.customOutput.properties.name
|
resource.customConfig.description
| |
resource.customConfig.recommendation
| |
resource.customConfig.resourceSelector.resourceTypes
| |
resource.customConfig.severity
| |
resource.displayName
| |
resource.enablementState
| |
resource.name
|
次のステップ
- 組織のポリシー サービスについて詳細を学習する。
- 組織のポリシーの作成と管理の方法について学習する。
- 事前定義された組織のポリシーの制約の完全なリストを確認する。