Skip to main content
Publicamos actualizaciones para la documentación con frecuencia y es posible que aún se esté traduciendo esta página. Para obtener la información más reciente, consulta la documentación en inglés.

Configurar la visibilidad y el control de accesos de un paquete

Elige quién ha leído, escrito, o administrado el acceso a tu paquete y la visibilidad de tus paquetes en GitHub.

GitHub Packages está disponible con GitHub Free, GitHub Pro, GitHub Free para organizaciones, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server 3.0 o superior y GitHub AE.
GitHub Packages no está disponible para repositorios privados que pertenezcan a cuentas que utilicen planes tradicionales por repositorio. Además, las cuentas que usan planes heredados por repositorio no pueden acceder a los registros que admiten permisos granulares, ya que estas cuentas se facturan por repositorio. Para la lista de registros que admiten permisos granulares, consulta "Acerca de los permisos para los Paquetes de GitHub". Para más información, consulta "Productos de GitHub".

Un paquete puede heredar sus permisos de visibilidad y acceso de un repositorio, o bien, para los registros que admiten permisos granulares, puedes establecer la visibilidad y los permisos del paquete de manera independiente a los de un repositorio.

Para obtener la lista de registros que admiten permisiones granulares y para obtener más información sobre los permisos de paquetes, los ámbitos relacionados con paquetes para tokens de acceso personal o la administración de permisos para los flujos de trabajo de GitHub Actions, consulta "Acerca de los permisos para los Paquetes de GitHub".

Acerca de la herencia de los permisos de acceso

En los registros que admiten permisos granulares, los paquetes tienen como ámbito una cuenta u organización personal. En estos registros, puedes publicar un paquete sin vincularlo a un repositorio y, a continuación, determinar quién puede acceder al paquete estableciendo los permisos de acceso y la visibilidad en la configuración del paquete.

De forma predeterminada, si publicas un paquete vinculado a un repositorio, el paquete hereda automáticamente los permisos de acceso (pero no la visibilidad) del repositorio vinculado. Por ejemplo, un usuario que tenga acceso de lectura al repositorio vinculado también tendrá acceso de lectura al paquete. Cuando un paquete hereda automáticamente los permisos de acceso, los flujos de trabajo de GitHub Actions del repositorio vinculado también obtienen acceso al paquete de forma automática.

Un paquete solo hereda automáticamente los permisos de acceso de un repositorio vinculado si vinculas el repositorio al paquete antes de publicar el paquete, por ejemplo, agregando la etiqueta org.opencontainers.image.source de Docker a una imagen de contenedor. Si conectas un paquete publicado a un repositorio desde la página de configuración del paquete, el paquete conservará sus permisos de acceso existentes y no heredará los permisos de acceso del repositorio a menos que selecciones explícitamente esta opción. Además, las organizaciones pueden deshabilitar la herencia automática de los permisos de acceso para todos los paquetes nuevos que tengan como ámbito su organización. Para obtener más información, consulta "Deshabilitar la herencia automática de los permisos de acceso de una organización" a continuación.

Cuando un paquete hereda los permisos de un repositorio, para conceder o quitar el acceso al paquete, debes configurar las opciones de permisos del repositorio vinculado. Si quieres establecer la configuración de acceso de un paquete de manera independiente del repositorio vinculado al paquete, debes quitar los permisos heredados del paquete. Para obtener más información, consulta "Seleccionar si un paquete hereda los permisos de un repositorio" a continuación.

Si publicas un paquete en un registro que solo admite permisos de ámbito de repositorio, el paquete siempre está vinculado a un repositorio y siempre hereda los permisos del repositorio vinculado.

Acerca de cómo establecer la visibilidad y los permisos de acceso para paquetes

Si un paquete pertenece a un registro que admite permisos granulares, cualquier persona con permisos de administrador en el paquete puede establecer el paquete en privado o público. Los paquetes públicos permiten el acceso anónimo y pueden extraerse sin autenticación ni inicio de sesión a través de la CLI. Para obtener la lista de registros que admiten permisos granulares, consulta "Acerca de los permisos para los Paquetes de GitHub".

Cualquier persona con permisos de administrador en el paquete también puede conceder permisos de acceso para el paquete que son independientes de los permisos establecidos en los niveles de organización y repositorio.

Nota: Si publicas un paquete vinculado a un repositorio, el paquete hereda sus permisos del repositorio vinculado de manera predeterminada. Para acceder a la configuración de permisos granulares del paquete, debes quitar los permisos heredados del paquete. Si eres el propietario de una organización, puedes deshabilitar la herencia automática de permisos para todos los paquetes nuevos cuyo ámbito sea la organización. Para obtener más información, consulta "Selección de si un paquete hereda los permisos de un repositorio" y "Deshabilitación de la herencia automática de permisos de acceso en una organización".

