Administração

Convidar seu time

Uma conta CloudBroker pode ter múltiplos usuários sob a mesma organização. Quem administra pode convidar novos membros por email, atribuindo um papel:

Papel	O que pode fazer
admin	Tudo o que altera configuração: conectar fontes de custo, criar/editar/apagar Apps, Grupos e serviços de IA, definir orçamentos, gerenciar usuários, configurar o fluxo de deploy, criar API Keys do tipo SDK e registrar revisão de findings
approver	Aprova ou rejeita deploys que exigem revisão (ex.: PR acima do limite de custo com ação "aprovação") — sem as demais ações administrativas
viewer	Consulta todos os dados de custo, recomendações e o FinOps Advisor, sem poder alterar configuração

Leitura é igual para todos os papéis — o papel define o que cada pessoa pode gerenciar e aprovar, não o que pode ver. Ações de escrita são restritas a admin por padrão (o backend responde 403 para os demais); a única exceção é aprovar/rejeitar deploy, liberada também para approver. Ações sobre a própria conta — trocar senha, criar a própria API Key MCP, desconectar uma fonte — não dependem de papel. A checagem é feita no servidor a cada requisição, com o papel atual do usuário — mudar o papel de alguém vale na hora, sem novo login.

Uma organização pode ter no máximo 3 admins. Convidar ou promover um quarto é recusado.

O convite é enviado por email com um link único de ativação.

Multi-tenant

Cada organização é isolada por tenantId desde o modelo de dado — não existe consulta cross-tenant em nenhum caminho de código. Ver detalhe em Segurança.

Remover acesso

Um admin pode remover qualquer membro da organização, ou mudar o papel dele, a qualquer momento.

Remover ou rebaixar um admin tem efeito em cascata: todas as API Keys dessa pessoa são revogadas na hora, e credenciais de conector que são pessoais de quem conectou (hoje, o token de conta do Supabase) são limpas. Credenciais que pertencem à empresa, como a da AWS, permanecem — apagá-las interromperia a coleta de custo de quem ficou. Isso evita que uma key com poder de admin continue válida depois que o acesso foi retirado.

API Keys

Integrações usam API Keys tipadas, criadas em Configurações → aba Conta. Existem dois tipos:

Tipo	Quem cria	Para que serve
mcp	Qualquer papel (key pessoal)	Usar o cloudbroker-mcp no seu assistente de IA. O que a key consegue fazer segue o papel atual de quem a criou — um viewer só lê.
sdk	Só admin	Enviar eventos de custo — SDK de IA/nuvem e registro de deploy/análise de PR no CI. Escreve dado de custo, mas não tem acesso às rotas de leitura/gestão da conta.

Cada tipo é recusado onde o outro atua: uma key SDK não consulta dados, e uma key MCP não é aceita nas rotas de ingestão do SDK.

• Exibição única: o valor completo aparece uma vez, no momento da criação (com opção de copiar ou baixar). Depois disso a tela mostra só o prefixo mascarado — o CloudBroker guarda apenas o hash da key e não consegue mostrá-la de novo. Perdeu? Revogue e crie outra.
• Validade: escolhida na criação — 1, 2 ou 3 meses, ou sem vencimento. Key vencida deixa de autenticar.
• Revogação: o botão Revogar invalida a key imediatamente; qualquer integração usando ela para de funcionar.
• Limite: até 10 API Keys ativas por usuário.
• Remoção/rebaixamento de admin: revoga todas as keys da pessoa em cascata (ver acima).