OAuth por Usuário em Servidores MCP: Keycloak, n8n e um Bot Telegram através de um Auth Proxy

OAuth por Usuário em Servidores MCP: Keycloak, n8n e um Bot Telegram através de um Auth Proxy

Este artigo detalha a implementação de OAuth por usuário em servidores MCP, utilizando Keycloak, n8n e um bot Telegram. O autor compartilha as dificuldades encontradas e as soluções arquiteturais adotadas, incluindo o uso de um Auth Proxy para gerenciar a autenticação e autorização.

MundiX News·12 de maio de 2026·10 min de leitura·👁 6 views

OAuth por Usuário em Servidores MCP: Keycloak, n8n e um Bot Telegram através de um Auth Proxy

Este artigo explora a implementação de OAuth por usuário em servidores MCP (Model Context Protocol), integrando Keycloak, n8n e um bot Telegram. O autor compartilha as dificuldades encontradas e as soluções arquiteturais adotadas, oferecendo um guia prático para quem busca integrar OAuth/OIDC em sistemas não projetados para isso, construir agentes de IA multi-tenant ou integrar servidores MCP com um IdP corporativo.

A arquitetura inicial consistia em servidores MCP, um agente de IA e usuários no Telegram. A necessidade de autenticação por usuário, com o agente operando em nome do usuário, levou à adoção de um Auth Proxy. A decisão de usar um serviço separado foi motivada pela necessidade de manter a lógica de autenticação separada da roteamento e pela flexibilidade em caso de mudanças no IdP. O FastMCP, um proxy global, foi utilizado para agregar todos os servidores em um único ponto de entrada.

O Auth Proxy, posicionado antes do Gateway, utiliza o OAuthProxy para se apresentar aos clientes MCP como um servidor OAuth completo, utilizando credenciais pré-registradas com o Keycloak. A autenticação do usuário é feita através do Keycloak, garantindo que as senhas nunca sejam expostas ao Auth Proxy. O artigo detalha as dificuldades encontradas, como erros de escopo e diferenças nos dialetos OAuth entre os clientes, e as soluções implementadas, incluindo um middleware para lidar com as diferenças de implementação. A implementação de um middleware para lidar com as diferenças de implementação, como a falta de suporte a PKCE por alguns clientes, demonstrou ser uma solução flexível e adaptável.

A implementação de autenticação por usuário apresentou desafios adicionais, especialmente com o n8n, onde a autenticação padrão é feita uma vez por workflow. A solução foi a criação de uma API de Autenticação de Usuário (User Auth API), que permite que o bot Telegram inicie sessões, obtenha URLs de login, troque códigos por tokens e gerencie o acesso aos recursos. O Auth Proxy armazena os tokens, e o bot trabalha com session_id, garantindo a segurança e o controle de acesso.

Em resumo, o Auth Proxy atende a três tipos de clientes: Claude Desktop, n8n e o bot Telegram. O Claude Desktop se conecta diretamente, o n8n usa OAuth2 padrão e o bot Telegram utiliza a User Auth API para autenticação por usuário. A criação de uma node customizada para o n8n, utilizando a propriedade usableAsTool, permitiu a integração com agentes de IA. No entanto, a limitação de apenas uma tool por node levou à migração para LangGraph, que oferece mais controle e flexibilidade para cenários complexos, como a gestão de múltiplos instrumentos MCP.

O artigo conclui com uma análise dos resultados, destacando a facilidade de acesso aos servidores MCP, a rapidez do processo de autenticação e a melhoria na precisão dos agentes de IA. As limitações incluem o armazenamento de sessões na memória, a ausência de rate limiting e o uso de PKCE, que é um compromisso de segurança. O autor enfatiza a utilidade do middleware para lidar com as diferenças de implementação e a importância da escolha da plataforma, destacando que o LangGraph oferece mais controle para cenários complexos de autenticação por usuário.

Recursos:

🛡️⚡

Pare de pesquisar. Comece a hackear.

O MundiX é seu copiloto de pentest com IA: comandos exatos, análise de outputs e próximo passo na kill chain — em segundos.

Testar grátis por 7 dias →

Sem cartão para começar · Planos a partir de R$49/mês

📤 Compartilhar & Baixar

🧰 Ferramentas recomendadas

Divulgação: alguns links são patrocinados. Podemos receber comissão se você comprar — sem custo extra para você. Só indicamos o que faz sentido para a comunidade.

Aprendendo Kali Linux: Teste de segurança, pentest e hacking ético

Aprendendo Kali Linux: Teste de segurança, pentest e hacking ético

Com centenas de ferramentas pré-instaladas, a distribuição Kali Linux facilita o trabalho de os profissionais de segurança começarem a fazer testes de segurança rapidamente. No entanto, com mais de 600 ferramentas em seu arsenal, o Kali Linux também pode ser desafiador. A nova edição deste prático livro abrange as atualizações nas ferramentas e inclui uma melhor abordagem da análise forense e da engenharia reversa. Ric Messier, autor, não fica apenas no teste de segurança, mas também faz uma abordagem sobre a execução de análise forense, incluindo a análise em disco e na memória, assim como alguma análise básica de malware. • Explore as diversas ferramentas disponíveis no Kali Linux • Entenda o valor do teste de segurança e examine os tipos de teste disponíveis • Aprenda os aspectos básicos do pentest em todo o ciclo de vida do ataque • Instale o Kali Linux em vários sistemas, tanto físicos quanto virtuais • Descubra como usar diferentes ferramentas destinadas à segurança • Estruture um teste de segurança baseado nas ferramentas do Kali Linux • Estenda as ferramentas do Kali para criar técnicas de ataque avançadas • Use o Kali Linux para ajudar a criar relatórios quando o teste terminar “A abordagem concisa, clara e baseada na experiência adotada por Ric Messier para a introdução do Kali Linux e dos testes de cibersegurança é incomparável. Este livro é uma leitura excelente e acessível para iniciantes e um recurso valioso para qualquer pessoa.” —Alexander Arlt, Consultor sênior de segurança, Google

