Administração

A seção de administração permite gerenciar usuários, papéis, permissões, configurações de SMTP, alarmes, webhooks, auditoria e licenciamento.

Acesse através do ícone de engrenagem (⚙️) no menu lateral → Configurações.

Usuários

Convidando Usuários

1. Vá em Configurações → Usuários
2. Clique em Convidar Usuário
3. Preencha:
   • E-mail: E-mail do novo usuário
   • Papel: Papel atribuído (define permissões)
4. Um e-mail de convite será enviado com link de ativação

Requisito: SMTP deve estar configurado para envio de convites.

Importação em Lote

Para cadastrar vários usuários de uma vez:

1. Vá em Configurações → Usuários
2. Clique no ícone de importação (ao lado do botão de convidar)
3. Baixe o template Excel clicando em Download Template
4. Preencha a planilha com os dados dos usuários:

5. Faça upload do arquivo Excel (.xlsx ou .xls) arrastando para a área indicada ou clicando para selecionar
6. O sistema processará cada linha e enviará convites por e-mail

Após o processamento, um resumo é exibido com:

• Quantidade de usuários importados com sucesso
• Lista de falhas com o número da linha, e-mail e motivo do erro (ex: e-mail já existe, papel não encontrado, campos obrigatórios faltando)

Nota: A importação respeita o limite de usuários da licença. Se o arquivo contiver mais usuários do que o plano permite, o sistema informará e oferecerá a opção de importar apenas até o limite disponível.

Gerenciando Usuários

Na lista de usuários você pode:

Status de Usuários

Papéis e Permissões

Papéis do Sistema

O QANode inclui papéis pré-definidos que não podem ser removidos:

Papéis Customizados

Crie papéis com permissões específicas:

1. Vá em Configurações → Papéis e Permissões
2. Clique em + Novo Papel
3. Defina o nome, a visão de tabelas e selecione as permissões

Visão de Tabelas (Table View)

Ao criar ou editar um papel, o campo Visão de Tabelas define quais tabelas do banco de dados ficam acessíveis no query builder dos dashboards personalizados. Isso controla o que o usuário pode consultar ao criar widgets com queries SQL ou ao explorar dados nos dashboards.

Nota: Colunas sensíveis (senhas, tokens, dados criptografados) são automaticamente ocultadas, independentemente do perfil de visão.

Perfis padrão dos papéis do sistema

Lista Completa de Permissões

Cenários (Flows)

Projetos

Suítes

Execuções (Runs)

Variáveis

Credenciais

Provedores

Relatórios (Reports)

Dashboards

Webhooks

Usuários

Papéis

Configurações

Configuração SMTP

Para envio de e-mails (convites, relatórios, alarmes):

1. Vá em Configurações → SMTP
2. Preencha:

3. Clique em Salvar — o sistema testa a conexão automaticamente

Alarmes

Configure notificações automáticas para falhas em suítes:

1. Vá em Configurações → Alarmes
2. Configure:
   • Suítes monitoradas — Quais suítes disparam alarme
   • Destinatários — Quem recebe a notificação
   • Condição — Quando notificar (falha, sempre, etc.)

Requisito: SMTP deve estar configurado para envio de alarmes por e-mail.

Webhooks

Webhooks permitem enviar notificações HTTP POST automaticamente para serviços externos quando eventos de execução ocorrem. Cada usuário gerencia seus próprios webhooks de forma independente.

Configurando Webhooks

1. Vá em Configurações → Webhooks
2. Clique em + Novo Webhook
3. Preencha:

Eventos Disponíveis

Escopo (Filtros)

Você pode filtrar os webhooks para disparar apenas em contextos específicos:

• Projeto — Apenas execuções de um projeto específico
• Suíte — Apenas execuções de uma suíte específica
• Cenário — Apenas execuções de um cenário específico

Ao selecionar um projeto, as suítes e cenários são filtrados para mostrar apenas os daquele projeto. Ao selecionar uma suíte, o filtro de cenário é ocultado.

Payload do Webhook

O corpo do POST enviado contém:

{
  "event": "run.completed",
  "timestamp": "2026-02-13T10:30:00.000Z",
  "data": {
    "runId": "uuid",
    "flowId": "uuid",
    "flowName": "Nome do Cenário",
    "suiteId": "uuid",
    "suiteName": "Nome da Suíte",
    "projectId": "uuid",
    "projectName": "Nome do Projeto",
    "status": "success",
    "durationMs": 1234,
    "executor": "Nome do Usuário",
    "errorSummary": null
  }
}

Assinatura HMAC

Se o campo Secret for preenchido, o QANode adiciona o header X-QANode-Signature com a assinatura HMAC-SHA256 do payload. Isso permite que o serviço receptor valide a autenticidade da requisição.

Exemplo de header:

X-QANode-Signature: sha256=abc123...

Retentativas

Em caso de falha na entrega (erro de rede ou código HTTP diferente de 2xx), o QANode tenta reenviar automaticamente até 3 vezes com intervalos crescentes:

Log de Entregas

Para cada webhook, é possível visualizar o histórico das últimas 50 entregas:

1. Clique no ícone de lista ao lado do webhook
2. Veja o status de cada entrega (OK/Falhou), código HTTP, tentativas e erros

Testando Webhooks

Clique no ícone de play ao lado do webhook para enviar um payload de teste. Isso permite verificar se a URL está acessível e respondendo corretamente.

Permissões

Os seguintes papéis possuem acesso a webhooks:

Cada usuário visualiza e gerencia apenas seus próprios webhooks.

Auditoria

O log de auditoria registra todas as ações importantes no sistema:

Ações Rastreadas

Entidades Rastreadas

Projetos, Fluxos, Suítes, Execuções, Variáveis, Credenciais, Provedores, Usuários, Papéis, Configurações, Sistema.

Informações do Log

Visualizando

1. Vá em Configurações → Auditoria
2. Navegue pelo histórico usando paginação
3. Use filtros para buscar ações específicas

Alteração de Senha

Qualquer usuário pode alterar sua própria senha:

1. Vá em Configurações → Alterar Senha
2. Informe a senha atual
3. Informe e confirme a nova senha
4. Clique em Salvar

MFA (Autenticação em Dois Fatores)

Para maior segurança, ative a autenticação em dois fatores:

1. Vá em Configurações → MFA
2. Escaneie o QR Code com um app autenticador (Google Authenticator, Authy, etc.)
3. Informe o código gerado para confirmar
4. O MFA estará ativo — códigos serão solicitados em cada login

Licença

Gerencie a licença do QANode:

1. Vá em Configurações → Licença
2. Visualize:
   • Status da licença (válida/expirada)
   • Data de expiração
   • Dias restantes
   • Limite de usuários
   • Usuários ativos vs limite

Dicas

• Configure o SMTP primeiro — muitas funcionalidades dependem de e-mail
• Use papéis customizados para controle fino de acesso
• Monitore a auditoria regularmente para detectar ações inesperadas
• Ative MFA para contas de administrador
• Desative usuários em vez de excluir — preserva o histórico de auditoria
• Use webhooks para integrar o QANode com Slack, Teams, Discord ou qualquer serviço que aceite HTTP POST
• Defina o secret nos webhooks para garantir autenticidade das requisições