Hoşgeldin Misafir

Telegram Botlar & Mini Uygulamalar

Stronger_Cracker

25 Tem 2022
6,628 Mesaj

Aktiflik

Seviye

Deneyim

TIM / GÖREV:
Telegram, günümüzde yalnızca uçtan uca şifreli bir mesajlaşma platformu olmaktan çıkıp; sunduğu gelişmiş Bot API altyapısı ve Mini Uygulamalar (Telegram Mini Apps - TMA) ekosistemiyle başlı başına bir uygulama platformuna dönüşmüştür. Otomasyon sistemlerinden kripto cüzdanlarına, sunucu izleme araçlarından oyun ve e-ticaret arayüzlerine kadar milyonlarca işlem artık doğrudan Telegram içerisinden yürütülmektedir.

Ancak bu popülerlik beraberinde ciddi siber güvenlik risklerini de getirmektedir. Yanlış yapılandırılan Mini Uygulama doğrulamaları (initData spoofing), GitHub üzerinde unutulan Bot Token anahtarları ve zararlı yazılımların Komuta Kontrol (C2) merkezi olarak Telegram botlarını suistimal etmesi hem geliştiriciler hem de güvenlik araştırmacıları için kritik bir inceleme alanıdır.

Bu rehberde, Telegram Botları ve Mini Uygulamaların çalışma mimarisini, Webhook/Long Polling farklarını, kurulum adımlarını ve siber güvenlik boyutunu en ince ayrıntısına kadar ele alıyoruz.

Başlıklarımız
  • Telegram Bot Ekosistemi ve Bot API Mimarisi
  • Çalışma Yöntemleri: Long Polling ve Webhook Mimarisi
  • Klasik Telegram Botları ile Mini Uygulamaların (TMA) Karşılaştırması
  • Telegram Mini Uygulamalar (TMA / WebApps) Nasıl Çalışır ve Geliştirilir?
  • Siber Güvenlik Boyutu: Bot Token Sızıntıları, C2 İstismarı ve initData Doğrulaması
  • Telegram Bot ve Mini Uygulamalarda Yanlış Bilinenler ve Sık Yapılan Hatalar
  • Geliştiriciler İçin Güvenlik ve Performans Önerileri

​

1. Telegram Bot Ekosistemi ve Bot API Mimarisi​

Telegram botları, arka planda bir yazılım tarafından yönetilen ve telefon numarası gerektirmeyen özel Telegram hesaplarıdır. Geliştiricilerin karmaşık MTProto şifreleme protokolüyle doğrudan uğraşmaması için Telegram, aracı bir HTTP tabanlı Bot API sunucusu sağlar.
  • @BotFather ile Yönetim: Telegram üzerindeki tüm botların oluşturulması, yetkilendirilmesi, komut listelerinin tanımlanması ve benzersiz API Token anahtarlarının üretilmesi resmi @BotFather botu üzerinden gerçekleştirilir.
  • HTTP/JSON Haberleşmesi: Geliştirdiğiniz yazılım (Python, Node.js, Go, PHP vb.), Telegram sunucularına https://api.telegram.org/bot<TOKEN>/METOD_ADI formatında standart HTTPS istekleri gönderir ve yanıtları JSON formatında alır.
  • Geniş Entegrasyon Yeteneği: Botlar; grup moderasyonu, sunucu sağlık bildirimleri (SSH/Wazuh alarmları), dosya transferi ve ödeme alma gibi işlemleri saniyeler içinde otomatikleştirebilir.

​

2. Çalışma Yöntemleri: Long Polling ve Webhook Mimarisi​

Kullanıcıların bota gönderdiği mesajların (Update) sunucunuz tarafından alınması için iki farklı iletişim modeli kullanılır:
  • Long Polling (getUpdates): Bot yazılımınız belirli aralıklarla Telegram sunucusuna bağlanarak "Bana gelen yeni bir mesaj var mı?" diye sorar. Kurulumu çok basittir, SSL sertifikası veya alan adı gerektirmez; yerel bilgisayarda (localhost) geliştirme ve test aşaması için idealdir. Ancak yüksek trafikli botlarda gereksiz kaynak tüketimine ve gecikmeye yol açar.
  • Webhook (setWebhook): Botunuz sürekli Telegram'a sormak yerine, bir kullanıcı mesaj attığı anda Telegram sunucusu sizin belirlediğiniz HTTPS adresine (POST isteği olarak) veriyi anında iletir. Gerçek zamanlıdır, sunucu CPU/ağ kaynaklarını yormaz ve büyük ölçekli üretim (Production) ortamları için standart yöntemdir.

