Control types for @turbot/gcp-composer

• GCP > Composer > API Enabled
• GCP > Composer > CMDB
• GCP > Composer > Discovery
• GCP > Composer > Environment > Active
• GCP > Composer > Environment > Approved
• GCP > Composer > Environment > CMDB
• GCP > Composer > Environment > Discovery
• GCP > Composer > Environment > Labels
• GCP > Composer > Environment > Usage

GCP > Composer > API Enabled

Check whether GCP Composer API is enabled.

API Enabled refers specifically to the API state of a service in a cloud project.
This control determines whether the API state is set as per desired level.

The GCP > Composer > API Enabled control compares
the API state against the API Enabled policies,
raises an alarm, and takes the defined enforcement action.

GCP > Composer > CMDB

Record and synchronize details for the GCP Composer into the CMDB.

The CMDB control is
responsible for populating and updating all the attributes for that
resource type in the Guardrails CMDB.

Note: If CMDB is set to Skip for a resource, then it will not be added
to the CMDB, and no controls that target it will run.

GCP > Composer > Discovery

Discover GCP Composer resources and add them to the CMDB.

The Discovery
control is tasked with identifying instances for a particular resource.
The Discovery control will periodically search for new target resources and
save them to the Guardrails CMDB. Once discovered, resources are then
responsible for tracking changes to themselves through the
CMDB control.

GCP > Composer > Environment > Active

Take an action when an GCP Composer environment is not active based on the
GCP > Composer > Environment > Active > * policies.

The Active control determines whether the resource is in active use, and if not, has
the ability to delete / cleanup the resource. When running an automated compliance
environment, it's common to end up with a wide range of alarms that are difficult
and time consuming to clear. The Active control brings automated, well-defined
control to this process.

The Active control checks the status of all defined Active policies for the
resource (GCP > Composer > Environment > Active > *),
raises an alarm, and takes the defined enforcement action. Each Active
sub-policy can calculate a status of active, inactive or skipped. Generally,
if the resource appears to be Active for any reason it will be considered Active.

Note the contrast with Approved, where if the resource appears to be Unapproved
for any reason it will be considered Unapproved.

See Active for more information.

GCP > Composer > Environment > Approved

Take an action when a GCP Composer environment is not approved based on GCP > Composer > Environment > Approved > * policies.

The Approved control checks the status of the defined Approved sub-policies for the resource. If the resource is not approved according to any of these policies, this control raises an alarm and takes the defined enforcement action.

For any enforcement actions that specify if new, e.g., Enforce: Delete unapproved if new, this control will only take the enforcement actions for resources created within the last 60 minutes.

See Approved for more information.

GCP > Composer > Environment > CMDB

Record and synchronize details for the GCP Composer environment into the CMDB.

The CMDB control is
responsible for populating and updating all the attributes for that
resource type in the Guardrails CMDB.

Note: If CMDB is set to Skip for a resource, then it will not be added
to the CMDB, and no controls that target it will run.

CMDB controls also use the Regions policy associated with the resource. If
region is not in GCP > Composer > Environment > Regions policy, the CMDB control will delete the
resource from the CMDB.

GCP > Composer > Environment > Discovery

Discover GCP Composer environment resources and add them to the CMDB.

The Discovery
control is tasked with identifying instances for a particular resource.
The Discovery control will periodically search for new target resources and
save them to the Guardrails CMDB. Once discovered, resources are then
responsible for tracking changes to themselves through the
CMDB control.

Note that Discovery and CMDB controls also use the Regions policy
associated with the resource. If the region is not in GCP > Composer > Environment > Regions policy, the CMDB
control will delete the resource from the CMDB.

GCP > Composer > Environment > Labels

Take an action when an GCP Composer environment labels is not updated based on the GCP > Composer > Environment > Labels > * policies.

If the resource is not updated with the labels defined in GCP > Composer > Environment > Labels > Template, this control raises an alarm and takes the defined enforcement action.

See Labels for more information.

GCP > Composer > Environment > Usage

The Usage control determines whether the number of GCP Composer environment resources exceeds the configured usage limit for this region.

You can configure the behavior of this control with the GCP > Composer > Environment > Usage policy, and set the limit with the GCP > Composer > Environment > Usage > Limit policy.