Acerca de los secretos
Los secretos son variables de entorno cifradas que se crean en la configuración de GitHub Codespaces para una organización, un repositorio o una cuenta personal. Para obtener más información sobre la creación de secretos específicos del usuario, consulta "Administrar secretos para sus codespaces".
Los secretos que creas están disponibles para su uso en GitHub Codespaces. GitHub usa una caja sellada de libsodium para cifrar secretos antes de que lleguen a GitHub y solamente los descifra cuando se usan en un codespace.
Los secretos a nivel organizacional le permiten compartir secretos entre repositorios múltiples, lo cual reduce la necesidad de crear secretos duplicados. Puedes utilizar las políticas de acceso para controlar qué repositorios pueden utilizar los secretos de la organización.
Una vez que hayas creado un secreto, estará disponible cuando creas un codespace nuevo o cuando reinicias el codespace. Si has creado un secreto en GitHub.com y deseas usarlo en un codespace que se está ejecutando actualmente, detén dicho codespace y, a continuación, reinícialo. Para información sobre cómo detener el codespace, consulta "Uso de la paleta de Comandos de Visual Studio Code en GitHub Codespaces".
Nombrar secretos
Las siguientes reglas aplican a los nombres secretos:
-
Los nombres de secretos solo pueden contener caracteres alfanuméricos (
[a-z]
,[A-Z]
,[0-9]
) o caracteres de subrayado (_
). No se permiten espacios. -
Los nombres de secreto 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 creó a nivel de repositorio debe tener un nombre único en dicho repositorio y uno que se haya cerado a nivel organizacional debe tener un nombre único en dicho nivel.
Si existe un secreto con el mismo nombre en varios niveles, tiene preferencia el del nivel más bajo. 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 por organización y 100 por repositorio.
Los secretos tienen un tamaño máximo de 48 KB.
Secretos recomendados para un repositorio
El proyecto puede requerir secretos de usuario específicos. Por ejemplo, para ejecutar la aplicación en un codespace, es posible que el usuario tenga que proporcionar una clave de API personal. Si este es el caso, puedes especificar secretos recomendados en la configuración del contenedor de desarrollo. A continuación, se pedirá al usuario que proporcione valores para estos secretos, si aún no se han creado estos secretos personales, cuando usen la página de opciones avanzadas para crear un codespace. Si el usuario proporciona un valor secreto para su uso en el codespace, este secreto se agrega a su configuración personal para Codespaces. No tendrán que escribir un valor para este secreto cuando creen un codespace para este repositorio en el futuro. Para obtener más información, vea «Especificación de secretos recomendados para un repositorio».
Agregar secretos para un repositorio
Para crear secretos para un repositorio de la organización, debes tener acceso adminsitrativo.
-
En GitHub.com, navega a la página principal del repositorio.
-
En el nombre del repositorio, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.
-
En la sección "Seguridad" de la barra lateral, seleccione Secretos y variables, y haga clic en Codespaces.
-
En la parte superior de la página, haga clic en New repository secret.
-
Escriba un nombre para el secreto en el cuadro de entrada Name.
-
Ingresa el valor de tu secreto.
-
Haga clic en Add Secret.
Agregar secretos para una organización
Cuando creas un secreto en una organización, puedes utilizar una política para limitar el acceso de los repositorios a este. Por ejemplo, puedes otorgar acceso a todos los repositorios, o limitarlo a solo los repositorios privados o a una lista específica de estos.
Para crear secretos en el nivel de la organización, debe tener acceso admin
.
-
En GitHub.com, ve a la página principal de la organización.
-
En el nombre de la organización, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.
-
En la sección "Seguridad" de la barra lateral, seleccione Secretos y variables, y haga clic en Codespaces.
-
En la parte superior de la página, haga clic en New organization secret.
-
Escriba un nombre para el secreto en el cuadro de entrada Name.
-
Introduzca el valor del secreto en Value.
-
En la lista desplegable Repository access (Acceso al repositorio), elija una directiva de acceso.
-
Haga clic en Add Secret.
Revisar el acceso a los secretos de nivel organizacional
Puedes revisar qué políticas de acceso se aplican a un secreto en tu organización.
-
En GitHub.com, ve a la página principal de la organización.
-
En el nombre de la organización, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.
-
En la sección "Seguridad" de la barra lateral, seleccione Secretos y variables, y haga clic en Codespaces.
-
La lista de secretos incluye cualquier política y permiso configurado. Por ejemplo:
-
Para obtener más información sobre los permisos configurados para cada secreto, haga clic en Update.