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.
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 dos secretos con los siguientes nombres:
object-storage-key-std-user-oy6jdqd6bxfoqcecn2ozv6utepr5bgh355vfku7th5pmejqubdja
Obtener 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 encontrar el nombre del secreto:
kubectl auth can-i --list --namespace object-storage-access-keys | grep "object-storage-key-"Recibirás un resultado similar al siguiente:
secrets [] [object-storage-key-std-user-oy6jdqd6bxfoqcecn2ozv6utepr5bgh355vfku7th5pmejqubdja] [get]Obtén el contenido del secreto correspondiente para acceder a los segmentos de la clase de almacenamiento
Standard:kubectl get -o yaml --namespace object-storage-access-keys secret object-storage-key-std-user-oy6jdqd6bxfoqcecn2ozv6utepr5bgh355vfku7th5pmejqubdjaRecibirá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, busca el nombre del secreto en el clúster de usuarios.
Para la clase de almacenamiento estándar, ejecuta el siguiente comando para obtener el nombre del secreto:
kubectl get -n=<PROJECT-NAME> serviceaccount <SA-NAME> -o json | jq -r '.secrets[] | select(.name | test("object-storage-key-std"))'Busca manualmente entre los nombres de secretos de la lista o usa
greppara encontrarobject-storage-key-(std|nl):kubectl get -n=PROJECT_NAME \ serviceaccount SA_NAME \ -o=jsonpath='{.secrets}{"\n"}' | grep -E 'object-storage-key-(std|nl)'Haz los cambios siguientes:
PROJECT_NAME: el nombre de tu proyecto.SA_NAME: el nombre de tu cuenta de servicio.
Puedes hacer referencia al secreto en tu pod como variables de entorno o archivos.
Permisos de rol predefinidos
Los roles predefinidos están disponibles en el servidor de la API global para el acceso administrativo y operativo a los segmentos de doble zona. Estos roles también conceden acceso a los segmentos de zona, pero solo si se usa un recurso IAMRoleBinding en lugar de un recurso RoleBinding o ClusterRoleBinding. Para obtener más información sobre las vinculaciones de roles, consulta el artículo Conceder y revocar el acceso.
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 con todos los permisos de almacén de objetos que concede el rol project-bucket-object-viewer Role:
Permisos de la API de segmentos:
- get
- list
- ver
Permisos de almacenamiento de objetos de S3:
- 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 almacenamiento de objetos adicionales que concede el Role:
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 Bucket 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 Role:
Permisos de la API de segmentos:
- Crear
- Actualizar
- Eliminar