Políticas para controlar el acceso al repositorio

Descubra cómo configurar políticas para controlar el acceso a los repositorios de Container Registry, junto con algunos ejemplos de políticas comunes.

Ha activado el control detallado de las operaciones que los usuarios pueden realizar en los repositorios de Oracle Cloud Infrastructure Registry (también conocido como Container Registry).

Los permisos del usuario para acceder a los repositorios proceden de los grupos a los que pertenecen. Los permisos para un grupo se definen mediante las políticas de identidad. Las políticas definen las acciones que pueden realizar los miembros de un grupo. Los usuarios acceden a los repositorios y realizan operaciones según las políticas definidas para los grupos de los que son miembros. Las políticas de identidad para controlar el acceso al repositorio se pueden definir en el arrendamiento y en el nivel de compartimento. Consulte Detalles para Container Registry.

Antes de controlar el acceso a los repositorios, debe haber creado usuarios y haberlos asignado a los grupos correspondientes (consulte Gestión de usuarios y Gestión de grupos). A continuación, puede crear políticas y sentencias de política para controlar el acceso al repositorio (consulte Gestión de políticas).

Tenga en cuenta lo siguiente:

  • Los usuarios del grupo Administradores del arrendamiento pueden realizar cualquier operación soportada en cualquier repositorio de Container Registry que pertenezca al arrendamiento.
  • Cuando la capacidad de nivel superior está activada, el acceso de nivel de repositorio se aplica al repositorio propietario y a todas sus rutas de imagen raíz y secundaria. Las rutas de imágenes secundarias no son recursos de repositorio independientes y no se pueden autorizar de forma independiente mediante políticas de nivel de repositorio. Las políticas normales de IAM siguen controlando el acceso al repositorio propietario.

Políticas comunes

Nota

Las políticas de esta sección utilizan nombres de grupos de ejemplo de la siguiente manera:

  • acme-viewers: grupo que desea limitar para solo ver una lista de repositorios.
  • acme-pullers: grupo que desea limitar para extraer imágenes.
  • acme-pushers: grupo que desea autorizar para transferir y extraer imágenes.
  • acme-managers: grupo que desea autorizar para transferir y extraer imágenes, suprimir repositorios y editar metadatos del repositorio (por ejemplo, para hacer público un repositorio privado).

Asegúrese de sustituir los nombres de grupos de ejemplo por los nombres de su propio grupo.

Permitir a los usuarios ver una lista de todos los repositorios que pertenecen al arrendamiento o a un compartimento

Tipo de acceso: capacidad para ver una lista de todos los repositorios de Container Registry que pertenecen al arrendamiento (o a un compartimento concreto). Los usuarios no podrán:

  • ver las imágenes o capas en un repositorio
  • transferir imágenes a un repositorio o extraerlas del mismo

Dónde crear la política:

  • En el arrendamiento. Por ejemplo:

    Allow group acme-viewers to inspect repos in tenancy
  • En el arrendamiento o en un compartimento. Por ejemplo:

    Allow group acme-viewers to inspect repos in compartment acme-compartment
Permitir a los usuarios extraer imágenes de cualquier repositorio que pertenezca al arrendamiento o a un compartimento

Tipo de acceso: capacidad de extraer imágenes (capas y manifiestos) de cualquier repositorio de Container Registry que pertenezca al arrendamiento (o a un compartimento concreto).

Dónde crear la política:

  • En el arrendamiento. Por ejemplo:

    Allow group acme-pullers to read repos in tenancy
  • En el arrendamiento o en un compartimento. Por ejemplo:

    Allow group acme-pullers to read repos in compartment acme-compartment
Permitir a los usuarios extraer imágenes de repositorios específicos en el arrendamiento o en un compartimento

Tipo de acceso: capacidad de extraer imágenes (capas y manifiestos) de cualquier repositorio en Container Registry que tenga un nombre que comience por "acme-web-app" y que pertenezca al arrendamiento (o que pertenezca a un compartimento concreto).

Dónde crear la política:

  • En el arrendamiento. Por ejemplo:

    Allow group acme-pullers to read repos in tenancy where all { target.repo.name=/acme-web-app*/ }
  • En el arrendamiento o en un compartimento. Por ejemplo:

    Allow group acme-pullers to read repos in compartment acme-compartment where all { target.repo.name=/acme-web-app*/ }

