En esta página, se describe cómo realizar tareas relacionadas con Claves de encriptación administradas por el cliente (CMEK) para Firestore en modo Datastore. Para obtener más información sobre las CMEK en general, incluso cuándo y por qué habilitarlas, consulta la documentación de Cloud KMS.
Prepara tus claves CMEK
Antes de crear una base de datos en modo Datastore protegida con CMEK, debes debe completar los siguientes pasos:
- Solicita acceso a la función CMEK del modo Datastore.
- Crea (o recupera) un agente de servicio del modo Datastore.
- Crea una clave CMEK.
- Establece la configuración de IAM para esa clave.
Completa estos pasos para cada proyecto que tenga contenido protegido por CMEK Bases de datos de Firestore. Si luego creas una nueva clave CMEK, debes establecer la configuración de IAM para esa clave.
Solicitar acceso
Antes de crear un agente de servicio en modo Datastore, solicita acceso al función CMEK completando este formulario.
Crea un agente de servicio del modo Datastore
Antes de crear una clave CMEK, debes tener un modo Datastore agente de servicio, que es un tipo de cuenta de servicio administrada por Google que El modo Datastore usa para acceder a la clave.
Ejecuta el comando services Identity create para crear el agente de servicio que usa el modo Datastore para acceder a la CMEK clave por ti. Este comando crea la cuenta de servicio si aún no existe y, luego, la muestra.
gcloud beta services identity create \ --service=firestore.googleapis.com \ --project FIRESTORE_PROJECT
Reemplaza FIRESTORE_PROJECT
por el proyecto que planeas.
para tus bases de datos en modo Datastore.
El comando muestra el ID del agente de servicio, que tiene el formato de una dirección de correo electrónico. Registra la string de correo electrónico de salida, ya que la usarás en un paso posterior.
Service identity created: service-xxx@gcp-sa-firestore.iam.gserviceaccount.com
Crear una clave
Puedes usar una clave creada directamente en Cloud KMS o una clave administrada de forma externa que pongas a disposición con Cloud External Key Manager.
La ubicación de la clave de Cloud KMS debe ser la que la ubicación de la base de datos en modo Datastore que se usará tus amigos.
Para las ubicaciones regionales de bases de datos, usa el mismo nombre de ubicación para el llavero de claves, la clave y la base de datos porque los nombres tener una asignación uno a uno.
Por ejemplo, si quieres crear una base de datos protegida con CMEK en
us-west1
, crea un llavero de claves y una clave enus-west1
.Para las ubicaciones de bases de datos multirregionales, usa el nombre de la ubicación multirregional de KMS:
- Usa la ubicación multirregional
us
de Cloud KMS para la ubicación multirregionalnam5
en modo Datastore. - Usa la ubicación multirregional
europe
de Cloud KMS para la ubicación multirregionaleur3
en modo Datastore.
- Usa la ubicación multirregional
En el proyecto de Google Cloud en el que quieres administrar tus claves, completa lo siguiente:
Crea un llavero de claves y una clave mediante una de las siguientes opciones:
- Crea el llavero de claves y la clave directamente en Cloud KMS.
- Usa una clave administrada de forma externa. Crea la clave externa y, luego, crea una clave de Cloud EKM para que la clave esté disponible a través de Cloud KMS.
Establece la configuración de IAM para la clave
Console
Para otorgar una función de Cloud KMS a tu agente de servicio, haz lo siguiente. También puedes otorgar permiso a nivel de la clave o del llavero de claves si deseas reducir el nivel de detalle.
En la consola de Google Cloud, ve a la página IAM.
Haz clic en Agregar.
Ingresa el ID con formato de correo electrónico para tu modo Datastore agente de servicio.
Selecciona la función Encriptador/Desencriptador de CryptoKey de Cloud KMS.
Haz clic en Guardar.
gcloud
Otorga la función
cloudkms.cryptoKeyEncrypterDecrypter
al agente de servicio:gcloud kms keys add-iam-policy-binding KMS_KEY \ --keyring KMS_KEYRING\ --location KMS_LOCATION \ --member serviceAccount:SERVICE_AGENT_EMAIL \ --role roles/cloudkms.cryptoKeyEncrypterDecrypter \ --project KMS_PROJECT
Proporcione lo siguiente:
KMS_KEY
: es el nombre que le asignaste a la claveKMS_KEYRING
: es el llavero de claves de KMS que contiene la claveKMS_LOCATION
: la región que contiene el llavero de clavesSERVICE_AGENT_EMAIL
: es el identificador con formato de correo electrónico para el agente de servicio al que le otorgas accesoKMS_PROJECT
: el proyecto que contiene la clave
En la terminal, se debería mostrar una respuesta similar a la siguiente:
Updated IAM policy for key KMS_KEY. bindings: - members: - serviceAccount: service-{project-number}@gcp-sa-firestore.iam.gserviceaccount.com role: roles/cloudkms.cryptoKeyEncrypterDecrypter
Crea una base de datos habilitada con CMEK
Después de crear y configurar tus claves CMEK, puedes crear una cuenta de servicio en la base de datos. La base de datos existente en modo Datastore La encriptación predeterminada de Google no se puede convertir para usar CMEK. solo puedes elegir un tipo de encriptación y una clave al momento de la creación.
gcloud
gcloud alpha firestore databases create --location=FIRESTORE_DATABASE_LOCATION \
--database=DATABASE_ID \
--kms-key-name=KMS_KEY_NAME \
--project=FIRESTORE_PROJECT
Proporcione lo siguiente:
FIRESTORE_DATABASE_LOCATION
: Es la ubicación del modo Datastore para la base de datos.DATABASE_ID
: Es un ID para la base de datos.KMS_KEY_NAME
: Es el nombre que le asignaste a la tecla. Usa el nombre completo del recurso de la clave en el siguiente formato:projects/KMS_PROJECT/locations/KMS_LOCATION/keyRings/KMS_KEYRING_ID/cryptoKeys/KMS_KEY_ID
FIRESTORE_PROJECT
: Es el proyecto que se usará para tu Base de datos en modo Datastore
API de REST
Solicitud HTTP:
POST https://firestore.googleapis.com/v1/projects/{FIRESOTRE_PROJECT}/databases
En el cuerpo de la solicitud, configura CMEK en el campo cmek_config.kms_key_name
.
Se establece en el ID de recurso completo de una clave de Cloud KMS. Solo hay una clave en la misma ubicación, ya que se permite esta base de datos.
Este valor debe ser el ID de recurso de la clave de Cloud KMS en el formato de
projects/{KMS_PROJECT}/locations/{KMS_LOCATION}/keyRings/{KMS_KEYRING_ID}/cryptoKeys/{KMS_KEY_ID}
Para obtener más detalles sobre otros campos, consulta la página de database create
.
Solicitud de ejemplo:
curl -X POST 'https://firestore.googleapis.com/v1/projects/FIRESTORE_PROJECT/databases?databaseId={DATABASE_ID}' \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-type: application/json" \
-d '{
"type":"FIRESTORE_NATIVE",
"locationId":"{FIRESTORE_DATABASE_LOCATION}",
"cmekConfig": {
"kmsKeyName":"projects/KMS_PROJECT/locations/KMS_LOCATION/keyRings/KMS_KEYRING_ID/cryptoKeys/KMS_KEY_ID"
}
}'
Terraform
Para crear una base de datos habilitada para CMEK, usa google_firestore_database
recurso. Para obtener más información y ejemplos, consulta
google_firestore_database
resource "google_firestore_database" "database" {
project = "FIRESTORE_PROJECT"
name = "DATABASE_ID"
location_id = "FIRESTORE_DATABASE_LOCATION"
type = "DATABASE_TYPE"
cmek_config {
kms_key_name = "KMS_KEY_NAME"
}
}
Proporcione lo siguiente:
FIRESTORE_PROJECT
: Es el proyecto que se usará para tu Base de datos en modo DatastoreDATABASE_ID
: Es un ID para la base de datos.FIRESTORE_DATABASE_LOCATION
: Es la ubicación del modo Datastore para la base de datos.DATABASE_TYPE
: Es FIRESTORE_NATIVE para el modo nativo o DATASTORE_MODE para el modo Datastore.KMS_KEY_NAME
: Es el nombre que le asignaste a la tecla. Usa el nombre completo del recurso de la clave en el siguiente formato:projects/KMS_PROJECT/locations/KMS_LOCATION/keyRings/KMS_KEYRING_ID/cryptoKeys/KMS_KEY_ID
Accede a una base de datos protegida por CMEK
Todas las operaciones de lectura, escritura y consulta que se envían a una base de datos protegida con CMEK debería funcionar de la misma manera que con una base de datos encriptada predeterminada de Google. Por ejemplo, no es necesario que proporciones una clave para cada solicitud.
Visualiza la clave en uso
gcloud
Puedes usar la databases describe en gcloud CLI para confirmar la configuración de CMEK de la base de datos:
gcloud firestore databases describe --database=DATABASE_ID --project=FIRESTORE_PROJECT
Deberías ver la información de CMEK en el campo cmekConfig
de la respuesta.
similar al siguiente:
cmekConfig:
activeKeyVersion:
- projects/PROJECT_ID/locations/us/keyRings/KEYRING_NAME/cryptoKeys/KEY_NAME/cryptoKeyVersions/1
kmsKeyName: projects/PROJECT_ID/locations/us/keyRings/KEYRING_NAME/cryptoKeys/KEY_NAME
locationId: nam5
name: projects/PROJECT_ID/databases/DATABASE_ID
La respuesta incluye la siguiente información:
kmsKeyName
: Es el nombre completo del recurso de la clave que se usa para encriptar. tu base de datos protegida con CMEK.activeKeyVersion
: Es una lista de todas las versiones de claves en uso en el momento. la base de datos protegida con CMEK. Durante la rotación de claves, pueden ser varias versiones de claves activas.
API de REST
Solicitud HTTP:
GET https://firestore.googleapis.com/v1/{name=projects/FIRESTORE_PROJECT/databases/DATABASE_ID}
En el cuerpo de la solicitud, configura CMEK en el campo cmek_config.kms_key_name
.
Se establece en el ID de recurso completo de una clave de Cloud KMS. Solo hay una clave en la misma
ubicación, ya que se permite esta base de datos.
Este valor debe ser el ID de recurso de la clave de Cloud KMS en el formato de
projects/{KMS_PROJECT}/locations/{KMS_LOCATION}/keyRings/{KMS_KEYRING_ID}/cryptoKeys/{KMS_KEY_ID}
Para obtener más detalles sobre otros campos, consulta la página de database create
.
Ejemplo de solicitud y respuesta:
curl 'https://firestore.googleapis.com/v1/projects/FIRESTORE_PROJECT/databases/{DATABASE_ID}' \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-type: application/json"
—----------------------------------------- Response —--------------------------------------------
{
"name": "projects/FIRESTORE_PROJECT/databases/{DATABASE_ID}",
"locationId": "{FIRESTORE_DATABASE_LOCATION}",
"type": "FIRESTORE_NATIVE",
"cmekConfig": {
"kmsKeyName": "projects/{KMS_PROJECT}/locations/{KMS_LOCATION}/keyRings/{KMS_KEYRING_ID}/cryptoKeys/{KMS_KEY_ID}",
"activeKeyVersion": [
"projects/{KMS_PROJECT}/locations/{KMS_LOCATION}/keyRings/{KMS_KEYRING_ID}/cryptoKeys/{KMS_KEY_ID}/cryptoKeyVersions/1"
]
},
……
}
Inhabilita una clave
Para inhabilitar una clave asociada con una base de datos, completa lo siguiente:
- Consulta las versiones de clave en uso de una base de datos
- Inhabilita esas versiones de clave
- Espera a que el cambio surta efecto y comprueba si los datos ya no están accesible. Los cambios suelen aplicarse en minutos, pero puede tardar hasta 3 horas.
Cuando se inhabilita una clave usada por una base de datos, se espera recibir un
Excepción FAILED_PRECONDITION
con detalles adicionales en el mensaje de error.
por ejemplo:
{ "error": { "code": 400, "message": "The customer-managed encryption key required by the requested resource is not accessible. Error reason: generic::permission_denied: Permission 'cloudkms.cryptoKeyVersions.useToEncrypt' denied on resource 'projects/FIRESTORE_PROJECT/locations/{KMS_LOCATION}/keyRings/{KMS_KEYRING_ID}/cryptoKeys/{KMS_KEY_ID}' (or it may not exist).", "status": "FAILED_PRECONDITION", "details": [ { "@type": "type.googleapis.com/google.rpc.DebugInfo", "detail": "The customer-managed encryption key required by the requested resource is not accessible. Error reason: generic::permission_denied: Permission 'cloudkms.cryptoKeyVersions.useToEncrypt' denied on resource 'projects/FIRESTORE_PROJECT/locations/{KMS_LOCATION}/keyRings/{KMS_KEYRING_ID}/cryptoKeys/{KMS_KEY_ID}' (or it may not exist)" } ] } }
Habilita una clave
Para volver a habilitar una clave asociada con una base de datos, completa los siguientes pasos:
- Consulta las versiones de clave en uso de una base de datos
- Habilita esas versiones de clave.
- Espera a que el cambio surta efecto y comprueba si los datos ya no están accesible. Los cambios suelen aplicarse en minutos, pero puede tardar hasta 3 horas.
Visualiza los registros de auditoría de una clave de Cloud KMS
Antes de habilitar los registros de auditoría de acceso a los datos de Cloud KMS, debes estar familiarizado con los registros de auditoría de Cloud.
Los registros de auditoría de acceso a los datos de Cloud KMS te muestran cuándo Datastore o cualquier otro producto configurado para usar tu La clave CMEK realiza llamadas de encriptación y desencriptación a Cloud KMS. El modo Datastore no emite llamadas de encriptación/desencriptación en todos los datos. pública, sino que mantiene una aplicación de sondeo que verifica la clave de forma periódica. Los resultados del sondeo aparecen en los registros de auditoría.
Puedes configurar los registros de auditoría y también interactuar con ellos en la consola de Google Cloud:
Asegúrate de que el registro esté habilitado para la API de Cloud KMS en tu proyecto.
Ve a Cloud Logging en la consola de Google Cloud.
Agrega las siguientes líneas al compilador de consultas para limitar las entradas de registro a tu clave de Cloud KMS:
resource.type="cloudkms_cryptokey" resource.labels.key_ring_id = KMS_KEYRING resource.labels.crypto_key_id = KMS_KEY resource.labels.location=KMS_LOCATION
Proporcione lo siguiente:
KMS_KEY
: es el nombre de la clave CMEKKMS_KEYRING
: es el llavero de claves de KMS que contiene la claveKMS_LOCATION
: Es la ubicación de la clave y el llavero de claves.
El registro muestra un par de entradas de registro cada cinco minutos por base de datos. Las entradas de registro son similares a estos ejemplos:
Info 2021-03-20 08:02:24.869 EDT Cloudkms.googleapis.com Decrypt projects/cloud-kms-project/locations/us-central1/keyRings/firestore-keys/cryptoKeys/my-cmek-key service-123456789123@gcp-sa-firestore.iam.gserviceaccount.com audit_log, method: "Decrypt", principal_email: "service-1234567891011@gcp-sa-firestore.iam.gserviceaccount.com" Info 2021-03-20 08:02:24.913 EDT Cloudkms.googleapis.com Encrypt projects/cloud-kms-project/locations/us-central1/keyRings/firestore-keys/cryptoKeys/my-cmek-key service-123456789123@gcp-sa-firestore.iam.gserviceaccount.com audit_log, method: "Encrypt", principal_email: "service-123456789123@gcp-sa-firestore.iam.gserviceaccount.com"
Consulta Comprende los registros de auditoría para obtener detalles sobre para interpretar los registros de auditoría.
Configura una política de la organización de CMEK
Especifica los requisitos de cumplimiento de encriptación para el modo Datastore bases de datos de tu organización, usa una restricción de la política de la organización de CMEK.
Requiere protección con CMEK
Configura constraints/gcp.restrictNonCmekServices
para que requiera CMEK para
Creación de la base de datos en modo Datastore. Establece la restricción en deny
y
Agrega firestore.googleapis.com
a la lista de bloqueo, por ejemplo:
gcloud resource-manager org-policies deny gcp.restrictNonCmekServices is:firestore.googleapis.com --project=FIRESTORE_PROJECT
Reemplaza FIRESTORE_PROJECT
por el proyecto que deseas restringir.
Para obtener más información sobre la configuración de las políticas de la organización, consulta Crea y edita políticas.
Después de que la política entre en vigencia, recibirás una excepción FAILED_PRECONDITION
y un mensaje de error si intentas crear una base de datos que no sea CMEK en el proyecto afectado. Por ejemplo, una excepción se ve de la siguiente manera:
{ "error": { "code": 400, "message": "Constraint 'constraints/gcp.restrictNonCmekServices' violated for 'projects/FIRESTORE_PROJECT' attempting to perform the operation 'google.firestore.admin.v1.FirestoreAdmin.CreateDatabase' with violated value 'firestore.googleapis.com'. See https://cloud.google.com/resource-manager/docs/organization-policy/org-policy-constraints for more information.", "status": "FAILED_PRECONDITION", "details": [ { "@type": "type.googleapis.com/google.rpc.PreconditionFailure", "violations": [ { "type": "constraints/gcp.restrictNonCmekServices", "subject": "orgpolicy:projects/FIRESTORE_PROJECT", "description": "Constraint 'constraints/gcp.restrictNonCmekServices' violated for 'projects/FIRESTORE_PROJECT' attempting to perform the operation 'google.firestore.admin.v1.FirestoreAdmin.CreateDatabase' with violated value 'firestore.googleapis.com'. See https://cloud.google.com/resource-manager/docs/organization-policy/org-policy-constraints for more information." } ]
Limita el uso de claves para CMEK
Para limitar las claves de Cloud KMS que se usan para la protección con CMEK,
configura la restricción constraints/gcp.restrictCmekCryptoKeyProjects
.
Como restricción de lista, los valores aceptados son indicadores de la jerarquía de recursos (para
por ejemplo, projects/PROJECT_ID
, under:folders/FOLDER_ID
y
under:organizations/ORGANIZATION_ID
). Usa esta restricción configurando un
una lista de indicadores de jerarquía de recursos y la configuración de la restricción en Permitir.
Esta configuración restringe los servicios compatibles para que se puedan elegir las CMEK
solo de los proyectos, carpetas y organizaciones
de la lista. Solicitudes para crear
Los recursos protegidos por CMEK en los servicios configurados no funcionan sin un
Clave del modo Datastore de uno de los recursos permitidos.
En el siguiente ejemplo, solo se permiten claves de ALLOWED_KEY_PROJECT_ID para bases de datos protegidas con CMEK en el proyecto especificado:
gcloud resource-manager org-policies allow gcp.restrictCmekCryptoKeyProjects \ under:projects/ALLOWED_KEY_PROJECT_ID \ --project=FIRESTORE_PROJECT
Una vez que la política entre en vigencia, recibirás una excepción FAILED_PRECONDITION
y un mensaje de error si infringes la restricción. Excepción
se ve de la siguiente manera:
{ "error": { "code": 400, "message": "Constraint 'constraints/gcp.restrictCmekCryptoKeyProjects' violated for 'projects/FIRESTORE_PROJECT' attempting to perform the operation 'google.firestore.admin.v1.FirestoreAdmin.CreateDatabase' with violated value 'projects/{NOT_ALLOWED_KEY_PROJECT}'. See https://cloud.google.com/resource-manager/docs/organization-policy/org-policy-constraints for more information.", "status": "FAILED_PRECONDITION", "details": [ { "@type": "type.googleapis.com/google.rpc.PreconditionFailure", "violations": [ { "type": "constraints/gcp.restrictCmekCryptoKeyProjects", "subject": "orgpolicy:projects/FIRESTORE_PROJECT", "description": "Constraint 'constraints/gcp.restrictCmekCryptoKeyProjects' violated for 'projects/FIRESTORE_PROJECT' attempting to perform the operation 'google.firestore.admin.v1.FirestoreAdmin.CreateDatabase' with violated value 'projects/{NOT_ALLOWED_KEY_PROJECT}'. See https://cloud.google.com/resource-manager/docs/organization-policy/org-policy-constraints for more information." } ] } ] } }