Ver na Amazon
Gshield 2 em 1 Hub Extensor Conector USB-C + USB-A e Adaptador de Rede Ethernet LAN RJ45 com 3 Entradas USB 3.0 até 5 Gbps em Liga de Alumínio para Computador e Notebook, Cinza

Gshield 2 em 1 Hub Extensor Conector USB-C + USB-A e Adaptador de Rede Ethernet LAN RJ45 com 3 Entradas USB 3.0 até 5 Gbps em Liga de Alumínio para Computador e Notebook, Cinza

Compatível com portas USB-C e USB-A, ideal para ampliar a conectividade de dispositivos como MacBook Pro e outros com portas USB-C. Inclui um adaptador USB-A extra, proporcionando uma conexão Ethernet estável e veloz de até 1 Gbps, perfeita para filmes, jogos online e videoconferências. Oferece três portas USB 3.0 com velocidades de transferência de até 5 Gbps, permitindo conectar mouse, teclado, discos rígidos e outros periféricos. Fabricado em alumínio durável, garantindo longa vida útil e resistência ao uso diário. Design compacto e leve, ideal para viagens de negócios e uso diário, facilitando o transporte e armazenamento. Funciona com Windows 10/8.1/8, Mac OS e Chrome OS, oferecendo versatilidade incomparável para diversas necessidades de conectividade. Assegura uma conectividade estável e rápida, perfeita para tarefas exigentes como transferência de dados, streaming e mais.

Ver na Amazon
Hacking APIs: Breaking Web Application Programming Interfaces

Hacking APIs: Breaking Web Application Programming Interfaces

Hacking APIs is a crash course on web API security testing that will prepare you to penetration-test APIs, reap high rewards on bug bounty programs, and make your own APIs more secure. You'll learn how REST and GraphQL APIs work in the wild and set up a streamlined API testing lab with Burp Suite and Postman. Then you'll master tools useful for reconnaissance, endpoint analysis, and fuzzing, such as Kiterunner and OWASP Amass. Next, you'll learn to perform common attacks, like those targeting an API's authentication mechanisms and the injection vulnerabilities commonly found in web applications. You'll also learn techniques for bypassing protections against these attacks. In the book's nine guided labs, which target intentionally vulnerable APIs, you'll practice: Enumerating APIs users and endpoints using fuzzing techniques Using Postman to discover an excessive data exposure vulnerability Performing a JSON Web Token attack against an API authentication process Combining multiple API attack techniques to perform a NoSQL injection Attacking a GraphQL API to uncover a broken object level authorization vulnerability

Ver oferta
Gray Hat Hacking: The Ethical Hacker's Handbook, Sixth Edition

Gray Hat Hacking: The Ethical Hacker's Handbook, Sixth Edition

Up-to-date strategies for thwarting the latest, most insidious network attacks This fully updated, industry-standard security resource shows, step by step, how to fortify computer networks by learning and applying effective ethical hacking techniques. Based on curricula developed by the authors at major security conferences and colleges, the book features actionable planning and analysis methods as well as practical steps for identifying and combating both targeted and opportunistic attacks. Gray Hat Hacking: The Ethical Hacker's Handbook, Sixth Edition clearly explains the enemy's devious weapons, skills, and tactics and offers field-tested remedies, case studies, and testing labs. You will get complete coverage of Internet of Things, mobile, and Cloud security along with penetration testing, malware analysis, and reverse engineering techniques. State-of-the-art malware, ransomware, and system exploits are thoroughly explained. Fully revised content includes 7 new chapters covering the latest threats Includes proof-of-concept code stored on the GitHub repository Authors train attendees at major security conferences, including RSA, Black Hat, Defcon, and B-Sides

Ver na Amazon
Bloqueador USB de privacidade de porta USB para PC, notebook, bloco de laptop,

Bloqueador USB de privacidade de porta USB para PC, notebook, bloco de laptop,

Proteção de privacidade aprimorada: protege o link de transmissão de dados para evitar roubo de informações, fornecendo proteção de segurança robusta que protege a privacidade do usuário durante transferências de arquivos e garante uma conexão segura para interações de dispositivos sem preocupações em vários ambientes Uso a longo prazo: a camada protetora resistente ao desgaste, combinada com um corpo de metal resistente, oferece gerenciamento de calor confiável e qualidade duradoura durante o uso diário Entrega eficiente de energia: a tecnologia de chip inteligente garante a identificação automática dos requisitos de energia, fornecendo carregamento eficiente alinhando-se com vários protocolos de carregamento rápido para maior conveniência Proteção contra sobrecarga: evitando riscos de sobrecarga, este bloqueador de dados USB protege a vida útil da bateria e garante um desempenho estável, mantendo um fluxo estável de energia para melhorar a longevidade do dispositivo de forma eficaz Prático de transportar: com atenção à portabilidade, este bloqueador de dados USB oferece um design compacto que é leve e fácil de transportar, melhorando a conveniência do usuário e operação eficiente

Ver na Amazon

📩 Newsletter MundiX

Receba novidades de cibersegurança + um checklist de pentest grátis. Sem spam.

Ao assinar você concorda em receber e-mails. Cancele quando quiser.