Discord botları nasıl çalışır

Bir bot, Discord'un gönderdiği olayları dinleyen ve Discord'a istek göndererek iş yapan bir programdır. Aegis'in bir saldırıyı nasıl fark ettiği de buradan anlaşılır.

Dokümantasyon / Temeller / Discord botları nasıl çalışır

  1. Davet ile girer

    Bot, izinleri yazan bir davet bağlantısıyla sunucuya eklenir.

  2. Olayları dinler

    Discord, sunucuda olan biteni bota anlık olay olarak gönderir.

  3. İstekle iş yapar

    Bot bir şey yapmak istediğinde Discord'a istek gönderir: mesaj sil, rol al, embed yaz.

Bir Discord botu, bir insan yerine bir programın kullandığı özel bir hesaptır. Discord Developer Portal'da bir uygulama olarak oluşturulur, sunucuya davet bağlantısıyla eklenir ve kendi sunucusunda kesintisiz çalışan bir program tarafından yönetilir. Aegis, discord.js v14 kütüphanesiyle yazılmış böyle bir programdır.

Bot bir uygulamadır

Botun adı, avatarı ve gizli bir token'ı vardır. Program bu token ile Discord'a bağlanır; token'ı bilen herkes botu yönetebileceği için yalnızca botun sunucusunda saklanır. Discord'da bot hesaplarının yanında APP etiketi görünür.

Davet ve izinler

Bir botu sunucuna eklemek için Discord'un davet ekranı kullanılır. Bağlantı, botun kim olduğunu ve hangi izinleri istediğini taşır. Sunucuyu seçip onayladığında bot, o izinlerle sunucuya katılır.

Aegis davet bağlantısıurl
https://discord.com/oauth2/authorize?client_id=1527276218007687168&permissions=8&integration_type=0&scope=bot+applications.commands
ParametreTürAçıklamaÖrnek
client_id *kimlikHangi botun ekleneceği.1527276218007687168
permissions *sayıİstenen izinlerin toplamı. 8, Yönetici iznidir.8
scope *listebot: sunucuya üye olarak katılır. applications.commands: slash komutlarını kaydeder.bot+applications.commands
integration_typesayı0, botun bir sunucuya eklendiğini belirtir.0

Olaylar: botun kulağı

Bot çalıştığı sürece Discord Gateway'e açık bir bağlantı tutar. Sunucuda bir şey olduğunda Discord bunu bota olay olarak iletir. Bot yalnızca istediği olay gruplarını (intent) alır; üye listesi ve mesaj içeriği gibi hassas gruplar için Discord ayrıca onay ister.

MESSAGE_CREATE
Yeni mesaj. AutoMod küfür ve davet linkini burada yakalar.
GUILD_MEMBER_ADD
Yeni üye. Karşılama, otorol, güven skoru ve Anti-Raid sayacı çalışır.
CHANNEL_DELETE
Kanal silindi. Anti-Nuke silmeleri sayar.
GUILD_ROLE_UPDATE
Rol değişti. Rol logu yazılır, izin değişiklikleri izlenir.
INTERACTION_CREATE
Biri slash komutu yazdı ya da bir düğmeye bastı.
  • Aegis; sunucu, mesaj, mesaj içeriği, üye, tepki, durum, moderasyon, davet, ses ve webhook olay gruplarını dinler.

İstekler: botun eli

Bot bir şey yapmak istediğinde Discord'un API'sine istek gönderir: mesajı sil, üyeye rol ver, kanalı aç, embed gönder. Discord her isteği botun izinlerine ve rol sırasına göre kontrol eder; izni olmayan isteği reddeder. Çok hızlı istek gönderen botları da geçici olarak yavaşlatır.

Slash komutları

Sohbete / yazdığında Discord, sunucudaki botların kaydettiği komutları listeler. Komutu gönderdiğinde Discord bunu bota bir etkileşim olarak iletir. Bot 3 saniye içinde yanıt vermek ya da "düşünüyor" durumuna geçmek zorundadır; /setup gibi uzun süren komutlar önce düşünme durumuna geçer, iş bitince yanıtı yazar.

Bota giden etkileşim (sadeleştirilmiş)json
{
  "type": "APPLICATION_COMMAND",
  "data": { "name": "kurulum" },
  "guild_id": "…",
  "member": { "user": { "username": "sen" } }
}

Aegis bunları nasıl birleştirir

Bir yetkilinin hesabı ele geçirildiğinde olan zincir şöyledir:

1. Olay
Kısa sürede art arda CHANNEL_DELETE olayları gelir.
2. Sayım
Aegis aynı kişinin 10 saniyedeki silmelerini sayar ve eşikle karşılaştırır (varsayılan 3).
3. İstekler
Eşik aşılınca o kişinin rolleri geri alınır, sunucu izinleri dondurulur.
4. Kayıt
guvenlik-log kanalına ne olduğunu anlatan bir embed yazılır, kurucuya DM gider.
Aegis bunların hepsini yalnızca kendisine verilen izinlerle ve rol sırası izin verdiği ölçüde yapabilir. Bu yüzden kurulumda Yönetici izni ve üst sıradaki rol önerilir.