Al publicar un paquete, obtendrás automáticamente permisos de administrador para el paquete. Si publicas un paquete en una organización, cualquier persona con el rol owner en la organización también obtiene permisos de administrador para el paquete.

Para paquetes con ámbito en una cuenta personal, puedes otorgar un rol de acceso a cualquier persona. Para paquetes con ámbito en una organización, puedes otorgar un rol de acceso a cualquier persona o equipo en la organización.

Si usas un flujo de trabajo de GitHub Actions para administrar los paquetes, puedes conceder un rol de acceso al repositorio en el que se almacena el flujo de trabajo en mediante el botón Agregar repositorio en "Administrar el acceso a acciones" en la configuración del paquete. Para obtener más información, vea «Configurar la visibilidad y el control de accesos de un paquete».

PermisoDescripción del acceso
LecturaPuede descargar el paquete.
Puede leer los metadatos del paquete.
EscrituraPuede cargar y descargar este paquete.
Puede leer y escribir metadatos del paquete.
AdministraciónPuedes cargar, descargar y administrar este paquete.
Puede leer y escribir metadatos del paquete.
Puedes eliminar y restaurar paquetes.

Nota: La capacidad de los flujos de trabajo de GitHub Actions para eliminar y restaurar paquetes mediante la API de REST está actualmente en versión beta pública y está sujeta a cambios.

Configurar el acceso a los paquetes para tu cuenta personal

Si tienes permisos de administrador en un paquete cuyo ámbito es una cuenta personal, puedes asignar roles de lectura, escritura o administrador a otros usuarios. Para obtener más información sobre estos roles de permisos, consulta "Visibilidad y permisos de acceso para paquetes".

Si tu paquete es privado o interno y tiene como ámbito una organización, entonces solo puedes darles acceso a otros miembros o equipos de la misma.

  1. Busca y haz clic en el nombre del paquete que quieres administrar.
  2. En la página de aterrizaje del paquete, en el lado derecho, haz clic en Configuración del paquete. Captura de pantalla de la página de aterrizaje de un paquete. En la esquina inferior derecha, "Configuración del paquete" está resaltado con un contorno naranja. 1. En "Administrar acceso" o "Acceso heredado", haz clic en Invitar equipos o personas y escribe el nombre real, el nombre de usuario o la dirección de correo electrónico de la persona a la que quieras conceder acceso. A los equipos no se les puede conceder acceso a un paquete que tenga como ámbito una cuenta personal.
  3. Junto al nombre del equipo o el usuario, utiliza el menú desplegable Rol para seleccionar un nivel de permisos que desees.

Se otorgará acceso automáticamente a los usuarios seleccionados y no necesitarán aceptar una invitación previamente.

Configurar el acceso a los paquetes para una organización

Si tienes permisos de administrador en un paquete cuyo ámbito es una organización, puedes asignar roles de lectura, escritura o administración a otros usuarios y equipos. Para obtener más información sobre estos roles de permisos, consulta "Visibilidad y permisos de acceso para paquetes".

Si tu paquete es privado o interno y tiene como ámbito una organización, entonces solo puedes darles acceso a otros miembros o equipos de la misma.

  1. En GitHub, navega a la página principal de tu organización.
  2. En el nombre de la organización, haz clic en la pestaña Paquetes. Captura de pantalla de la página de perfil de @octo-org. La pestaña "Paquetes" está resaltada con un contorno naranja. 1. Busca y haz clic en el nombre del paquete que quieres administrar.
  3. En la página de aterrizaje del paquete, en el lado derecho, haz clic en Configuración del paquete. Captura de pantalla de la página de aterrizaje de un paquete. En la esquina inferior derecha, "Configuración del paquete" está resaltado con un contorno naranja. 1. En "Administrar acceso" o "Acceso heredado", haz clic en Invitar equipos o personas y escribe el nombre real, el nombre de usuario o la dirección de correo electrónico de la persona a la que quieras conceder acceso. También puedes escribir un nombre de equipo de la organización para conceder acceso a todos sus miembros.
  4. Junto al nombre del equipo o el usuario, utiliza el menú desplegable Rol para seleccionar un nivel de permisos que desees.

Se otorgará acceso automáticamente a los usuarios o equipos seleccionados y no necesitarán aceptar una invitación previamente.

Seleccionar si un paquete hereda los permisos de un repositorio

