En esta página se explica cómo gestionar el acceso a los segmentos de almacenamiento de los proyectos de Google Distributed Cloud (GDC) aislados para que los usuarios adecuados tengan los permisos correspondientes. Se incluyen los requisitos previos y los pasos para obtener y conceder acceso a cuentas de usuario y de servicio mediante vinculaciones de roles y roles predefinidos. Esta información te permite controlar de forma eficaz el acceso a tus recursos de almacenamiento y mantener la seguridad y la eficiencia operativa.
Esta página está dirigida a audiencias como administradores de TI del grupo de operadores de infraestructura o desarrolladores del grupo de operadores de aplicaciones que gestionan la configuración de acceso de los segmentos de almacenamiento en entornos GDC aislados. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.
Antes de empezar
Un espacio de nombres de proyecto gestiona los recursos de segmento en el servidor de la API Management. Debes tener un proyecto para trabajar con segmentos y objetos.
Conceder acceso al segmento
Puedes conceder acceso a recursos de la API de S3, como segmentos y objetos de esos segmentos, a sujetos de User y ServiceAccount creando y aplicando RoleBindings que hagan referencia a roles predefinidos en el servidor de la API de gestión.
Roles predefinidas
project-bucket-object-viewer: permite que un usuario vea todos los segmentos del proyecto, los objetos de esos segmentos, los objetos y los metadatos de los objetos. No te permite escribir operaciones en objetos. Por ejemplo, subir, sobrescribir o eliminar. Tiene acceso de solo lectura a los segmentos de doble región de la organización y sus proyectos, así como a los objetos de esos segmentos.
project-bucket-object-admin: permite que un usuario vea todos los segmentos del proyecto y realice operaciones de escritura y lectura en objetos. Por ejemplo, subir, sobrescribir o eliminar. Tiene acceso de solo lectura a los segmentos de doble región de la organización y sus proyectos, así como acceso de lectura y escritura a los objetos de esos segmentos.
project-bucket-admin: permite que los usuarios gestionen todos los segmentos del espacio de nombres indicado, así como todos los objetos de esos segmentos. Tiene acceso de solo lectura a los segmentos de doble región de la organización y sus proyectos, así como acceso de lectura y escritura a los objetos de esos segmentos.
Para ver una lista completa de los permisos concedidos a los roles anteriores, consulta la sección Permisos de roles predefinidos.
Para crear vinculaciones de roles en un proyecto, debes tener el rol de administrador de proyectos de gestión de identidades y accesos en ese proyecto. A continuación, se muestra un ejemplo de cómo crear un recurso RoleBinding que concede acceso a un usuario y a una cuenta de servicio:
Crea un archivo YAML en tu sistema, como
rolebinding-object-admin-all-buckets.yaml.# Example file name: # rolebinding-object-admin-all-buckets.yaml apiVersion: rbac.authorization.k8s.io/v1 kind: RoleBinding metadata: namespace: PROJECT_NAMESPACE name: readwrite-all-buckets roleRef: kind: Role name: project-bucket-object-admin apiGroup: rbac.authorization.k8s.io subjects: - kind: ServiceAccount namespace: PROJECT_NAMESPACE name: SA_NAME - kind: User namespace: PROJECT_NAMESPACE name: bob@example.com apiGroup: rbac.authorization.k8s.io # Could be bob or bob@example.com based on your organization settings.Haz los cambios siguientes:
PROJECT_NAMESPACE: el nombre del espacio de nombres del proyectoSA_NAME: el nombre de la cuenta de servicio
Aplica el archivo YAML:
kubectl apply \ -f rolebinding-object-admin-all-buckets.yaml
Obtener credenciales de acceso a segmentos
Una vez que hayas concedido acceso a un segmento, se crearán las credenciales de acceso en un secreto. Se necesitan credenciales para configurar la CLI de Distributed Cloud y ejecutar comandos para interactuar con el segmento.
El formato del nombre del secreto es object-storage-key-STORAGE_CLASS-SUBJECT_TYPE-SUBJECT_HASH.
- Los valores de
STORAGE_CLASSson los siguientes:stdpara la clase de almacenamientoStandard.
- Los valores de
SUBJECT_TYPEson los siguientes:userpara el usuario.sapara ServiceAccount.
SUBJECT_HASHes el hash SHA256 codificado en base32 del nombre del asunto.
Por ejemplo, el usuario bob@foo.com tiene un secreto llamado:
object-storage-key-std-user-l74gbpyrsbmwy4mivocr3nur6dzrnhcfhe3otyplul42i732aama
Obtener credenciales de acceso de usuario
En el caso de un usuario, el secreto se encuentra en el espacio de nombres object-storage-access-keys del servidor de la API Management.
Ejecuta el siguiente comando para ver la lista de recursos de Secret que tienes permiso para ver en el espacio de nombres
object-storage-access-keys:kubectl auth can-i --list --namespace object-storage-access-keys | grep "object-storage-key-"Si puedes ver algún secreto en este espacio de nombres, verás un resultado que contiene uno o varios nombres de secretos que empiezan por
object-storage-key-, como los siguientes:secrets [] [object-storage-key-std-user-l74gbpyrsbmwy4mivocr3nur6dzrnhcfhe3otyplul42i732aama] [get]NOTA: Si eres un administrador con permiso para ver todos los recursos de Secret o para suplantar la identidad de otros usuarios, puedes ejecutar uno de los siguientes comandos para encontrar el nombre de los secretos de un usuario concreto:
Muestra todos los secretos que pertenecen a un usuario específico:
export USER_NAME=bob@example.com kubectl get secrets --namespace object-storage-access-keys -o json | jq -r --arg USER_NAME "${USER_NAME:?}" '.items[] | select( (.metadata.annotations."object.gdc.goog/subject"==$USER_NAME)) | .metadata.name'Suplantar la identidad de un usuario para ver qué secretos puede ver:
export USER_NAME=bob@example.com kubectl auth can-i --list --namespace object-storage-access-keys --as "${USER_NAME:?}" | grep "object-storage-key-"
Obtén el contenido del secreto correspondiente:
kubectl get -o yaml --namespace object-storage-access-keys secret SECRET_NAMERecibirás un resultado similar al siguiente:
data: access-key-id: MEhYM08wWUMySjcyMkVKTFBKRU8= create-time: MjAyMi0wNy0yMiAwMTowODo1OS40MTQyMTE3MDMgKzAwMDAgVVRDIG09KzE5OTAuMzQ3OTE2MTc3 secret-access-key: Ump0MVRleVN4SmhCSVJhbmlnVDAwbTJZc0IvRlJVendqR0JuYVhiVA==Descodifica el ID de clave de acceso y el secreto:
echo "MEhYM08wWUMySjcyMkVKTFBKRU8=" | base64 -d \ && echo \ && echo "Ump0MVRleVN4SmhCSVJhbmlnVDAwbTJZc0IvRlJVendqR0JuYVhiVA==" | base64 -dRecibirás un resultado similar al siguiente:
0HX3O0YC2J722EJLPJEO Rjt1TeySxJhBIRanigT00m2YsB/FRUzwjGBnaXbTSigue la sección Configurar la CLI gdcloud con la información resultante.
Obtener acceso a la cuenta de servicio
Las credenciales secretas de S3 solo se crean y están disponibles si hay un segmento en el espacio de nombres del proyecto.
En el caso de un asunto de cuenta de servicio, el secreto se crea en el mismo espacio de nombres que la cuenta de servicio.
Ejecuta el siguiente comando para verificar que puedes obtener y mostrar los recursos de Secret en el espacio de nombres. Si no es así, ponte en contacto con tu administrador:
export SA_NAMESPACE=PROJECT_NAMESPACE
kubectl auth can-i --list --namespace $SA_NAMESPACE
Para encontrar el nombre del secreto, ejecuta:
export SA_NAME=SA_NAME
kubectl get secrets --namespace $SA_NAMESPACE -o json | jq -r --arg USER_NAME "${SA_NAME:?}" '.items[] | select( (.metadata.annotations."object.gdc.goog/subject"==$USER_NAME)) | .metadata.name'
Recibirás un resultado similar al siguiente:
object-storage-key-std-sa-mng3olp3vsynhswzasowzu3jgzct2ert72pjp6wsbzqhdwckwzbq
Puedes hacer referencia al secreto en tu pod como variables de entorno o archivos.
Permisos de roles predefinidos
Ten en cuenta que los roles predefinidos también están disponibles en el servidor de la API global para el acceso administrativo y operativo a los buckets de dos zonas.
Permisos project-bucket-object-viewer
Este rol concede permisos para obtener y mostrar objetos y metadatos de objetos en el segmento.
A continuación, se muestra una lista de todos los permisos de almacén de objetos que concede el verbo project-bucket-object-viewer:
Permisos de la API de segmentos:
- get
- list
- ver
Permisos de almacenamiento de objetos de S3:
- GetBucketVersioning
- GetObject
- GetObjectAcl
- GetObjectLegalHold
- GetObjectRetention
- GetObjectTagging
- GetObjectVersion
- GetObjectVersionTagging
- ListBucket
- ListBucketVersions
- ListBucketMultipartUploads
- ListMultipartUploadParts
permisos de administrador de proyectos, segmentos y objetos
Este rol concede permisos para colocar y eliminar objetos, así como versiones y etiquetas de objetos, en el segmento. Además, también concede todos los permisos del project-bucket-object-viewer.
A continuación, se muestra una lista con todos los permisos de almacén de objetos adicionales que concede el rol:
Permisos de almacenamiento de objetos de S3:
- AbortMultipartUpload
- DeleteObject
- DeleteObjectTagging
- DeleteObjectVersion
- DeleteObjectVersionTagging
- PutObject
- PutObjectTagging
- PutObjectVersionTagging
- PutOverwriteObject
- RestoreObject
permisos de administrador de proyectos y segmentos
Este rol concede permisos para crear, actualizar o eliminar recursos de segmento en el espacio de nombres del proyecto. Además, también concede todos los permisos de project-bucket-object-admin.
A continuación se muestra una lista de los permisos adicionales que concede el rol:
Permisos de la API de segmentos:
- Crear
- Actualizar
- Eliminar