GoTerm
Todas las guías

Claves y seguridad

Tu clave, en tu propia nube

En Business, o con el complemento en Teams, la clave de tu espacio de trabajo puede vivir en tu propia clave de AWS KMS o Google Cloud KMS. Tu servicio de claves guarda lo que abre tus contraseñas y claves guardadas, y puedes cortarle el acceso a GoTerm desde tu propia consola.

Actualizado el

En esta página
  1. Cómo funciona
  2. AWS: crear la clave
  3. AWS: copiar el ARN de la clave
  4. AWS: crear el rol que asume GoTerm
  5. AWS: dejar que el rol use la clave
  6. AWS: copiar el ARN del rol
  7. En GoTerm: usar tu clave de AWS
  8. Google Cloud: crear un llavero
  9. Google Cloud: crear la clave
  10. Google Cloud: dejar que GoTerm use la clave
  11. Google Cloud: copiar el nombre de la clave
  12. En GoTerm: usar tu clave de Google Cloud
  13. Ver tu clave en la nube en uso
  14. Cortar a GoTerm, y dejarle volver
  15. Cuando no funciona

Cómo funciona

GoTerm crea la clave de tu espacio de trabajo y hace que tu servicio de claves la cifre. Cuando alguien se conecta, la pasarela pide a tu servicio de claves que la descifre, como mucho una vez cada 5 minutos.

La pasarela → Tu servicio de clavesdescifra la claveTu servicio de claves → La pasarelala claveLa pasarelaabre el secretoLa pasarela → Tu servidorentra
Cuando alguien se conecta, la pasarela hace que tu servicio de claves descifre la clave de tu espacio, la guarda hasta 5 minutos, abre con ella el secreto y entra en tu servidor.
  • Desactiva tu clave en tu consola y, en 5 minutos, GoTerm ya no puede abrir tus contraseñas y claves guardadas. El trabajo ya abierto termina antes de una hora.
  • Tu clave nunca sale de tu servicio de claves: GoTerm solo le pide cifrar y descifrar.
  • GoTerm solo llama a las direcciones de los proveedores: STS y KMS de AWS en la región de tu clave, y el inicio de sesión y Cloud KMS de Google.

AWS: crear la clave

  1. En la consola de AWS, elige la región donde debe vivir tu clave, abre Key Management Service (KMS), luego Customer-managed keys y Create key.
  2. Elige Symmetric y Encrypt and decrypt, luego Next.
  3. Dale un alias que reconozcas, y termina.

AWS: copiar el ARN de la clave

  1. Abre la clave. En General configuration, copia su ARN: empieza por arn:aws:kms: y termina en key/ y el ID de la clave.
  2. Guárdalo para los pasos siguientes. Usa el ARN de la clave, nunca su alias: una política que nombra un alias no deja cifrar nada con la clave.

AWS: crear el rol que asume GoTerm

GoTerm llega a tu clave a través de un rol de tu cuenta. El ID externo de tu espacio de trabajo hace que ese rol sea solo tuyo.

  1. En GoTerm, en la página Security, elige Use your own cloud key… y luego AWS KMS. La primera vez, elige Make this workspace's external ID.
  2. Pega el ARN de la clave en The key's ARN y elige Copy en la política de confianza.
  3. En la consola de AWS, abre IAM, luego Roles y Create role. Elige Custom trust policy y sustituye la política que hay por la de GoTerm.

Consejo: Deja abierta la ventana de GoTerm: vuelves a ella dos veces.

AWS: dejar que el rol use la clave

  1. En la ventana de GoTerm, elige Copy en la política de la clave, bajo la política de confianza. Permite kms:Encrypt y kms:Decrypt sobre el ARN de tu clave, y nada más.
  2. En la consola de AWS, en Add permissions, elige Create inline policy y pégala.
  3. Ponle nombre al rol y créalo.

AWS: copiar el ARN del rol

  1. Abre el rol. En Summary, copia su ARN: empieza por arn:aws:iam:: y termina en role/ y el nombre del rol.

