Skip to main content

Access Control Lists (ACLs)

ACLs são utilizadas para controlar o acesso de tenants a buckets e objetos, permitindo um controle restrito de suas funções.

info

Para mais informações sobre ACLs, consulte a documentação de ACL.


ACL em Buckets​

É possível estabelecer uma ACL para um bucket por completo, sendo que as permissões não são passadas de forma recursiva, logo, os objetos ainda são acessíveis por terceiros.

Criar ACL do Bucket​

mgc object-storage buckets acl set --dst NOME_DO_BUCKET --public-read

Você pode adicionar a flag que melhor atenda às suas necessidades de acesso. As opções disponíveis são:

  • --private: O proprietário (Owner) possui FULL_CONTROL. Apenas o proprietário e os delegados da conta têm direitos de acesso; outros usuários não têm acesso.

  • --public-read: O proprietário (Owner) possui FULL_CONTROL. Qualquer pessoa pode ler o bucket.

  • --grant-write array (object): Permite que os destinatários criem objetos neste bucket.


Listar Bucket com ACL​

Para acessar um bucket com permissões concedidas por meio de uma Lista de Controle de Acesso (ACL). Utilize os seguintes comandos para listar todos os objetos disponíveis para o seu acesso:

mgc object-storage objects list NOME_DO_BUCKET

Verificar ACL do Bucket​

👣 Inicio > Menu > Object Storage > Menu do Bucket > Criar acesso via ACL
  1. Clique no ícone de menu ao lado do bucket para o qual deseja configurar permissões.
  2. Selecione a opção “Criar Acesso via ACL”.
  3. Na lista de acessos concedidos para o bucket, você pode:
    • Deletar um acesso clicando no ícone de exclusão (:trash:).
    • Alterar o nível de acesso entre “Leitura” e “Leitura e Escrita”.
  4. Clique em “Criar Acesso” para atualizar a lista.

ACL de Objetos​

É possível adicionar permissões para objetos específicos, permitindo um controle mais granular sobre o acesso. Além disso, permitindo que as permissões estejam presentes não apenas nos buckets, mas também em seus conteúdos.

Criar ACL de um Objeto​

mgc object-storage objects acl set "mgc-bucket-1"/"my-file"

Você pode adicionar a flag correspondente às suas necessidades de acesso. As opções disponíveis são:

  • --private: O proprietário (Owner) possui FULL_CONTROL. Apenas o proprietário e os delegados da conta têm direitos de acesso; nenhum outro usuário tem acesso.

  • --public-read: O proprietário (Owner) possui FULL_CONTROL. Qualquer pessoa pode acessar o objeto para LEITURA (Read).

  • --grant-write array (object): Permite que os destinatários criem objetos no bucket especificado.


Verificar ACL do Objeto​

mgc object-storage objects acl get NOME_DO_BUCKET/NOME_DO_OBJETO

Upload de um Objeto Público​

Fazer o upload de um objeto público significa que qualquer pessoa com o link poderá acessar esse arquivo.

Atualmente, a interface do Console não suporta a funcionalidade de upload de objetos. Para realizar essa operação, utilize as ferramentas de linha de comando (CLI).


Tornar um Objeto Público​

Tornar um objeto público permite que qualquer pessoa com o link tenha acesso a ele.

Atualmente, a interface do Console não suporta a funcionalidade de upload de objetos. Para realizar essa operação, utilize as ferramentas de linha de comando (CLI).


Criar ACL para Usuários Distintos​

Exemplos práticos:

  • Leitura: Departamentos de auditoria precisam acessar os logs, mas não modificá-los.

  • Leitura e Escrita: Equipe de TI precisa adicionar novos logs e atualizar os existentes.

Dados de Exemplo:

  • Nome do bucket: meu-bucket-super-secreto
  • Tenant ID do departamento de auditoria (somente leitura): 7e1a0618-319f-4c87-a38d-67adb33da365
  • Tenant ID da equipe de TI (leitura e escrita): 3df4456b-0390-467c-8b03-97a7d704c0fc
mgc object-storage buckets acl set --dst meu-bucket-super-secreto --grant-read id=7e1a0610-31fb-4cc7-a304-e7daddb336a5 --grant-full-control id=3df4455d-0390-407e-b803-970a77ddc940

Dicas de Uso: Teste sempre as configurações com arquivos de teste antes de aplicá-las a dados críticos para garantir que as permissões estejam corretamente configuradas.

info

Ao configurar a ACL do bucket, observe que as regras não são aplicáveis de forma recursiva, ou seja, não são transmitidas para os objetos contidos no bucket. Para aplicar regras de acesso aos objetos, utilize a ACL para Objetos.