AUTH - Autenticação e Gerenciamento de Sessão

O que é este Node?

O AUTH é o node responsável por gerenciar autenticação de usuários e sessões no Lumina Flow Builder. Ele permite realizar login, logout, verificação de tokens, renovação de tokens e verificação de permissões.

Por que este Node existe?

Sistemas modernos precisam de mecanismos robustos de autenticação e controle de acesso. O AUTH existe para:

Autenticação Segura: Validar credenciais de usuários e criar sessões autenticadas
Gerenciamento de Sessão: Controlar sessões ativas e realizar logout quando necessário
Validação de Tokens: Verificar autenticidade e validade de tokens JWT
Renovação de Tokens: Estender sessões através da renovação de tokens expirados
Controle de Permissões: Verificar se usuários possuem permissões necessárias para realizar ações

Como funciona internamente?

Quando o AUTH é executado, o sistema:

Recebe a operação: Identifica qual operação de autenticação será executada (login, logout, verify_token, refresh_token, check_permissions)
Valida parâmetros: Verifica se todos os parâmetros necessários foram fornecidos
Executa a operação:
Login: Valida credenciais, gera sessionId e token JWT
Logout: Invalida a sessão do usuário
Verify Token: Verifica se o token é válido e não expirou
Refresh Token: Gera novo token a partir de um token existente
Check Permissions: Verifica se o usuário possui as permissões solicitadas
Se válido: Retorna sucesso com os dados da operação
Se inválido/erro: Retorna erro com mensagem descritiva

Código interno (security-executor.service.ts:53-77):

private async executeAuth(parameters: any, context: any): Promise<any> {
  const { operation, username, password, token, sessionId, permissions } = parameters;

  this.logger.log(`🔐 AUTH - Operation: ${operation}`);

  switch (operation) {
    case 'login':
      return this.authenticateUser(username, password, context);

    case 'logout':
      return this.logoutUser(sessionId, context);

    case 'verify_token':
      return this.verifyToken(token, context);

    case 'refresh_token':
      return this.refreshToken(token, context);

    case 'check_permissions':
      return this.checkPermissions(username, permissions, context);

    default:
      throw new Error(`Unsupported auth operation: ${operation}`);
  }
}

Quando você DEVE usar este Node?

Use AUTH sempre que precisar de autenticação, gerenciamento de sessão ou controle de acesso:

Casos de uso

Sistema de Login: "Preciso autenticar usuários antes de permitir acesso ao sistema"
API Segura: "Preciso validar tokens JWT antes de processar requisições"
Controle de Acesso: "Preciso verificar se o usuário tem permissão para executar determinada ação"
Renovação de Sessão: "Preciso renovar tokens expirados sem fazer login novamente"
Logout Seguro: "Preciso invalidar sessões quando usuário faz logout"

Quando NÃO usar AUTH

Criptografia de Dados: Use ENCRYPT ao invés de AUTH
Autenticação de Dois Fatores: Use 2FA ao invés de AUTH
OAuth Social Login: Use OAUTH ao invés de AUTH

Parâmetros Detalhados

operation (string, obrigatório)

O que é: Define qual operação de autenticação será executada.

Valores possíveis: - login: Autentica usuário com username e password - logout: Encerra sessão do usuário - verify_token: Verifica validade de um token JWT - refresh_token: Renova um token JWT - check_permissions: Verifica permissões do usuário

Flow completo para testar (Login):

{
  "name": "Teste AUTH - Login",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "auth_1",
      "type": "auth",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Login Usuário",
        "parameters": {
          "operation": "login",
          "username": "jose.roberto",
          "password": "senha123"
        }
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Confirmar Login",
        "parameters": {
          "message": "Login realizado! Token: {{auth_1.token}}, Sessão: {{auth_1.sessionId}}"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 700, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "auth_1" },
    { "source": "auth_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Teste: Importe o flow e execute. O sistema deve retornar um token JWT e um sessionId válidos.

O que é: Nome de usuário para autenticação.