En GoTerm: usar tu clave de AWS

  1. En la ventana de GoTerm, pega el ARN del rol en The role's ARN. El ARN de la clave ya está.
  2. Elige Use this key. GoTerm hace que tu clave cifre la clave de tu espacio, y comprueba que se descifra de nuevo antes de usarla.
  3. Tus contraseñas y claves guardadas pasan entonces a la clave nueva.

Google Cloud: crear un llavero

  1. En la consola de Google Cloud, elige tu proyecto y abre Security, Key management y Create key ring.
  2. Ponle nombre, como goterm-key, elige Region y la región donde debe vivir tu clave, y luego Create.

Google Cloud: crear la clave

  1. En el llavero, elige Create key y ponle nombre.
  2. Deja Protection Level en Software.
  3. En Purpose, elige Symmetric encrypt/decrypt, y luego Create.

Google Cloud: dejar que GoTerm use la clave

  1. En GoTerm, en la página Security, elige Use your own cloud key…, luego Google Cloud KMS, y Copy en la cuenta de servicio de GoTerm.
  2. En la consola de Google Cloud, abre la clave, luego Permissions y Grant access.
  3. Pega la cuenta de servicio de GoTerm en New principals, elige el rol Cloud KMS CryptoKey Encrypter/Decrypter y luego Save.

Consejo: Concede el rol solo en esta clave, nunca en el proyecto.

Google Cloud: copiar el nombre de la clave

  1. En la lista de claves del llavero, abre el menú ⋮ de la clave y elige Copy resource name.
  2. Empieza por projects/ y termina en cryptoKeys/ y el nombre de la clave. Un nombre que termina en una versión de la clave también vale: GoTerm usa la clave.

En GoTerm: usar tu clave de Google Cloud

  1. En la ventana de GoTerm, pega el nombre de la clave en The key's name.
  2. Elige Use this key. GoTerm hace que tu clave cifre la clave de tu espacio, y comprueba que se descifra de nuevo antes de usarla.

Ver tu clave en la nube en uso

  1. En la página Security, Where your key lives nombra tu servicio de claves, tu clave y, en AWS, el rol.
  2. Para cambiar de clave, elige Use another cloud key…. Para dejarlo, elige Move it back to goterm's server…: el servidor de GoTerm mueve tus secretos por sí mismo.

Cortar a GoTerm, y dejarle volver

  1. En AWS, selecciona la clave, luego Key actions y Disable. Enable deja volver a GoTerm.
  2. En Google Cloud, abre el menú ⋮ de la clave y elige Disable all key versions. Volver a activar la versión deja volver a GoTerm.
  3. A los 5 minutos de desactivarla, GoTerm ya no puede abrir tus contraseñas y claves guardadas, y el trabajo ya abierto termina antes de una hora. El registro de auditoría dice que tu clave en la nube rechazó a GoTerm.

Consejo: Quitarle los permisos a GoTerm también funciona, pero tarda más: tu proveedor lo aplica a su ritmo, y en AWS una política de confianza cambiada espera a que termine la sesión de rol actual de GoTerm, como mucho 15 minutos.

Cuando no funciona

  • Your cloud key refused goterm: revisa la política de confianza del rol, su política de la clave y que la clave esté activada. En Google Cloud, revisa el rol en la clave.
  • ¿El ARN de la clave es un alias, como alias/goterm-key? Usa el ARN que termina en key/ y el ID de la clave.
  • Your cloud key service couldn’t be reached: el proveedor no respondió. Vuelve a intentarlo en un momento; no hay nada que cambiar.
  • Cada rechazo queda en el registro de auditoría, con el motivo de tu servicio de claves, como DisabledException.
  • ¿Perdiste la clave en la nube para siempre? El propietario del espacio puede empezar de cero: los secretos sellados con ella se borran, y el servidor de GoTerm guarda una clave nueva.

¿No encuentras tu respuesta?

Escríbenos y te contestará un ingeniero de los que construyen GoTerm.

Preguntar a un ingeniero