Configurar Autenticacao no N8N

Conceituacao

Para que o N8N consiga fazer requisicoes a Ogmma API, voce precisa configurar sua API Key como credential reutilizavel. Isso garante que a chave fique armazenada de forma segura e possa ser usada em todos os seus workflows sem precisar copia-la manualmente.

---

Passo 1: Criar a Credential

1.1 Abrir o Painel de Credentials

No N8N, acesse o menu lateral e clique em Credentials (ou acesse via Settings → Credentials).

1.2 Adicionar Nova Credential

Clique em Add Credential e selecione o tipo Header Auth.

1.3 Preencher os Campos

Campo	Valor
Credential Name	Ogmma API
Name	Authorization
Value	Bearer oapi_sk_live_a1b2c3d4e5f6...

Substitua oapi_sk_live_a1b2c3d4e5f6... pela sua API Key real.

1.4 Salvar

Clique em Save. A credential estara disponivel para uso em qualquer HTTP Request node.

Importante

Nunca cole sua API Key diretamente nos nodes do workflow. Sempre use credentials do N8N para armazenar chaves de forma segura. Se voce compartilhar o workflow, a credential nao sera exportada.

---

Passo 2: Usar no HTTP Request Node

Ao adicionar um HTTP Request node ao seu workflow, configure a autenticacao assim:

Configuracao do Node

Campo	Valor
Method	POST (ou GET, conforme o endpoint)
URL	https://oapi.ogmma.com.br/v1/...
Authentication	Predefined Credential Type
Credential Type	Header Auth
Header Auth Credential	Ogmma API (selecionar a credential criada)

Headers Adicionais

Alem da autenticacao (adicionada automaticamente pela credential), adicione:

Header	Value
Content-Type	application/json

---

Passo 3: Testar a Autenticacao

Vamos verificar se tudo esta funcionando com um workflow simples que lista suas API Keys.

Configuracao do Workflow

[Manual Trigger] → [HTTP Request] → [Resultado]

HTTP Request Node

Campo	Valor
Method	GET
URL	https://oapi.ogmma.com.br/v1/api-keys
Authentication	Header Auth → Ogmma API

Executar

Clique em Test workflow. Se a autenticacao estiver correta, voce recebera um 200 OK com a lista de API Keys da sua instituicao:

{
  "data": [
    {
      "id": "64f8b2c3e1a2b3c4d5e6f7b0",
      "name": "Backend ERP",
      "prefix": "oapi_sk_live_a1b2",
      "permissions": ["messages.send", "messages.read"],
      "environment": "live",
      "createdAt": "2025-01-15T10:30:00.000Z"
    }
  ]
}

Erros Comuns

Status	Codigo	Causa	Solucao
401	UNAUTHORIZED	API Key invalida ou expirada	Verifique se a chave esta correta e nao foi revogada
401	AUTHENTICATION_REQUIRED	Header Authorization ausente	Verifique se a credential esta selecionada no node
403	FORBIDDEN_PERMISSION	API Key sem permissao	Crie uma nova API Key com as permissoes necessarias

---

Workflow Pronto

Baixe o workflow de teste pronto para importar:

Baixar test-authentication.json

Este workflow inclui:

• Manual Trigger para execucao sob demanda
• HTTP Request configurado para GET /api/api-keys
• Sticky Note com instrucoes de configuracao

Como importar

No editor do N8N: clique nos tres pontos (⋮) → Import from File → selecione o JSON baixado. Depois, configure a credential Ogmma API com sua API Key real.

---

Dicas de Seguranca

1. Use credentials, nunca hardcode -- a credential e armazenada de forma criptografada no N8N
2. API Keys separadas por ambiente -- crie uma key live para producao e uma test para sandbox
3. Permissoes minimas -- crie API Keys com apenas as permissoes necessarias para o workflow
4. Rotacao periodica -- revogue keys antigas e crie novas periodicamente
5. Variaveis de ambiente -- no N8N self-hosted, use variaveis de ambiente para URLs e IDs fixos

---

Proximo Passo

Com a autenticacao configurada, voce esta pronto para:

• Enviar Mensagens -- envie texto, imagem e templates
• Receber Webhooks -- receba eventos em tempo real