Equipe e papéis¶
Para: Adm — Conferido em 2026-10-19.
Quem usa o painel recebe um ou mais pacotes de papéis, por operação. Esta página lista os quatro pacotes e o que cada um pode fazer, mostra como convidar (por e-mail, com aceite), conceder e remover pessoas, e explica as regras de aprovação que impedem que uma pessoa sozinha faça uma mudança sensível.
O que é¶
Existem quatro pacotes. Os nomes são os da tela "Usuários e papéis".
| Pacote | Para quem | Em uma frase |
|---|---|---|
| Administrador do tenant | quem comanda a conta da empresa | gere equipe, chaves, IPs e webhooks, cria operações e vê quase tudo |
| Financeiro | quem opera o dinheiro | revisa saques e depósitos, aprova regras e listas, reconcilia e vê o caixa |
| Revisor | quem decide filas de revisão | decide depósitos e saques em revisão e pede informação ao operador |
| Auditor | quem confere | lê tudo, vê a trilha e exporta, mas não decide nada |
O pacote Administrador do tenant vale para o tenant inteiro: quem o recebe passa a ser dono do tenant e cria operações. Os outros três valem para a operação em que foram concedidos. Em todos os casos o papel só passa a valer depois que a pessoa aceita o convite. Uma pessoa pode ter mais de um pacote: quem administra pode também ser Financeiro ou Revisor.
O que cada pacote pode fazer¶
| Capacidade | Administrador do tenant | Financeiro | Revisor | Auditor |
|---|---|---|---|---|
| Ver a operação, transações e alertas | sim | sim | sim | sim |
| Ver a trilha de auditoria | sim | sim | sim | sim |
| Gerir usuários e papéis | sim | não | não | não |
| Gerir chaves de API e IPs | sim | não | não | não |
| Ver webhooks | sim | sim | não | sim |
| Gerir webhooks (URL, eventos, segredo) | sim | não | não | não |
| Criar operações no tenant | sim | não | não | não |
| Cobrança de teste | sim | sim | não | não |
| Decidir depósitos e saques em revisão | não | sim | sim | não |
| Pedir informação ao operador | não | sim | sim | não |
| Revelar dado pessoal, com motivo | não | sim | sim | sim |
| Ver regras | sim | sim | não | sim |
| Propor mudança de regra | sim | sim | não | não |
| Aprovar regras, gerir listas e VIP | não | sim | não | não |
| Suspender o saque automático (emergência) | sim | sim | não | não |
| Ver a reconciliação | sim | sim | não | sim |
| Agir na reconciliação e definir o limiar de caixa | não | sim | não | não |
| Exportar relatórios sem dados pessoais | sim | sim | não | sim |
| Exportar relatórios com dados pessoais (com aprovação) | não | sim | não | sim |
| Configurar alertas | sim | sim | não | não |
Quem não tem a capacidade não vê a tela: o painel responde "não encontrado" em vez de "proibido".
Papéis do lado Dracma¶
Duas funções existem só do lado do Dracma. Você não as concede nem as vê na lista de usuários:
- Operações do Dracma: cria tenants, cadastra e ativa gateways e aprova pedidos de operação Real.
- Suporte do Dracma: leitura dos gateways. Não aprova nada.
Contas com função do Dracma não podem aceitar o convite de dono de um tenant de cliente.
Quando usar¶
Logo depois de aceitar o convite do dono: monte a equipe antes de pedir qualquer chave extra ou a operação Real. Volte aqui sempre que alguém entrar, mudar de função ou sair da empresa.
Como funciona¶
Abra Usuários e papéis e escolha a operação. Você precisa ser Administrador do tenant, e todas as ações pedem confirmação recente com fator forte (veja Conta, login e dispositivos).
Convidar por e-mail¶
- Informe o e-mail da pessoa, o pacote e um motivo de 10 a 1000 caracteres. O pedido segue as regras de aprovação abaixo.
- Quando o pedido vale, o Dracma envia à pessoa um e-mail com um link de uso único, válido por 72 horas. O convite não cria conta e não concede nada: o pacote ainda não vale.
- A pessoa abre o link, entra ou cria a conta com o mesmo e-mail do convite e aceita com dois fatores e um fator forte recente. Veja Aceitar o convite.
- Só ao aceitar o pacote passa a valer, na operação escolhida no convite e em nenhuma outra. Para dar acesso a mais de uma operação, convide uma vez por operação.
- Quem já tem conta mantém a mesma conta. Se a conta usa outro e-mail, adicione o do convite em Adicionar um segundo e-mail e aceite.
O link nunca aparece no painel, nem para quem convidou: ele só vai por e-mail à pessoa convidada. No hml o e-mail chega de verdade a qualquer endereço fora dos domínios de teste. Use endereços reais de pessoas reais.
Para um mesmo e-mail e pacote só pode existir um convite pendente por operação.
Acompanhar, reenviar e revogar convites¶
Na tela Usuários e papéis, a seção Aguardando aceite lista os convites da operação com o e-mail parcialmente oculto, o pacote, quem convidou, o prazo, o número de reenvios e a situação (pendente, aceito, revogado ou expirado). Só convite pendente tem ações:
- Reenviar convite: gera um link novo e invalida o anterior. O prazo volta a 72 horas. Até 5 reenvios, com pelo menos 60 segundos entre eles.
- Revogar convite: informe um motivo de 10 a 1000 caracteres. O link deixa de funcionar.
Reenviar e revogar pedem confirmação recente com fator forte, mas não precisam de aprovação de outra pessoa: nenhum acesso é concedido por eles. Convite que passa de 72 horas fica expirado; reenvie ou convide de novo.
Se o convite não chegou, peça à pessoa que confira o spam e o e-mail digitado, e reenvie. Se a pessoa que convidou perdeu o direito de gerir usuários da operação antes do aceite, o aceite é recusado: peça a um administrador atual que convide de novo.
Conceder um pacote a quem já tem acesso¶
- Pegue o ID interno (UUID) da pessoa na tabela "Quem tem acesso". A tabela mostra o ID, o e-mail mascarado (
an***@dominio.example) e os pacotes. - Informe o ID, o pacote e o motivo. A concessão é feita pelo ID, nunca pelo e-mail.
Remover um pacote¶
Na linha da pessoa, preencha o motivo e escolha Remover pacote. A remoção vale por pacote: se a pessoa tem dois, remova cada um.
Regras de aprovação¶
Toda ação vira um pedido. No caso do convite, a aprovação vale para enviar o convite; o acesso só nasce no aceite. Quantas aprovações de outra pessoa ele precisa depende do pacote e de quantos administradores o tenant tem:
| Ação | Um único administrador | Dois ou mais administradores |
|---|---|---|
| Convidar ou conceder Administrador ou Auditor | vale na hora, sem segundo voto | 1 aprovação de outro administrador |
| Convidar ou conceder Financeiro ou Revisor (pacotes que aprovam dinheiro) | 1 aprovação de outro administrador, então só fecha com o segundo administrador | 1 aprovação de outro administrador |
| Remover qualquer pacote | vale na hora | 1 aprovação de outro administrador |
Pontos de atenção:
- Quem pede nunca vota no próprio pedido. O voto de aprovação precisa ser de outro administrador, com fator forte recente.
- Um voto de aprovação basta. Uma recusa fecha o pedido.
- Quem administra o tenant pode também ser Financeiro ou Revisor. Não há separação obrigatória de funções. Com duas pessoas, os dois papéis cabem nas duas.
- Nunca se remove o último administrador: o pedido volta
last_admin. - Pedidos de usuários não têm espera de 24 h: ao receber a aprovação, o pedido é executado.
- Os pedidos aparecem em "Pedidos pendentes desta área" e, depois de decididos, em "Histórico recente". Um pedido pendente pode ser cancelado.
Sequência mínima para uma equipe de duas pessoas:
- A primeira pessoa (dona do tenant) convida a segunda como Administrador: o convite sai na hora, sem segundo voto.
- A segunda pessoa aceita o convite com dois fatores. Enquanto não aceitar, ela não conta como segunda pessoa da equipe.
- Depois do aceite, cada uma pode convidar a outra para os pacotes Financeiro e Revisor, com a aprovação da outra.
Exemplos¶
Equipe de quatro pessoas de uma operadora:
| Pessoa | Pacotes | Por quê |
|---|---|---|
| Ana | Administrador do tenant, Financeiro | dona do tenant e quem aprova regras |
| Bruno | Administrador do tenant, Revisor | segundo administrador e quem decide as filas |
| Carla | Revisor | turno da noite |
| Davi | Auditor | compliance, leitura e exportação |
Para dar o pacote Revisor à Carla: Ana pede o convite (informando o e-mail), Bruno aprova, o Dracma envia o e-mail e a Carla aceita o convite, criando a conta se precisar. O acesso dela começa no aceite.
O "administrador do seu tenant" que o painel cita ao ver a tela sem acesso é a pessoa dona do tenant. Ela é a primeira da lista: entrou por convite do Dracma. Quem criou o tenant no Dracma também consta como dono até sair, o que só é possível depois que outro dono aceita.
Erros e casos de borda¶
| Mensagem ou código | Causa | O que fazer |
|---|---|---|
"Não é possível remover o último administrador do tenant." (last_admin) |
o pedido deixaria o tenant sem administrador | conceda o pacote a outra pessoa antes |
"Quem pediu não pode revisar o próprio item." (self_review_forbidden) |
você votou no pedido que criou | peça a outro administrador |
"Você já votou neste item." (already_voted) |
voto duplicado | nada a fazer |
"Este item já foi decidido." (invalid_state_transition) |
outra pessoa decidiu antes | recarregue |
"Confirme com o fator forte para concluir." (step_up_required) |
falta a confirmação recente | use Confirmar identidade agora |
"Confira os campos do formulário." (validation_failed) |
e-mail inválido, ID que não é UUID, pacote fora da lista ou motivo curto | corrija |
"Já existe um convite pendente para este e-mail e pacote." (invitation_exists) |
convite repetido | reenvie o existente ou revogue-o antes |
"Este convite não está mais pendente." (invitation_not_pending) |
já aceito, revogado ou expirado | convide de novo, se preciso |
"Limite de reenvios atingido ou reenvio muito recente." (resend_limited) |
5 reenvios ou menos de 60 s desde o último | aguarde um minuto; depois de 5, revogue e convide de novo |
"O serviço de identidade está indisponível agora." (idp_unavailable) |
o login do Dracma está fora | nada foi alterado; tente de novo |
"Este e-mail não pode receber convite neste ambiente." (email_not_deliverable) |
fora da produção, endereço de teste ou não liberado | use um endereço real e permitido |
Aceite recusado: issuer_revoked, self_accept_forbidden, platform_account_not_allowed, email_mismatch |
quem convidou perdeu o direito; você tentou aceitar o próprio convite; conta com função do Dracma; e-mail da conta diferente | convide de novo por um administrador atual; use outra conta; adicione o e-mail ao perfil |
| Link "expirado", "já usado" ou "revogado" | passou de 72 h, outra conta usou, ou foi revogado | peça reenvio |
| Pessoa já tem o pacote / não tem o pacote | concessão repetida ou remoção de algo que não existe | confira a tabela |
Tela sem acesso: quem ainda não tem pacote em nenhuma operação vê "Você ainda não tem acesso a nenhuma operação. Peça ao administrador do seu tenant."