Cuando la capacidad de nivel superior está activada, target.repo.name identifica el repositorio propietario. Por ejemplo, para una imagen a la que se hace referencia como acme-web-app/backend:v1 en el repositorio acme-web-app, el valor de target.repo.name es acme-web-app.

Una política que otorga acceso de extracción a ese repositorio permite a los usuarios extraer imágenes de su ruta raíz y todas las rutas secundarias que se encuentran debajo de ella. No puede utilizar target.repo.name para restringir ese acceso a una ruta secundaria individual.

Permitir que los usuarios transfieran imágenes a repositorios que soportan operaciones push (y crear nuevos repositorios si es necesario) en el arrendamiento o en un compartimento

Tipo de acceso: capacidad para transferir imágenes (capas y manifiestos) a repositorios de Container Registry que soportan operaciones de transferencia y que pertenecen al arrendamiento o a un compartimento concreto. Los repositorios de caché de recuperación no soportan operaciones push de cliente.

Los usuarios siempre necesitan los permisos REPOSITORY_READ y REPOSITORY_UPDATE para transferir imágenes. Si el repositorio especificado aún no existe, los usuarios también necesitan el permiso REPOSITORY_CREATE para crear un nuevo repositorio en el compartimento raíz del arrendamiento al transferir la imagen. Para obtener más información sobre este escenario inusual, consulte Creación de un repositorio.

Dónde crear la política:

  • En el arrendamiento. Por ejemplo:

    Allow group acme-pushers to manage repos in tenancy

    Si considera que el ejemplo anterior es demasiado permisivo (ya que incluye los permisos REPOSITORY_MANAGE y REPOSITORY_DELETE, que no son necesarios para transferir imágenes), puede restringir los permisos para especificar explícitamente los permisos que desea otorgar. Por ejemplo:

    Allow group acme-pushers to manage repos in tenancy where ANY {request.permission = 'REPOSITORY_READ', request.permission = 'REPOSITORY_UPDATE', request.permission = 'REPOSITORY_CREATE'}
  • En el arrendamiento o en un compartimento. Por ejemplo, en un compartimento:

    Allow group acme-pushers to manage repos in compartment acme-compartment

    Tenga en cuenta que si crea la política en un compartimento que no sea el compartimento raíz como se muestra anteriormente, los usuarios no pueden transferir una imagen a un repositorio que aún no existe. Esto se debe a que la política anterior no otorga a los usuarios permiso para crear un nuevo repositorio en el compartimento raíz del arrendamiento. Para obtener más información sobre este escenario inusual, consulte Creación de un repositorio.

Permitir a los gestores realizar cualquier operación soportada en cualquier repositorio que pertenezca al arrendamiento o a un compartimento

Tipo de acceso: capacidad para realizar cualquier operación en cualquier repositorio de Container Registry que pertenezca al arrendamiento (o a un compartimento concreto), incluidas las siguientes:

  • Extraer una imagen de cualquier repositorio.
  • Transfiera una imagen a cualquier repositorio que soporte operaciones de transferencia. Los repositorios de caché de recuperación no soportan operaciones push de cliente.
  • Cree un nuevo repositorio. Es decir, para crear un repositorio vacío en cualquier compartimento o para crear un repositorio en el compartimento raíz del arrendamiento al transferir una imagen para la que todavía no existe un repositorio. Tenga en cuenta que si crea la política en un compartimento que no sea el compartimento raíz, los usuarios no pueden transferir una imagen a un repositorio que aún no existe. Esto se debe a que la política no otorga a los usuarios permiso para crear un nuevo repositorio en el compartimento raíz. Para obtener más información sobre este escenario inusual, consulte Creación de un repositorio.
  • Suprimir un repositorio.
  • Cambie de un repositorio público en un repositorio privado o de un repositorio privado que soporte el acceso público en un repositorio público.

Dónde crear la política:

  • En el arrendamiento. Por ejemplo:

    Allow group acme-managers to manage repos in tenancy
  • En el arrendamiento o en un compartimento. Por ejemplo:

    Allow group acme-managers to manage repos in compartment acme-compartment

    Tenga en cuenta que si crea la política anterior en un compartimento que no sea el compartimento raíz, los usuarios no pueden transferir una imagen a un repositorio que aún no existe. Esto se debe a que la política no otorga a los usuarios permiso para crear un nuevo repositorio en el compartimento raíz. Para obtener más información sobre este escenario inusual, consulte Creación de un repositorio.