Discord bot token’ı, bir botun hesabının şifresidir: onu elinde tutan kişi, o botu Discord’a giriş yaptırabilir ve izinlerinin izin verdiği her şeyi, halihazırda katıldığı her sunucuda yaptırabilir. Bir bot uygulaması oluşturduğunda Discord Geliştirici Portalı’ndan ücretsiz olarak alırsın. Bir botun kullanıcı kimliği ya da davet bağlantısı gibi herkese açık bir tanımlayıcı değil, tam olarak bir şifre olduğu için onu şifre gibi ele al.

Discord bot token’ı nasıl alınır?

  1. Geliştirici Portalı’nı aç. discord.com/developers/applications adresine git ve botun sahibi olması gereken Discord hesabıyla giriş yap.
  2. Bir uygulama oluştur. Yeni Uygulama düğmesine bas ve bir ad ver. Bu ad henüz botun görünen adı değildir, yalnızca uygulamanın adıdır.
  3. Bot sekmesini aç. Discord, uygulamaya otomatik olarak bir bot kullanıcısı ekler. Kullanıcı adını ve avatarını burada ayarla; üyelerin sunucuda göreceği şey budur.
  4. İhtiyacın olan intent’leri aç. Ayrıcalıklı Gateway Intent’leri altında, Sunucu Üyeleri Intent’i ve Mesaj İçeriği Intent’i varsayılan olarak kapalıdır. Yeni üyeleri karşılayan, mesaj metnini okuyan veya rolleri takip eden çoğu bot, ikisinin de açılmasına ihtiyaç duyar.
  5. Token’ı Sıfırla’ya bas. Discord token’ı üretir ve yalnızca bir kez gösterir. Hemen kopyala; aynı token’ı daha sonra tekrar görüntülemenin bir yolu yoktur. Token’ı Sıfırla’ya ikinci kez basmak, ilkini geçersiz kılar ve yenisini verir.
  6. Gerektiği yere yapıştır. Kendi bot kodunda bir ortam değişkeni olarak ya da bir barındırma sağlayıcısının kontrol paneli alanına; asla bir sohbet mesajına, herkese açık bir depoya veya bir destek talebine değil.

Bir bot token’ı gerçekte neye izin verir?

Token, kodun Discord’un gateway’i ve REST API’si üzerinden bot kullanıcısı olarak kimlik doğrulaması yapma yoludur. Geçerli bir token ile kod şunları yapabilir:

  • Botu Discord’a giriş yaptırmak ve çevrimiçi tutmak
  • Botun görebildiği herhangi bir kanalda mesaj göndermek ve okumak
  • Botun zaten katıldığı her sunucuda, bot rolünün izinlerinin izin verdiği her eylemi yapmak: rolleri yönetmek, atmak, yasaklamak, kanal silmek ve benzeri
  • Botun kendi DM’lerini okumak ve etkileşimlere (slash komutları, düğmeler, modallar) yanıt vermek

Verdiği şey olmayan ise botu yeni sunuculara ekleme yetkisidir. Bir botu davet etmek, uygulamanın istemci kimliğinden ve seçilen izin kümesinden oluşturulan ayrı bir OAuth2 yetkilendirme bağlantısı gerektirir ve bunu bir sunucu yöneticisinin onaylaması gerekir. Sızdırılmış bir token, botu yeni hiçbir yere davet etmek için kullanılamaz; ancak bot zaten katıldığı her sunucuda, o sunucuda botun sahip olduğu izinlere kadar gerçek zarar verebilir.

Bir bot token’ını neden asla sohbette paylaşmamalısın?

Bot token’ı, yerleşik bir son kullanma tarihi olmayan, düz metin bir kimlik bilgisidir. Onu elinde tutan herkes, token’ı sıfırlayana kadar botunun kimliğiyle kendi kopyasını çalıştırabilir. Bu, Discord destek sunucularında, GitHub sorunlarında veya kısa bir an bile görünen ekran paylaşımlarında da geçerlidir. Örneğin bir GitHub commit’inde herkese açık olarak paylaşmak, Discord tarafından sızdırılmış bir kimlik bilgisi olarak değerlendirilir ve botların ele geçirilip bulundukları her sunucuya spam yapmak için kullanılmasının yaygın yollarından biridir. Sızdırılmış bir token’ı kimin kullandığını veya onunla ne yaptığını sonradan anlamanın bir yolu yoktur; tek çözüm onu sıfırlamaktır.

