Login com Telegram via OIDC: Desvendando o Fluxo do oauth.telegram.org com Python

Login com Telegram via OIDC: Desvendando o Fluxo do oauth.telegram.org com Python

Explore o novo fluxo de login do Telegram utilizando OpenID Connect (OIDC) e aprenda a implementá-lo em Python. Este artigo detalha o processo, desde a configuração do bot até a validação de tokens JWT, oferecendo um guia prático para desenvolvedores.

MundiX News·13 de maio de 2026·9 min de leitura·👁 11 views

O login via Telegram passou por uma transformação significativa, migrando de um sistema baseado em HMAC para um fluxo OpenID Connect (OIDC) robusto, utilizando oauth.telegram.org. Se você se deparou com tutoriais antigos que mencionam HMAC, /setdomain no BotFather e campos de usuário brutos no callback, é hora de esquecê-los. A abordagem moderna é mais padronizada e segura, alinhando o Telegram com outros provedores de identidade OIDC.

O novo fluxo OIDC oferece diversas vantagens. O Telegram agora atua como um provedor OpenID completo, com endpoints para configuração (/.well-known/openid-configuration) e chaves de assinatura pública (JWKS). O ID Token emitido é um JWT autêntico, cuja assinatura pode ser verificada usando as chaves públicas do Telegram. Isso elimina a necessidade de verificações manuais de HMAC e permite a integração com qualquer biblioteca OIDC padrão. A principal contrapartida é a exigência de HTTPS no domínio de origem e uma nova configuração no BotFather. O processo de login agora pode ocorrer de duas formas: através de uma biblioteca JavaScript (telegram-login.js) que gerencia um popup de autorização com PKCE, retornando um ID Token já validado para o backend, ou através de um fluxo de código de autorização manual, onde o backend lida diretamente com a troca de código por tokens. Este artigo foca no primeiro método, mais simples e adequado para a maioria das aplicações web.

Para implementar o login via Telegram OIDC em Python, o processo envolve algumas etapas cruciais. Primeiro, configure seu bot no BotFather, adicionando o domínio do seu aplicativo em Trusted Origins na seção Web Login. É essencial que este domínio utilize HTTPS; para testes locais, ferramentas como ngrok são indispensáveis para criar um túnel seguro. Em seguida, o backend deve ser configurado para receber o ID Token enviado pelo JavaScript do Telegram. Este token JWT precisa ser validado rigorosamente: a assinatura deve ser verificada com as chaves públicas do Telegram (obtidas via JWKS), e os claims como iss (issuer), aud (audience - seu Client ID), exp (expiration time) e iat (issued at) devem ser conferidos. Bibliotecas como PyJWT facilitam essa validação. Após a validação bem-sucedida do ID Token, o backend pode criar ou atualizar o registro do usuário e estabelecer uma sessão, seja através de cookies para páginas HTML ou emitindo tokens de acesso e refresh para APIs JSON. O código de exemplo fornecido utiliza Litestar, mas os princípios do fluxo OIDC são agnósticos à framework, podendo ser replicados em FastAPI, Django ou outras.

O fluxo de login começa com o usuário clicando em um botão "Sign In with Telegram" na sua aplicação. Isso aciona o script telegram-login.js, que abre um popup do Telegram. Dentro deste popup, o Telegram realiza o fluxo OAuth completo, incluindo PKCE, e retorna um ID Token assinado para a sua página via postMessage. O seu backend recebe este ID Token e, em seguida, realiza as verificações de segurança mencionadas. Uma vez validado, o usuário é autenticado e pode receber um cookie de sessão para navegação no site e/ou tokens de acesso e refresh para interagir com APIs. Para logins subsequentes, se um cookie de sessão válido existir, o usuário é reconhecido sem a necessidade de interagir novamente com o Telegram, proporcionando uma experiência de usuário fluida. A implementação detalhada envolve a configuração do bot no BotFather, o uso de um túnel HTTPS como ngrok, e a escrita de código Python para a validação do JWT e gerenciamento de sessão. O repositório tg-auth no GitHub oferece um exemplo prático e testado para guiar o desenvolvedor nesse processo.

🛡️⚡

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.