De manera predeterminada, si publicas un paquete vinculado a un repositorio, el paquete hereda los permisos de acceso del repositorio vinculado. Se recomienda permitir que los paquetes hereden sus permisos de un repositorio, ya que esto simplifica el proceso de administración del acceso a un paquete.

Cuando un paquete hereda los permisos de un repositorio, para conceder o quitar el acceso al paquete, debes configurar los permisos del repositorio vinculado.

Si quieres configurar las opciones de acceso de un paquete en un nivel granular, independientemente del repositorio vinculado, debes quitar los permisos heredados del paquete.

Nota: Si cambias la forma en que un paquete obtiene sus permisos de acceso, se sobrescriben los permisos existentes del paquete.

Seleccionar la configuración de herencia para los paquetes que tienen como ámbito una cuenta personal

  1. En GitHub, navega hasta la página principal de tu cuenta personal.

  2. En la esquina superior derecha de GitHub.com, haga clic en la foto de perfil y luego en Your profile (Su perfil).

    Captura de pantalla del menú desplegable en la imagen de perfil de @octocat. "Tu perfil" se destaca en naranja oscuro.

  3. En la página del perfil, en el encabezado, haz clic en la pestaña Paquetes. 1. Busca y haz clic en el nombre del paquete que quieres administrar.

  4. En la página de aterrizaje del paquete, en el lado derecho, haz clic en Configuración del paquete. Captura de pantalla de la página de aterrizaje de un paquete. En la esquina inferior derecha, "Configuración del paquete" está resaltado con un contorno naranja. 1. Para elegir si un paquete hereda los permisos de acceso del repositorio vinculado, en "Administrar acceso" o "Acceso heredado", selecciona o anula la selección de Heredar acceso del repositorio (recomendado) .

    Nota: El nombre de esta sección cambia en función de si el paquete ya hereda sus permisos de un repositorio.

Seleccionar la configuración de herencia para los paquetes que tienen como ámbito una organización

Sugerencia: Si eres el propietario de una organización, puedes impedir que todos los paquetes nuevos cuyo ámbito sea la organización hereden automáticamente los permisos de un repositorio vinculado. Para obtener más información, consulta "Deshabilitar la herencia automática de los permisos de acceso de una organización" a continuación.

  1. En GitHub, navega a la página principal de tu organización.

  2. En el nombre de la organización, haz clic en la pestaña Paquetes. Captura de pantalla de la página de perfil de @octo-org. La pestaña "Paquetes" está resaltada con un contorno naranja. 1. Busca y haz clic en el nombre del paquete que quieres administrar.

  3. En la página de aterrizaje del paquete, en el lado derecho, haz clic en Configuración del paquete. Captura de pantalla de la página de aterrizaje de un paquete. En la esquina inferior derecha, "Configuración del paquete" está resaltado con un contorno naranja. 1. Para elegir si un paquete hereda los permisos de acceso del repositorio vinculado, en "Administrar acceso" o "Acceso heredado", selecciona o anula la selección de Heredar acceso del repositorio (recomendado) .

    Nota: El nombre de esta sección cambia en función de si el paquete ya hereda sus permisos de un repositorio.

Deshabilitar la herencia automática de los permisos de acceso de una organización

De manera predeterminada, si publicas un paquete vinculado a un repositorio, el paquete hereda automáticamente los permisos de acceso del repositorio vinculado. Como propietario de la organización, puedes deshabilitar la herencia automática para todos los paquetes cuyo ámbito sea la organización.

Si deshabilitas la herencia automática de los permisos de acceso, los nuevos paquetes cuyo ámbito sea la organización no heredarán automáticamente los permisos de un repositorio vinculado. Sin embargo, cualquier persona con permisos de administrador en un paquete de la organización podrá habilitar o deshabilitar la herencia de permisos de ese paquete.

  1. En la esquina superior derecha de GitHub.com, haga clic en la foto de perfil y luego en Your organizations.

    Captura de pantalla del menú desplegable en la imagen de perfil de @octocat. "Sus organizaciones" se destaca en naranja oscuro. 2. Junto a la organización, haga clic en Settings.

  2. En la barra lateral, en la sección "Código, planificación y automatización", haz clic en Paquetes.

  3. En "Configuración predeterminada del paquete", anula la selección de Heredar acceso del repositorio de origen.

  4. Haga clic en Save(Guardar).

Garantizar el acceso al flujo de trabajo para tu paquete

En el caso de los paquetes cuyo ámbito es una cuenta personal, para garantizar que un flujo de trabajo de GitHub Actions tiene acceso a tu paquete, debes otorgar acceso explícito al repositorio donde se almacena el flujo de trabajo.