Aynı dikkat, bir token’ı barındırma sağlayıcısıyla paylaşırken de geçerlidir. Token’ı yalnızca bir sağlayıcının kendi kontrol paneli alanına, HTTPS üzerinden yapıştır; ne kadar güvenilir olursa olsun bir kişiye mesaj olarak ya da bir hata raporuna asla yapıştırma.

Token’ı sıfırlamak erişimi anında iptal eder

Geliştirici Portalı’nda Token’ı Sıfırla’ya basmak, eski token’ı hemen geçersiz kılar. Onu hâlâ kullanan her süreç (kendi kodun, bir barındırma sağlayıcısı, izinsiz olarak elde eden herkes), bir sonraki yeniden bağlanma denemesinde bağlantısı kesilir ve eski değerle tekrar giriş yapamaz. Bilmeye değer iki şeyin arkasındaki mekanizma budur:

  • Bu senin acil durdurma anahtarındır. Bir token’ın sızdığından şüphelenirsen, başka hiçbir şey yapmadan önce sıfırla. Bot, eski token’a sahip olanlar için çevrimdışı olur ve yalnızca yeni token’ın girildiği yerde çevrimiçi döner.
  • Sağlayıcı değiştirmenin yoludur. Token’ını bir barındırma hizmetine verdin ve ayrılmak mı istiyorsun? Geliştirici Portalı’nda token’ı sıfırla; erişimleri hemen sona erer ve onlardan bir şey silmelerini istemene gerek kalmaz.

Sıfırlanmış bir token yüzünden bağlantısı kesilen bir bot, loglarında genellikle 4004 (geçersiz token) gateway kapatma kodunu gösterir. Bu, Discord’un kullanmaya çalıştığı kimlik bilgisinin artık var olmadığını söylemesinin yoludur.

A user's bot token runs on a Noxyr node and comes online as their own branded bot. Your token Noxyr node MyBot Online

Noxyr token’ını nasıl saklar?

Noxyr, bot token’ını yalnızca Özel Bot özelliği için ister; bu özellikte Noxyr’ın tam özellik setini kendi botunun adı ve avatarı altında çalıştırırsın. Token şifreli olarak saklanır, yalnızca botunu Discord’un gateway’ine giriş yaptırmak için kullanılır ve yapıştırdıktan sonra sana ya da başka hiç kimseye geri gösterilmez. Erişimi kesmek istersen, token’ı yukarıda anlatıldığı gibi Geliştirici Portalı’ndan sıfırla; Noxyr’ın botu, eski token’ı kullanan diğer istemciler gibi, bunu yaptığın anda bağlantısı kesilir. Tam kurulum adımları, gerekli intent’ler ve ücretsiz Top.gg oy erişim modeli Özel Bot dokümanlarında ve Özel Bot kurulum rehberimizde bulunur.

Sık sorulan sorular

Discord bot token’ımı nerede bulurum? Geliştirici Portalı, uygulaman, Bot sekmesi, Token’ı Sıfırla. Oluşturulduğu anda bir kez gösterilir; mevcut bir token’ı tekrar gösteren bir sayfa yoktur.

Bot token’ını paylaşmak güvenli mi? Hayır. Özel olarak bile paylaşmak, o kişiye katıldığı her sunucuda botun tam kontrolünü verir. Yalnızca kendi koduna ya da bir barındırma sağlayıcısının kontrol paneli alanına gir.

Bot token’ımı sıfırlarsam ne olur? Eski token, kullanıldığı her yerde hemen çalışmayı bırakır. Koduna ya da sağlayıcı paneline yapıştırman için yeni bir token alırsın; botun kimliği, sunucuları ve mevcut verileri etkilenmez.

Sızdırılmış bir token botumu başka sunuculara eklemek için kullanılabilir mi? Hayır. Bunun için ayrı OAuth2 davet bağlantısı ve hedef sunucudaki bir yöneticinin onayı gerekir. Sızdırılmış bir token, bot zaten bulunduğu her sunucuda yine de tehlikelidir.

Token’ı sıfırlamak bir şeyi siler mi? Hayır. Yalnızca eski kimlik bilgisini geçersiz kılar. Botun uygulamasına ve kullanıcı kimliğine bağlı ayarlar, roller ve saklanan veriler olduğu gibi kalır.

Kendi botunu mu kuruyorsun? Noxyr’ı ücretsiz ekle ya da kendi kodunu yazıyorsan barındırma rehberine bak.