​

3. Klasik Telegram Botları ile Mini Uygulamaların (TMA) Karşılaştırması​

ce1372cbf73e3ea94e


Telegram ekosistemindeki otomasyon araçları kullanıcı etkileşim biçimine göre üç ana gruba ayrılır:
ÖzellikKlasik Komut BotlarıSatır İçi (Inline) BotlarMini Uygulamalar (TMA / WebApps)
Arayüz YapısıMetin mesajları ve sohbet içi butonlarYazışma satırında açılan hızlı arama listesiTam ekran HTML5 / JavaScript / React arayüzü
Tetikleme Şekli/start gibi eğik çizgi komutlarıHerhangi bir sohbette @bot_adi yazılmasıMenü butonu, özel link veya satır içi WebApp butonu
Kullanım AlanıModerasyon, bildirim ve basit sorgularGIF, müzik, çeviri ve hızlı içerik paylaşımıWeb3 cüzdanlar, e-ticaret, kontrol panelleri, oyunlar
Cihaz ve Tema UyumuStandart sohbet görünümüStandart açılır pencereDinamik karanlık/aydınlık tema, titreşim (Haptic) ve biyometri

4. Telegram Mini Uygulamalar (TMA / WebApps) Nasıl Çalışır ve Geliştirilir?​

Telegram Mini Uygulamalar (TMA), kullanıcıların Telegram'dan ayrılmadan ve harici bir uygulama indirmeden doğrudan sohbet penceresi içinde tam kapsamlı web uygulamalarını çalıştırmasına olanak tanıyan entegre bir WebView teknolojisidir.

  • telegram-web-app.js SDK: Geliştirilen web sayfasına resmi JavaScript kütüphanesi eklendiğinde window.Telegram.WebApp nesnesi aktif olur. Bu nesne üzerinden kullanıcının ekran teması, dil tercihi ve kimlik bilgileri alınabilir.
  • Yerel Bileşenler (Native UI): Uygulama içerisinden Telegram'ın kendi alt ana butonu (MainButton), geri butonu (BackButton), QR kod okuyucusu, titreşim motoru (HapticFeedback) ve biyometrik doğrulama özellikleri doğrudan tetiklenebilir.
  • Bulut ve Cihaz Depolama: Mini uygulamalar, kullanıcı bazlı ayarları saklamak için CloudStorage ve DeviceStorage API'lerini kullanarak verileri Telegram bulutunda senkronize tutabilir.
  • Telegram Stars ve TON Entegrasyonu: Dijital ürün ve servis ödemeleri için Telegram Stars veya blokzincir tabanlı işlemler için TON Connect cüzdan altyapısı doğrudan mini uygulamalara entegre edilebilmektedir.

5. Siber Güvenlik Boyutu: Bot Token Sızıntıları, C2 İstismarı ve initData Doğrulaması​

deb4ed6951d780f7b7