El repositorio especificado no necesita ser aquél en donde se mantiene el código fuente del paquete. Puedes dar acceso de flujo de trabajo a un paquete para varios repositorios.

Si publicas un paquete vinculado a un repositorio, los flujos de trabajo de GitHub Actions en el repositorio vinculado obtienen acceso automáticamente al paquete, a menos que la organización haya deshabilitado la herencia automática de los permisos de acceso. Para obtener más información, consulta "Acerca de la herencia de los permisos de acceso y la visibilidad" más arriba.

Nota: La sincronización del paquete con el mediante el botón Agregar repositorio en "Administrar el acceso a acciones" en la configuración del paquete de un repositorio no es lo mismo que conectar el paquete a un repositorio. Para obtener más información sobre cómo vincular un repositorio al paquete, consulta "Conectar un repositorio a un paquete".

Acceso de GitHub Actions para paquetes con ámbito de cuentas personales

  1. Busca y haz clic en el nombre del paquete que quieres administrar.
  2. En la página de aterrizaje del paquete, en el lado derecho, haz clic en Configuración del paquete. Captura de pantalla de la página de aterrizaje de un paquete. En la esquina inferior derecha, "Configuración del paquete" está resaltado con un contorno naranja.
  3. Para garantizar que tu flujo de trabajo tiene acceso a tu paquete, debes agregar el repositorio donde se almacena el flujo de trabajo. En "Administrar el acceso a Acciones", az clic en Agregar repositorio y busca el repositorio que quieras agregar. Captura de pantalla de la sección "Administrar el acceso a Acciones" de la página de configuración del paquete. El botón "Agregar repositorio" está resaltado con un contorno naranja. 1. Usa el menú desplegable Rol para seleccionar el nivel de acceso predeterminado que te gustaría que tuviera el repositorio en tu paquete.

Para personalizar aún más el acceso al paquete, consulta "Configurar el acceso a los paquetes para tu cuenta personal".

Acceso de GitHub Actions para paquetes con ámbito de organizaciones

  1. En GitHub, navega a la página principal de tu organización.
  2. En el nombre de la organización, haz clic en la pestaña Paquetes. Captura de pantalla de la página de perfil de @octo-org. La pestaña "Paquetes" está resaltada con un contorno naranja. 1. Busca y haz clic en el nombre del paquete que quieres administrar.
  3. En la página de aterrizaje del paquete, en el lado derecho, haz clic en Configuración del paquete. Captura de pantalla de la página de aterrizaje de un paquete. En la esquina inferior derecha, "Configuración del paquete" está resaltado con un contorno naranja.
  4. En "Administrar el acceso a Acciones", az clic en Agregar repositorio y busca el repositorio que quieras agregar. Captura de pantalla de la sección "Administrar el acceso a Acciones" de la página de configuración del paquete. El botón "Agregar repositorio" está resaltado con un contorno naranja. 1. Usa el menú desplegable Rol para seleccionar el nivel de acceso predeterminado que te gustaría que tuviera el repositorio en tu paquete.

Para personalizar aún más el acceso al paquete, consulta "Configurar el acceso a los paquetes para una organización".

Garantizar el acceso de GitHub Codespaces al paquete

De manera predeterminada, un codespace puede acceder sin problemas a determinados paquetes que admiten permisos detallados, tales como los paquetes que se publican en el mismo repositorio con la opción de Heredar acceso seleccionada. Para obtener una lista de los registros de GitHub Packages que admiten permisos detallados y un acceso sin problemas a GitHub Codespaces, consulta "Acerca de los permisos para los Paquetes de GitHub."

De otra manera, para asegurarte de que un codespace tiene acceso a tu paquete, debes otorgar acceso al repositorio en donde se esté lanzando dicho codespace.

El repositorio especificado no necesita ser aquél en donde se mantiene el código fuente del paquete. Puedes otorgar acceso a un paquete para los codespaces en diversos repositorios.

Una vez que hayas seleccionado el paquete que quieres compartir con un codespace de un repositorio, puedes otorgar este acceso de repositorio.

  1. Busca y haz clic en el nombre del paquete que quieres administrar.

  2. En la página de aterrizaje del paquete, en el lado derecho, haz clic en Configuración del paquete. Captura de pantalla de la página de aterrizaje de un paquete. En la esquina inferior derecha, "Configuración del paquete" está resaltado con un contorno naranja.

  3. En "Manage Codespaces access", haga clic en Add repository.

    Captura de pantalla de la sección "Administrar el acceso a Codespaces" de la página de configuración del paquete. El botón "Agregar repositorio" está resaltado con un contorno naranja.

  4. Busca el repositorio que quieras agregar.

  5. Repite los pasos para cualquier repositorio adicional al que quieras otorgarle acceso.

  6. Si el codespace de un repositorio ya no necesita acceso a un paquete, puedes eliminar el acceso. Haz clic en .

    Captura de pantalla de la sección "Administrar el acceso a Codespaces" de la página de configuración del paquete. El icono de papelera está resaltado con un contorno naranja.

