En esta página, se muestra cómo crear una clave en Cloud KMS. Una clave puede ser una clave de encriptación simétrica o asimétrica, una clave de firma asimétrica o una clave de firma de MAC.
Cuando creas una clave, debes agregarla a un llavero de claves en una ubicación de Cloud KMS específica. Puedes crear un llavero de claves nuevo o usar uno existente. En esta página, generarás una clave nueva de Cloud KMS o Cloud HSM y la agregarás a un llavero de claves existente. Para crear una clave de Cloud EKM, consulta Crea una clave externa. Para importar una clave de Cloud KMS o Cloud HSM, consulta Cómo importar una clave.
Antes de comenzar
Antes de completar las tareas de esta página, necesitas lo siguiente:
- Un recurso de proyecto Google Cloud para contener tus recursos de Cloud KMS. Te recomendamos que uses un proyecto independiente para tus recursos de Cloud KMS que no contenga ningún otro recurso de Google Cloud .
- El nombre y la ubicación del llavero de claves en el que deseas crear tu clave. Elige un llavero en una ubicación cercana a tus otros recursos y que admita el nivel de protección que elegiste. Para ver las ubicaciones disponibles y los niveles de protección que admiten, consulta Ubicaciones de Cloud KMS. Para crear un llavero de claves, consulta Crea un llavero de claves.
- Opcional: Para usar gcloud CLI, prepara tu entorno.
En la consola de Google Cloud , activa Cloud Shell.
Roles obligatorios
Para obtener los permisos que necesitas para crear claves, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto o un recurso principal:
- Administrador de Cloud KMS (
roles/cloudkms.admin) -
Para crear claves de HSM de usuario único, se requiere el rol de Creador de claves de HSM de usuario único de Cloud KMS (
roles/cloudkms.hsmSingleTenantKeyCreator).
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para crear claves. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para crear claves:
-
cloudkms.cryptoKeys.create -
cloudkms.cryptoKeys.get -
cloudkms.cryptoKeys.list -
cloudkms.cryptoKeyVersions.create -
cloudkms.cryptoKeyVersions.get -
cloudkms.cryptoKeyVersions.list -
cloudkms.keyRings.get -
cloudkms.keyRings.list -
cloudkms.locations.get -
cloudkms.locations.list -
resourcemanager.projects.get -
Para recuperar una clave pública, haz lo siguiente:
cloudkms.cryptoKeyVersions.viewPublicKey -
Para crear claves de HSM de usuario único, sigue estos pasos:
-
cloudkms.singleTenantHsmInstances.get -
cloudkms.singleTenantHsmInstances.use
-
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Crea una clave de encriptación simétrica
Console
En la consola de Google Cloud , ve a la página Administración de claves.
Haz clic en el nombre del llavero de claves para el que crearás la clave.
Haz clic en Crear clave.
En Nombre de la clave, ingresa un nombre para la clave.
En Nivel de protección, selecciona Software, HSM o HSM de un solo arrendatario.
Si seleccionaste HSM de usuario único, selecciona la instancia de HSM de usuario único en la que deseas crear la clave.
En Material de clave, selecciona Clave generada.
Para Propósito, selecciona Encriptación/desencriptación simétrica.
Acepta los valores predeterminados de Período de rotación y A partir del.
Haz clic en Crear.
gcloud
Para usar Cloud KMS en la línea de comandos, primero instala o actualiza a la versión más reciente de Google Cloud CLI.
Para crear una clave de software o de Cloud HSM multiusuario, usa el comando kms keys create:
gcloud kms keys create KEY_NAME \
--keyring KEY_RING \
--location LOCATION \
--purpose "encryption" \
--protection-level "PROTECTION_LEVEL"
Reemplaza lo siguiente:
KEY_NAME: el nombre de la clave.KEY_RING: el nombre del llavero de claves que incluye la claveLOCATION: la ubicación de Cloud KMS del llavero de claves.PROTECTION_LEVEL: Es el nivel de protección que se usará para la clave, por ejemplo,softwareohsm. Puedes omitir la marca--protection-levelpara las clavessoftware.
Para obtener información sobre todas las marcas y los valores posibles, ejecuta el comando con la marca --help.
--crypto-key-backend al comando kms keys create:
gcloud kms keys create KEY_NAME \
--keyring KEY_RING \
--location LOCATION \
--purpose "encryption" \
--protection-level "hsm-single-tenant" \
--crypto-key-backend="projects/INSTANCE_PROJECT/locations/LOCATION/singleTenantHsmInstances/INSTANCE_NAME"
Reemplaza lo siguiente:
INSTANCE_PROJECT: Es el identificador del proyecto en el que existe tu instancia de HSM de Cloud de un solo arrendatario.INSTANCE_NAME: Es el nombre de la instancia de Cloud HSM de un solo arrendatario en la que deseas crear la clave. Para obtener más información sobre las instancias de Cloud HSM de usuario único, consulta Crea y administra una instancia de Cloud HSM de usuario único.
Para obtener información sobre todas las marcas y los valores posibles, ejecuta el comando con la marca --help.
C#
Para ejecutar este código, primero configura un entorno de desarrollo de C# e instala el SDK de C# para Cloud KMS.
Go
Para ejecutar este código, primero configura un entorno de desarrollo de Go y, luego, instala el SDK de Go para Cloud KMS.
Java
Para ejecutar este código, primero configura un entorno de desarrollo de Java y, luego, instala el SDK de Java para Cloud KMS.
Node.js
Para ejecutar este código, primero configura un entorno de desarrollo de Node.js y, luego, instala el SDK de Node.js para Cloud KMS.
PHP
Para ejecutar este código, primero obtén información sobre cómo usar PHP en Google Cloud y, luego, instala el SDK de PHP para Cloud KMS.
Python
Para ejecutar este código, primero configura un entorno de desarrollo de Python y, luego, instala el SDK de Python para Cloud KMS.
Ruby
Para ejecutar este código, primero configura un entorno de desarrollo de Ruby y, luego, instala el SDK de Ruby para Cloud KMS.
API
En estos ejemplos, se usa curl como un cliente HTTP para demostrar el uso de la API. Para obtener más información sobre el control de acceso, consulta Accede a la API de Cloud KMS.
Para crear una clave de software o de Cloud HSM multiusuario, usa el método CryptoKey.create:
curl "https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys?crypto_key_id=KEY_NAME" \
--request "POST" \
--header "authorization: Bearer TOKEN" \
--header "content-type: application/json" \
--data '{"purpose": "ENCRYPT_DECRYPT", "versionTemplate": { "protectionLevel": "PROTECTION_LEVEL", "algorithm": "ALGORITHM" }}'