Hem uygulama geliştiricileri hem de sızma testi uzmanları için Telegram botlarında üç kritik güvenlik başlığı öne çıkmaktadır:

  1. Mini Uygulamalarda initData Doğrulama Zafiyeti (IDOR / Hesap Ele Geçirme): Mini uygulama açıldığında istemci tarafında WebApp.initDataUnsafe.user.id değeri oluşur. Eğer geliştirici, arka uç (Backend) sunucusunda kriptografik imza kontrolü yapmadan doğrudan istemciden gelen user_id değerine güvenirse; bir saldırgan Burp Suite ile araya girip kendi ID'si yerine başka bir kullanıcının ID'sini göndererek onun hesabını veya bakiyesini ele geçirebilir. Bunu önlemek için initData içerisindeki hash değeri, sunucu tarafında Bot Token ile HMAC-SHA256 algoritması kullanılarak mutlaka doğrulanmalıdır.
  2. GitHub ve İstemci Kaynak Kodlarında Token Sızıntısı: Açık kaynak depolarda unutulan .env dosyaları veya mobil/masaüstü uygulamaların içine gömülen (hardcoded) Bot Token anahtarları, saldırganların getMe, getUpdates ve sendMessage metodlarıyla botu tamamen devralmasına yol açar.
  3. Zararlı Yazılımlarda C2 (Komuta Kontrol) Olarak Telegram Kullanımı: Bilgi çalıcı (Infostealer) ve RAT geliştiricileri, trafiği normal HTTPS/Telegram trafiği gibi göründüğü ve güvenlik duvarlarına takılmadığı için çaldıkları verileri Telegram Bot API üzerinden kendi kanallarına aktarır. Zararlı yazılım analizinde (Reverse Engineering) ikilik dosya içinden çıkarılan Bot Token ve chat_id değerleri, adli bilişim uzmanlarının saldırganın C2 kanalını tespit etmesini sağlar.

​

6. Telegram Bot ve Mini Uygulamalarda Yanlış Bilinenler ve Sık Yapılan Hatalar​

Bot geliştirirken veya kullanırken doğru sanılan ancak güvenlik açığı doğuran yaygın yanılgılar:

  • ❌ "Mini Uygulama sadece Telegram içinden açıldığı için istemciden gelen verilere doğrudan güvenebilirim."
  • Doğrusu: Mini Uygulamalar özünde birer web sayfasıdır; saldırganlar uygulama URL'sini normal bir tarayıcıda açıp geliştirici araçlarıyla (DevTools) sahte API istekleri gönderebilir.
  • ❌ "Bir gruba eklenen her bot, gruptaki tüm yazışmaları gizlice okuyabilir."
  • Doğrusu: Telegram botlarında varsayılan olarak Gizlilik Modu (Privacy Mode) açıktır. Bot yönetici yapılmadığı veya @BotFather üzerinden gizlilik modu kapatılmadığı sürece yalnızca / ile başlayan komutları ve kendisine verilen yanıtları görebilir.
  • ❌ "Webhook tanımlarken sunucumdaki herhangi bir portu (örneğin 3000 veya 8080) kullanabilirim."
  • Doğrusu: Telegram Bot API sunucuları güvenlik politikası gereği Webhook bağlantılarında yalnızca 443, 80, 88 ve 8443 portlarını ve geçerli bir HTTPS (TLS) sertifikasını destekler.

​

7. Geliştiriciler İçin Güvenlik ve Performans Önerileri​


Geliştirdiğiniz botların ve mini uygulamaların kesintisiz ve güvenli çalışması için uygulamanız gereken temel prensipler:

  1. Webhook Gizli Anahtar Doğrulaması (Secret Token):setWebhook metodunu çağırırken secret_token parametresi tanımlayın. Sunucunuza gelen her istekte X-Telegram-Bot-Api-Secret-Token HTTP başlığını kontrol ederek sahte Webhook isteklerini engelleyin.
  2. auth_date Zaman Damgası Kontrolü: Mini uygulamalarda sadece HMAC-SHA256 imzasını doğrulamakla yetinmeyin; initData içindeki auth_date değerini kontrol ederek eski oturum paketlerinin tekrar kullanılmasını (Replay Attack) önleyin.
  3. Mesaj Kuyruğu ve Rate Limit Yönetimi: Telegram Bot API, saniyede toplam en fazla 30 mesaj ve aynı gruba dakikada en fazla 20 mesaj gönderilmesine izin verir. 429 Too Many Requests engeline takılmamak için Redis veya RabbitMQ tabanlı bir kuyruk yapısı kullanın.
  4. Token Sızıntısında Anında İptal (Revoke): API anahtarınızın sızdığından şüphelendiğiniz anda @BotFather üzerinden /revoke komutunu kullanarak eski anahtarı geçersiz kılın ve ortam değişkenlerinizi (.env) güncelleyin.