Conceder e receber acesso ao bucket de armazenamento para projetos

Nesta página, mostramos como gerenciar o acesso a buckets de armazenamento em projetos do Google Distributed Cloud (GDC) com isolamento físico para que as pessoas certas tenham as permissões adequadas. Ele aborda os pré-requisitos e as etapas para obter e conceder acesso a usuários e conta de serviço usando vinculações de papéis e papéis predefinidos. Com essas informações, você pode controlar o acesso aos recursos de armazenamento de maneira eficaz e manter a segurança e a eficiência operacional.

Esta página é destinada a públicos-alvo como administradores de TI no grupo de operadores de infraestrutura ou desenvolvedores no grupo de operadores de aplicativos que gerenciam as configurações de acesso para buckets de armazenamento em ambientes do GDC com isolamento físico. Para mais informações, consulte Públicos-alvo da documentação do GDC com isolamento físico.

Antes de começar

Um namespace de projeto gerencia recursos de bucket no servidor de API Management. É preciso ter um projeto para trabalhar com buckets e objetos.

Conceder acesso ao bucket

É possível conceder acesso a recursos da API S3, como buckets e objetos nesses buckets, a entidades User e ServiceAccount criando e aplicando RoleBindings que referenciam papéis predefinidos no servidor de API Management.

Papéis predefinidos

  • project-bucket-object-viewer:: permite que um usuário liste todos os buckets no projeto, liste objetos nesses buckets e leia objetos e metadados de objetos. Ele não permite que você grave operações em objetos. Por exemplo: upload, substituição, exclusão. Tem acesso somente leitura aos buckets birregionais na organização e nos projetos dela, bem como aos objetos nesses buckets.

  • project-bucket-object-admin:: permite que um usuário liste todos os buckets no projeto e realize operações de gravação e leitura em objetos. Por exemplo: upload, substituição, exclusão. Tem acesso somente leitura aos buckets birregionais na organização e nos projetos dela, além de acesso de leitura e gravação aos objetos nesses buckets.

  • project-bucket-admin:: permite que os usuários gerenciem todos os buckets no namespace especificado, bem como todos os objetos nesses buckets. Tem acesso somente leitura aos buckets birregionais na organização e nos projetos dela, além de acesso de leitura e gravação aos objetos nesses buckets.

Para ver uma lista completa das permissões concedidas para os papéis anteriores, consulte a seção Permissões de papéis predefinidos.

É preciso ter o papel de Administrador de projetos do IAM para criar vinculações de papéis nesse projeto. Veja a seguir um exemplo de criação de um recurso RoleBinding que concede acesso a um usuário e a uma conta de serviço:

  1. Crie um arquivo YAML no 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.
    

    Substitua:

    • PROJECT_NAMESPACE: o nome do namespace do projeto.
    • SA_NAME: o nome da conta de serviço.

  2. Aplique o arquivo YAML:

    kubectl apply \
    -f rolebinding-object-admin-all-buckets.yaml
    

Receber credenciais de acesso ao bucket

Depois que você concede acesso a um bucket, ele cria as credenciais de acesso em um Secret.

O formato do nome do secret é object-storage-key-STORAGE_CLASS-SUBJECT_TYPE-SUBJECT_HASH.

  • Os valores de STORAGE_CLASS são:
    • std para a classe de armazenamento Standard.
  • Os valores de SUBJECT_TYPE são:
    • user para User.
    • sa para ServiceAccount.
  • SUBJECT_HASH é o hash SHA256 codificado em base32 do nome do assunto.

Por exemplo, o usuário bob@foo.com tem dois secrets chamados:

  1. object-storage-key-std-user-oy6jdqd6bxfoqcecn2ozv6utepr5bgh355vfku7th5pmejqubdja

Receber acesso de usuário