Configurar la visibilidad de los paquetes para tu cuenta personal

Cuando publicas un paquete por primera vez que tiene como ámbito tu cuenta personal, la visibilidad predeterminada es privada y solo tú puedes verlo. Puedes modificar el acceso a los paquetes públicos o privados si cambias la configuración de acceso.

Se puede acceder anónimamente a un paquete público sin autenticación. Una vez que hagas tu paquete público, no puedes hacerlo privado nuevamente.

  1. Busca y haz clic en el nombre del paquete que quieres administrar.

  2. En la página de aterrizaje del paquete, en el lado derecho, haz clic en Configuración del paquete. Captura de pantalla de la página de aterrizaje de un paquete. En la esquina inferior derecha, "Configuración del paquete" está resaltado con un contorno naranja.

  3. En la parte inferior de la página, en "Zona de peligro", haz clic en Cambiar visibilidad.

  4. Selecciona una configuración de visibilidad:

    • Para que cualquier usuario pueda ver el paquete, selecciona Público.

      Advertencia: Una vez que haga público un paquete, no podrá volver a hacerlo privado.

    • Para que una selección personalizada de usuarios pueda ver el paquete, selecciona Privado.

  5. Para confirmar, escribe el nombre del paquete y, a continuación, haz clic en Entiendo las consecuencias, cambiar la visibilidad del paquete.

Visibilidad de creación de un paquete para los miembros de una organización

En el caso de los registros que admiten permisos granulares, puedes elegir la visibilidad de los paquetes que los miembros de la organización pueden publicar de forma predeterminada. Para obtener la lista de estos registros, consulta "Acerca de los permisos para los Paquetes de GitHub".

  1. En la esquina superior derecha de GitHub.com, haga clic en la foto de perfil y luego en Your organizations.

    Captura de pantalla del menú desplegable en la imagen de perfil de @octocat. "Sus organizaciones" se destaca en naranja oscuro. 2. Junto a la organización, haga clic en Settings.

  2. En la izquierda, haga clic en Packages.

  3. En "Creación de paquetes", elige si quieres habilitar la creación de paquetes públicos, privados o internos.

    • Para permitir que los miembros de la organización creen paquetes públicos, haz clic en Público.
    • Para permitir que los miembros de la organización creen paquetes privados que solo puedan ver otros miembros de la organización, haz clic en Privado. Puedes personalizar aún más la visibilidad de los paquetes privados.
    • Para permitir que los miembros de la organización creen paquetes internos que puedan ver todos los miembros de la organización, haz clic en Interno. Si la organización pertenece a una empresa, todos los miembros de la empresa podrán ver los paquetes.

Configurar la visibilidad de los paquetes para una organización

Cuando publicas un paquete por primera vez, la visibilidad predeterminada es privada y solo tú puedes verlo. Puedes otorgar roles de acceso diferentes a los usuarios o equipos para tu paquete a través de la configuración de acceso.

Se puede acceder anónimamente a un paquete público sin autenticación. Una vez que hagas tu paquete público, no puedes hacerlo privado nuevamente.

  1. En GitHub, navega a la página principal de tu organización.

  2. En el nombre de la organización, haz clic en la pestaña Paquetes. Captura de pantalla de la página de perfil de @octo-org. La pestaña "Paquetes" está resaltada con un contorno naranja. 1. Busca y haz clic en el nombre del paquete que quieres administrar.

  3. En la página de aterrizaje del paquete, en el lado derecho, haz clic en Configuración del paquete. Captura de pantalla de la página de aterrizaje de un paquete. En la esquina inferior derecha, "Configuración del paquete" está resaltado con un contorno naranja.

  4. En la parte inferior de la página, en "Zona de peligro", haz clic en Cambiar visibilidad y elige una configuración de visibilidad:

    • Para que cualquier usuario pueda ver el paquete, haz clic en Público.

      Advertencia: Una vez que haga público un paquete, no podrá volver a hacerlo privado.

    • Para que una selección personalizada de ususarios de la organización pueda ver el paquete, haz clic en Privado.

    • Para que todos los miembros de la organización puedan ver el paquete, haz clic en Interno. Si la organización pertenece a una empresa, todos los miembros de la empresa podrán ver los paquetes.