Criando e Gerenciando Papéis Customizados
Embora os papéis predefinidos (como Administrador, Editor, Visualizador e Financeiro) cubram a maioria dos casos de uso, organizações maduras frequentemente necessitam de um controle mais refinado.
Os Papéis customizados permitem criar conjuntos específicos de permissões sob medida para funções de trabalho particulares (ex: um "Operador de Banco de Dados" que pode reiniciar bancos, mas não pode excluir instâncias ou ver dados de faturamento).
Quando criar um Papel Customizado?
Crie um papel customizado quando:
-
Um papel predefinido concede acesso excessivo (ex: você quer permitir apenas reiniciar VMs, mas o papel de "Editor" permite também excluí-las).
-
Você precisa de uma combinação de permissões que cruza diferentes serviços (ex: um papel para CI/CD que precisa acessar apenas o Registry de Containers e o Cluster Kubernetes).
Criando um Novo Papel
- 🖥️ Console
- >_ CLI
Acesse o Console da Magalu Cloud e certifique-se de estar no Contexto da Organização desejada.
No menu Turia IAM, clique em Papéis.
Você verá a lista de papéis existentes (Predefinidos e Personalizados). Clique em Criar Papel.
- Definição Básica
-
Nome: Escolha um nome claro e descritivo (ex: operador-vm-producao). Evite nomes genéricos.
-
Descrição: Documente o propósito deste papel. (ex: "Permite iniciar e parar VMs").
- Seleção de Papel Base
Você pode selecionar um ou mais papéis como base para o seu papel customizado.
-
Marque a caixa de seleção Usar como base papel já existente
-
Busque o nome dos papéis que deseja usar como base
-
As permissões granulares pertencentes ao papel selecionado aparecerão marcadas na sessão de permissões abaixo
-
Seleção de Permissões
Esta é a etapa crítica. Você verá uma lista de todas as permissões granulares disponíveis na plataforma, agrupadas por serviço (blockstorage, database, faturamento...).
-
Use a barra de busca para filtrar o serviço ou permissão desejada (ex: digite virtualmachine).
-
Selecione as ações específicas necessárias.
-
Dica: Para um papel operacional, você geralmente precisa das permissões de leitura (list, get) além das permissões de ação (start, stop).
-
Exemplo para um Operador de VM:
-
vm_instance_list -
vm_instance_get -
vm_instance_create -
vm_instance_delete -
vm_instance_action
-
-
Revisão e Criação
-
Revise a lista de permissões selecionadas.
-
Clique em Criar Papel.
Execute o seguinte comando garantindo que está no Contexto da Organização correta.
mgc iam roles create --name [NAME] --description [DESCRIPTION] --based-role [ROLE] --permissions [PERMISSIONS]
Valores dos parâmetros:
[NAME]: Nome do novo papel customizado.[DESCRIPTION]: Descrição do novo papel.[ROLE]: Nome de algum papel existente na organização para que o novo papel receba as mesmas permissões que ele.[PERMISSIONS]: Lista de permissões a serem concedidas para o novo papel.
Editando um Papel Customizado
- 🖥️ Console
- >_ CLI
- No menu Turia IAM selecione a aba Papéis
- Busque o papel que deseja editar
- Clique nos três pontinhos ao lado do nome do papel
- Selecione Editar papel
- Selecione ou remova os papéis base e permissões granulares
- Clique em Editar Papel
Execute o seguinte comando garantindo que está no Contexto da Organização correta.
mgc iam roles permissions update --name [NAME] --add [PERMISSIONS]
Valores dos parâmetros:
[NAME]: Nome do papel customizado.[PERMISSIONS]: Lista de permissões a serem concedidas para o papel. Caso queira remover permissões, substitua o parâmetro--addpor--remove.
Excluindo um Papel Customizado
- 🖥️ Console
- >_ CLI
- No menu Turia IAM selecione a aba Papéis
- Busque o papel que deseja editar
- Clique nos três pontinhos ao lado do nome do papel
- Selecione Excluir papel
- Confirme digitando o nome do papel e clicando em Remover
Execute o seguinte comando garantindo que está no Contexto da Organização correta.
mgc iam roles delete --name [NAME]
Valores dos parâmetros:
[NAME]: Nome do papel customizado a ser deletado.
Utilizando o Papel Personalizado
Uma vez criado, o papel personalizado aparece na lista junto com os papéis padrão.
-
Você pode atribuí-lo a qualquer principal da organização (Usuário, Grupo, Service Account)
-
Consulte a documentação de Gerenciando Membros e Permissões para detalhes sobre atribuição.
Manutenção e Cuidados
Diferente dos papéis predefinidos pela Magalu Cloud, os papéis customizados não são atualizados automaticamente.
Se a Magalu Cloud lançar uma nova funcionalidade (ex: uma nova feature de backup para VMs) que exige uma nova permissão (ex: vm_backup_create), seu papel personalizado não terá essa permissão automaticamente. Você precisará editar o papel manualmente para incluí-la.