Administração

A seção de administração permite gerenciar usuários, papéis, permissões, configurações gerais, 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

Componentes

Provedores

Relatórios (Reports)

Dashboards

Webhooks

Usuários

Papéis

Defeitos — Enterprise

Configurações

Configurações Gerais — Super Admin

A aba Geral reúne configurações que afetam a instância como um todo. Ela fica disponível para Super Admins em Configurações → Geral.

As seções são organizadas em accordions para facilitar a navegação.

Segurança e MFA

A configuração global de MFA fica em Configurações → Geral → Segurança e MFA.

Use essa seção para exigir autenticação em dois fatores e reforçar o acesso de usuários administrativos.

Histórico de Versões — Enterprise

O histórico de versões permite manter snapshots de cenários e componentes.

Como funciona:

• cenários criam snapshot ao salvar uma alteração relevante no fluxo;
• componentes criam snapshot ao publicar uma nova versão;
• versões antigas podem ser abertas em modo de consulta;
• a restauração cria uma nova versão atual a partir do snapshot escolhido;
• ao reduzir o limite, versões excedentes são removidas automaticamente.

O padrão recomendado é manter versões suficientes para auditoria e reversão sem acumular histórico desnecessário.

Retenção de Dados de Execução

A retenção de dados remove artefatos antigos de execução, como evidências e anexos técnicos de execuções antigas. Ela não remove o registro da execução em si.

Campos principais:

A limpeza agendada roda uma vez por dia, após o horário fixo definido pela instância. Também é possível usar Pré-visualizar limpeza para estimar o impacto antes de executar.

Por segurança, a limpeza preserva execuções vinculadas a defeitos ou tickets e não remove anexos de defeitos, evidências de tickets, sessões, templates de relatório ou sessões de navegador salvas.

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

Tokens de Integração

Os Tokens de Integração permitem autenticar pipelines e automações sem depender de sessão de navegador.

Para acessar:

1. Vá em Configurações → Access Tokens
2. Gere um token
3. Salve o valor como secret do pipeline
4. Use com QANODE_URL e QANODE_TOKEN

Usuários com settings.integration_token_all também podem:

• ver tokens de toda a instância
• revogar tokens de outras pessoas
• definir a política global de expiração

Para o guia completo, veja Integração CI/CD — Visão Geral.

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

Execução de testes

Defeitos

Escopo (Filtros)

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

• Projeto — Apenas eventos de um projeto específico
• Suíte — Apenas execuções de uma suíte específica (somente eventos de execução de testes)
• Cenário — Apenas eventos de um cenário/fluxo 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.

Observação: O escopo de suíte não se aplica a eventos de defeito. Um webhook com escopo em uma suíte específica só dispara para eventos de execução de testes (run.*, suite.*), nunca para eventos de defeito.

Payload do Webhook

Cada entrega é um POST HTTP com o seguinte corpo JSON:

{
  "event": "<nome-do-evento>",
  "timestamp": "2026-04-15T10:30:00.000Z",
  "data": { ... }
}

Payload de execução de testes

{
  "event": "run.completed",
  "timestamp": "2026-04-15T10:30:00.000Z",
  "data": {
    "runId": "uuid",
    "flowId": "uuid",
    "flowName": "Login Flow",
    "suiteId": "uuid",
    "suiteName": "Smoke Suite",
    "projectId": "uuid",
    "projectName": "App Mobile",
    "status": "success",
    "durationMs": 1234,
    "executor": "Nome do Usuário",
    "errorSummary": null
  }
}

Payload de defeitos (defect.opened, defect.status_changed, defect.closed)

{
  "event": "defect.status_changed",
  "timestamp": "2026-04-15T15:10:00.000Z",
  "data": {
    "defectId": "uuid",
    "defectNumber": 42,
    "title": "Botão de login não responde no Safari",
    "description": "Ao clicar em Login no Safari 17...",
    "status": "in_progress",
    "previousStatus": "open",
    "severity": "high",
    "priority": "urgent",
    "resolution": null,
    "isFinal": false,
    "closedAt": null,
    "createdAt": "2026-04-15T14:32:00.000Z",
    "updatedAt": "2026-04-15T15:10:00.000Z",
    "project": { "id": "uuid", "name": "App Mobile" },
    "flow": { "id": "uuid", "name": "Login Flow" },
    "run": { "id": "uuid", "status": "failed" },
    "reporterUser": { "id": "uuid", "name": "Maria", "email": "maria@empresa.com" },
    "assigneeUser": { "id": "uuid", "name": "João Silva", "email": "joao@empresa.com" },
    "assigneeRole": null,
    "customFields": { "ambiente": "producao", "navegador": "Safari 17" },
    "actionComment": {
      "content": "Iniciando investigação no ambiente de staging",
      "user": { "id": "uuid", "name": "João Silva", "email": "joao@empresa.com" }
    }
  }
}

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 → Geral → Segurança e 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
• Revise Configurações → Geral para MFA, histórico de versões e retenção de dados
• 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