google_kms_crypto_keys resource

Use the google_kms_crypto_keys InSpec audit resource to to test a Google Cloud CryptoKey resource.

Examples

describe google_kms_crypto_keys(project: 'chef-gcp-inspec', location: 'europe-west2', key_ring_name: 'kms-key-ring') do
  its('count') { should be >= 1 }
  its('crypto_key_names') { should include 'kms-key' }
end

Test that there are no more than a specified number of keys in the key ring

describe google_kms_crypto_keys(project: 'chef-inspec-gcp',   location: 'us-east1',  key_ring_name: 'key-ring') do
  its('count') { should be <= 100}
end

Test that an expected key name is present in the key ring

describe google_kms_crypto_keys(project: 'chef-inspec-gcp',   location: 'us-east1',  key_ring_name: 'key-ring') do
  its('crypto_key_names') { should include "my-crypto-key-name" }
end

Properties

Properties that can be accessed from the google_kms_crypto_keys resource:

See google_kms_crypto_key for more detailed information.

• crypto_key_names: an array of google_kms_crypto_key crypto_key_name
• create_times: an array of google_kms_crypto_key create_time
• labels: an array of google_kms_crypto_key labels
• purposes: an array of google_kms_crypto_key purpose
• rotation_periods: an array of google_kms_crypto_key rotation_period
• version_templates: an array of google_kms_crypto_key version_template
• next_rotation_times: an array of google_kms_crypto_key next_rotation_time
• key_rings: an array of google_kms_crypto_key key_ring
• skip_initial_version_creations: an array of google_kms_crypto_key skip_initial_version_creation

Filter criteria

This resource supports all of the above properties as filter criteria, which can be used with where as a block or a method.

GCP permissions

Ensure the Cloud Key Management Service (KMS) API is enabled for the current project.