Administrar secretos cifrados para tus codespaces

Puedes almacenar información sensible, como los tokens, a la cual quieras acceder en tus codespaces en forma de variables de ambiente.

Codespaces está disponible para las organizaciones que utilicen GitHub Team o Nube de GitHub Enterprise. Para obtener más información, consulta la sección "Productos de GitHub".

Acerca de los secretos cifrados para los Codespaces

Puedes agregar a tu cuenta de usuario los secretos cifrados que quieras utilizar en tus codespaces. Por ejemplo, puede que quieras almacenar y acceder a la siguiente información sensible en forma de un secreto cifrado.

Puedes elegir qué repositorios deben tener acceso a cada secreto. Posteriormente, puedes utilizar el secreto en cualquier codespace que crees para un repositorio que tenga acceso a él.

Una vez que hayas creado un secreto, estará disponible cuando creas un codespace nuevo o cuando reinicias el codespace. Para utilizar un secreto que acabas de crear en un codespace actual, necesitarás detenerlo y reanudarlo. Para obtener más información acerca de cómo detener el codespace, consulta la sección "Utilizar la paleta de comandos en Codespaces".

Nombrar secretos

Las siguientes reglas aplican a los nombres secretos:

  • Los nombres secretos solo contienen caracteres alfanuméricos ([a-z], [A-Z], [0-9]) o guiones bajos (_). No se permiten espacios.

  • Los nombres secretos no deben comenzar con el prefijo GITHUB_.

  • Los nombres secretos no deben comenzar con un número.

  • Los nombres de secreto no distinguen entre mayúsculas y minúsculas.

  • Los nombres secretos deben ser únicos en el nivel en el que se hayan creado. Por ejemplo, un secreto que se crea a nivel de repositorio debe tener un nombre único en este.

    Si un secreto con el mismo nombre existe en varios niveles, aquél en el nivel más bajo tomará presedencia. Por ejemplo, si un secreto a nivel de organización tiene el mismo nombre que un secreto a nivel de repositorio, entonces el secreto a nivel de repositorio tomará precedencia.

Límites para los secretos

Puedes almacenar hasta 100 secretos para los Codespaces.

Los secretos tienen un tamaño máximo de 64 KB.

Agregar un secreto

  1. En la esquina superior derecha de cualquier página, da clic en tu foto de perfil y después da clic en Configuración. Icono Settings (Parámetros) en la barra de usuario
  2. En la barra lateral izquierda, da clic en Codespaces. Pestaña de Codespaces en la barra lateral de la configuración de usuario
  3. A la derecha de "Secretos de los codespaces", da clic en Secreto nuevo. Botón de "Secreto nuevo"
  4. Debajo de "Nombre", teclea un nombre para tu secreto. Caja de texto de "Nombre"
  5. Debajo de "Valor", teclea el valor de tu secreto. Caja de texto de "Valor"
  6. Selecciona el menú desplegable de "Acceso al repositorio" y luego da clic en aquél a cuyo secreto quieras acceder. Repite esto para cada repositorio del cual quieras tener acceso al secreto. Menú desplegable de "Acceso al repositorio"
  7. Haz clic en Agregar secreto (Agregar secreto).

Editar un secreto

Puedes actualizar el valor de un secreto existente y puedes cambiar qué repositorios pueden acceder a un secreto.

  1. En la esquina superior derecha de cualquier página, da clic en tu foto de perfil y después da clic en Configuración. Icono Settings (Parámetros) en la barra de usuario
  2. En la barra lateral izquierda, da clic en Codespaces. Pestaña de Codespaces en la barra lateral de la configuración de usuario
  3. Debajo de "Secretos de los codespaces"; a la derecha del secreto que quieras editar, da clic en Actualizar. Botón de "Actualizar"
  4. Debajo de "Valor", da clic en Ingresar un valor nuevo. Enlace de "Ingresar un valor nuevo"
  5. Debajo de "Valor", teclea el valor de tu secreto. Caja de texto de "Valor"
  6. Selecciona el menú desplegable de "Acceso al repositorio" y luego da clic en aquél a cuyo secreto quieras acceder. Repite esto para cada repositorio del cual quieras tener acceso al secreto. Menú desplegable de "Acceso al repositorio"
  7. Opcionalmente, para eliminar el acceso del secreto a un repositorio, deselecciona el repositorio. Casillas de verificación para eliminar el acceso a los repositorios
  8. Haz clic en Guardar cambios.

Borrar un secreto

  1. En la esquina superior derecha de cualquier página, da clic en tu foto de perfil y después da clic en Configuración. Icono Settings (Parámetros) en la barra de usuario
  2. En la barra lateral izquierda, da clic en Codespaces. Pestaña de Codespaces en la barra lateral de la configuración de usuario
  3. Debajo de "Secretos de los codespaces", a la derecha del secreto que quieras borrar, da clic en Borrar. Botón de "Borrar"
  4. Lee la advertencia y da clic en OK. Confirmación para borrar un secreto

Leer más

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.