Para um sujeito de usuário, o secret está no namespace object-storage-access-keys no servidor de API Management.

  1. Execute o seguinte comando para encontrar o nome do secret:

    kubectl auth can-i --list --namespace object-storage-access-keys | grep "object-storage-key-"
    

    Você vai receber uma saída semelhante a esta:

    secrets        []        [object-storage-key-std-user-oy6jdqd6bxfoqcecn2ozv6utepr5bgh355vfku7th5pmejqubdja]        [get]
    
  2. Acesse o conteúdo do secret correspondente para acessar buckets na classe de armazenamento Standard:

    kubectl get -o yaml --namespace object-storage-access-keys secret object-storage-key-std-user-oy6jdqd6bxfoqcecn2ozv6utepr5bgh355vfku7th5pmejqubdja
    

    Você vai receber uma saída semelhante a esta:

    data:
      access-key-id: MEhYM08wWUMySjcyMkVKTFBKRU8=
      create-time: MjAyMi0wNy0yMiAwMTowODo1OS40MTQyMTE3MDMgKzAwMDAgVVRDIG09KzE5OTAuMzQ3OTE2MTc3
      secret-access-key: Ump0MVRleVN4SmhCSVJhbmlnVDAwbTJZc0IvRlJVendqR0JuYVhiVA==
    
  3. Decodifique o ID e a chave de acesso:

    echo "MEhYM08wWUMySjcyMkVKTFBKRU8=" | base64 -d \
        && echo \
        && echo "Ump0MVRleVN4SmhCSVJhbmlnVDAwbTJZc0IvRlJVendqR0JuYVhiVA==" | base64 -d
    

    Você vai receber uma saída semelhante a esta:

    0HX3O0YC2J722EJLPJEO
    Rjt1TeySxJhBIRanigT00m2YsB/FRUzwjGBnaXbT
    
  4. Siga a seção Configurar a CLI gdcloud com as informações resultantes.

Acessar a conta de serviço

As credenciais secretas do S3 só são criadas e disponibilizadas para serem obtidas se houver um bucket no namespace do projeto.

Para um assunto de conta de serviço (SA), encontre o nome do secret no cluster de usuário.

  1. Para a classe de armazenamento padrão, execute o seguinte comando para receber o nome do secret:

    kubectl get -n=<PROJECT-NAME> serviceaccount <SA-NAME> -o json | jq -r '.secrets[] | select(.name | test("object-storage-key-std"))'
    
  2. Procure manualmente os nomes de secrets listados ou use grep para encontrar object-storage-key-(std|nl):

    kubectl get -n=PROJECT_NAME \
        serviceaccount SA_NAME \
        -o=jsonpath='{.secrets}{"\n"}' | grep -E 'object-storage-key-(std|nl)'
    

    Substitua:

    • PROJECT_NAME: o nome do projeto.
    • SA_NAME: o nome da sua conta de serviço.
  3. É possível referenciar o Secret no pod como variáveis de ambiente ou arquivos.

Permissões de função predefinidas

Os papéis predefinidos estão disponíveis no servidor de API global para acesso administrativo e operacional a buckets de zona dupla. Esses papéis também concedem acesso a buckets zonais, mas somente se um recurso IAMRoleBinding for usado em vez de um recurso RoleBinding ou ClusterRoleBinding. Para mais informações sobre vinculações de papéis, consulte Conceder e revogar acesso.

Permissões de project-bucket-object-viewer

Esse papel concede permissões para receber e listar objetos e os metadados deles no bucket.

Confira uma lista de todas as permissões de repositório de objetos que o project-bucket-object-viewer Role concede:

  • Permissões da API Bucket:

    1. get
    2. list
    3. assistir
  • Permissões de repositório de objetos do S3:

    1. GetObject
    2. GetObjectAcl
    3. GetObjectLegalHold
    4. GetObjectRetention
    5. GetObjectTagging
    6. GetObjectVersion
    7. GetObjectVersionTagging
    8. ListBucket
    9. ListBucketVersions
    10. ListBucketMultipartUploads
    11. ListMultipartUploadParts

permissões project-bucket-object-admin

Esse papel concede permissões para colocar e excluir objetos, versões de objetos e tags no bucket. Além disso, ele também concede todas as permissões no project-bucket-object-viewer.

Confira uma lista de todas as permissões adicionais de armazenamento de objetos que o Role concede:

  • Permissões de repositório de objetos do S3:

    1. AbortMultipartUpload
    2. DeleteObject
    3. DeleteObjectTagging
    4. DeleteObjectVersion
    5. DeleteObjectVersionTagging
    6. PutObject
    7. PutObjectTagging
    8. PutObjectVersionTagging
    9. PutOverwriteObject
    10. RestoreObject

permissões de project-bucket-admin

Esse papel concede permissões para criar, atualizar ou excluir recursos do Bucket no namespace do projeto. Além disso, ele também concede todas as permissões em project-bucket-object-admin.

Confira uma lista de outras permissões concedidas pelo Role:

  • Permissões da API Bucket:

    1. Criar
    2. Atualizar
    3. Delete