Yeni bir TeamSpeak 3 sunucusuna ilk kez bağlandığınızda herkes gibi siz de misafir olarak girersiniz. Kanal açamaz, kimseyi gruba alamaz, sunucu ayarlarına dokunamazsınız. Sunucunun sahibi olduğunuzu TS3'e kanıtlamanın yolu ts3 yetki kodu, yani privilege key'dir. Bu rehberde yetki kodunun ne olduğunu, nerede bulunduğunu, istemcide nasıl kullanıldığını ve kaybolursa ne yapmanız gerektiğini anlatıyoruz.

Kısa yanıt: TS3 yetki kodu (privilege key), kullanan kişiyi belirli bir sunucu grubuna ya da kanal grubuna alan tek kullanımlık bir anahtardır. İlk kurulumda sunucu konsoluna ve log dosyasına yazılır. TS3 istemcisinde Permissions (İzinler) → Use Privilege Key (Yetki Anahtarı Kullan) menüsüne yapıştırdığınızda Server Admin olursunuz.

Privilege key nedir?

TeamSpeak 3'te kullanıcı adı ve parola ile giriş yoktur. İstemci ilk açıldığında sizin için bir kimlik (identity) oluşturur ve sunucu sizi bu kimlikten türetilen benzersiz kimlik numarasıyla (unique ID) tanır. Takma adınızı değiştirseniz de, farklı bir IP'den bağlansanız da sunucu sizi aynı kişi olarak görür.

Bu düzenin bir açmazı var: Yeni kurulan sunucuda henüz hiç yönetici yoktur, dolayısıyla size yetki verecek kimse de yoktur. TeamSpeak bu sorunu privilege key ile çözer. Anahtar, uzun ve rastgele görünen bir karakter dizisidir. Bunu kullanan kimlik, anahtarın bağlı olduğu gruba otomatik olarak eklenir. Türkçe kaynaklarda "yetki kodu", "yetki anahtarı" ya da "ts3 token" olarak da geçer; ServerQuery tarafında komutların adı da token ve privilegekey kelimelerini kullanır.

Anahtarın üç temel özelliği vardır:

  • Tek kullanımlıktır. Bir kez kullanıldığında silinir; ikinci denemede hata alırsınız.
  • Tek bir sanal sunucuya aittir. Aynı makinedeki başka bir sanal sunucuda geçmez.
  • Bir gruba bağlıdır. İlk kurulumdaki anahtar Server Admin grubuna bağlıdır. Sonradan oluşturduğunuz anahtarları istediğiniz sunucu grubuna ya da belirli bir kanaldaki kanal grubuna bağlayabilirsiniz.

TS3 yetki kodu nerede bulunur?

Anahtarın yeri, sunucuyu kendiniz mi kurduğunuza yoksa kiraladığınıza göre değişir.

Kendi kurduğunuz sunucuda

Sunucu ilk kez başlatıldığında ve sanal sunucu oluşturulduğunda TS3, konsola şuna benzer bir çıktı yazar:

ServerAdmin privilege key created, please use it to gain serveradmin rights for your virtualserver.

token=gOuRFCa5iM1iC+6GPFaeqiZXJoJrV04+tV0meuE9

token= sonrasındaki kısım sizin anahtarınızdır. Konsolu kapattıysanız aynı satırı sunucu klasöründeki logs dizininde, ilk açılışa ait log dosyasında bulabilirsiniz. Sunucuyu arka planda başlattığınız için konsolda hiçbir şey görmediyseniz de yine log dosyasına bakın. Kurulum adımlarının tamamı için TeamSpeak 3 sunucu kurulum rehberimize göz atabilirsiniz.

Kiralık sunucuda

Barındırma firmaları anahtarı genellikle müşteri panelinde gösterir. SESHost'ta anahtara hiç ihtiyacınız olmaz: sunucunuza bağlandıktan sonra web panelin Yetkiler bölümünden kendinize Server Admin grubunu tek tıkla verirsiniz. Henüz sunucunuz yoksa TS3 sunucu paketlerine göz atabilir, neye dikkat etmeniz gerektiğini TS3 sunucu kiralama rehberinde okuyabilirsiniz.

TS3 yetki kodu nasıl kullanılır?

Anahtarı kullanmadan önce sunucuya, yönetici olarak kalmak istediğiniz kimlikle bağlandığınızdan emin olun. Yetki o kimliğe yazılır.

  1. TeamSpeak 3 istemcisini açın ve sunucunuza bağlanın.
  2. Üst menüden Permissions (İzinler) menüsünü açın.
  3. Use Privilege Key (Yetki Anahtarı Kullan) seçeneğine tıklayın.
  4. Açılan pencereye anahtarı yapıştırın. Başında ya da sonunda boşluk kalmadığına dikkat edin.
  5. OK (Tamam) düğmesine basın. Adınızın yanında Server Admin simgesi belirir ve sohbet penceresinde gruba eklendiğinize dair bir bildirim görürsünüz.

İşlem bittiğinde kanal oluşturabilir, kullanıcılara grup atayabilir ve sunucu ayarlarını düzenleyebilirsiniz. Başkalarına nasıl yetki vereceğinizi TS3 yetki verme rehberinde adım adım anlattık.

Yeni bir yetki anahtarı nasıl oluşturulur?

Yönetici olduktan sonra arkadaşlarınıza da anahtar dağıtabilirsiniz. Kullanıcı o an sunucuda olmasa bile anahtarı ona gönderirsiniz, o da bağlandığında kendisi kullanır. Bunun için hesabınızda b_virtualserver_token_add izni olmalı ve vereceğiniz grubun üye ekleme gücüne (i_group_needed_member_add_power) yetecek kadar i_group_member_add_power değerine sahip olmalısınız. Server Admin grubunda bunlar varsayılan olarak tanımlıdır.

  1. Permissions (İzinler) menüsünden Privilege Keys (Yetki Anahtarları) penceresini açın. Bazı sürümlerde ve çevirilerde bu pencere "Privilege Key List" olarak geçer.
  2. Add (Ekle) düğmesine basın.
  3. Grup türünü seçin: Server Group (Sunucu Grubu) ya da Channel Group (Kanal Grubu).
  4. Listeden grubu seçin. Kanal grubu seçtiyseniz anahtarın hangi kanalda geçerli olacağını da belirleyin.
  5. İsterseniz açıklama alanına anahtarın kime verildiğini yazın. Listeyi sonradan incelerken işinize yarar.
  6. Onaylayın. Oluşan anahtarı kopyalayıp ilgili kişiye iletin.

Sunucu grubuna bağlı anahtar kişiyi tüm sunucuda geçerli bir gruba alır, örneğin Moderatör. Kanal grubuna bağlı anahtar ise yalnızca seçilen kanalda yetki verir, örneğin bir klan kanalında Channel Admin. İki grup türünün farkını yetki verme yazımızda ayrıntılı açıklıyoruz.

Aynı pencerede kullanılmamış anahtarları görebilir, artık gerekmeyenleri silebilirsiniz.

ServerQuery ile anahtar oluşturma

Kendi sunucusunu yöneten ve istemciden yetkisi kalmamış kişiler için ServerQuery yolu da vardır. serveradmin hesabıyla giriş yapıp sanal sunucuyu seçtikten sonra şu komut Server Admin grubuna bağlı yeni bir anahtar üretir:

privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0

Burada tokentype=0 sunucu grubu, tokenid1 grup numarasıdır. Varsayılan kurulumda Server Admin grubunun numarası 6'dır; grupları değiştirdiyseniz önce servergrouplist ile doğru numarayı kontrol edin. Kanal grubu için tokentype=1 kullanılır ve tokenid2 alanına kanal numarası yazılır.

Yetki kodu kaybolursa ne yapılır?

Durumunuza göre yol değişir:

  • Anahtar hiç kullanılmadı ve kayboldu: Kendi sunucunuzda ilk log dosyasına bakın. Bulamazsanız yukarıdaki ServerQuery komutuyla yenisini üretin.
  • Anahtar kullanıldı ama yetkiniz gitti: Genellikle TS3 kimliğinizi kaybettiğiniz ya da yeni bir bilgisayara kimliği taşımadan geçtiğiniz anlamına gelir. Sunucu sizi yeni biri olarak görür. Eski kimliğinizin yedeği varsa (Tools → Identities / Araçlar → Kimlikler menüsünden dışa aktarılmış .ini dosyası) içe aktarın. Yedek yoksa yeni anahtar gerekir.
  • Kiralık sunucudasınız: Sağlayıcınızın paneline bakın. SESHost müşterileri anahtar beklemeden, sunucuya bağlıyken web panelden yönetici grubunu kendilerine yeniden verebilir.

Yeni bir bilgisayara geçmeden önce kimliğinizi dışa aktarmak bu sorunun büyük kısmını baştan önler.

Güvenlik ipuçları

Server Admin anahtarı sunucunuzun anahtarıdır. Ele geçiren kişi gruplarınızı, kanallarınızı ve ban listenizi değiştirebilir.

  • Anahtarı herkese açık kanallara, Discord sunucularına ya da ekran görüntülerine koymayın.
  • Moderatörlere Server Admin anahtarı vermeyin. Onlar için ayrı ve gücü sınırlı bir grup oluşturup o gruba bağlı anahtar üretin.
  • Açıklama alanını doldurun; hangi anahtarın kime verildiğini bilirseniz kullanılmayanları rahatça temizlersiniz.
  • Kullanılmamış eski anahtarları Privilege Keys penceresinden düzenli olarak silin.
  • Kendi sunucunuzda ilk açılışta konsola yazılan serveradmin ServerQuery parolası da en az anahtar kadar önemlidir; onu da güvenli bir yerde saklayın.
  • Kimliğinizi yedekleyin. Yönetici kimliğiniz kaybolursa yetkiniz de onunla gider.

Sık sorulan sorular

Aynı yetki kodunu iki kişi kullanabilir mi?

Hayır. Privilege key tek kullanımlıktır; ilk kullanımdan sonra sunucudan silinir. Birden fazla kişiye yetki verecekseniz her biri için ayrı anahtar oluşturun.

"Invalid privilege key" ya da benzeri bir hata alıyorum, neden?

Anahtar daha önce kullanılmış, silinmiş ya da başka bir sanal sunucuya ait olabilir. Kopyalarken eksik karakter ya da fazladan boşluk kalması da aynı sonucu verir. Anahtarı yeniden kopyalayın; sorun sürerse yenisini oluşturun.

ts3 token ile privilege key aynı şey mi?

Evet. Eski ServerQuery komutları ve izin adları (b_virtualserver_token_add gibi) "token" kelimesini kullanır, istemci arayüzü ise "Privilege Key" der. İkisi de aynı tek kullanımlık anahtarı anlatır.

Yetki kodunu kullandım, yetkiyi nasıl geri alırım?

Anahtar kullanıldığında kişi yalnızca bir gruba eklenir. Yetkili bir yönetici, kullanıcıya sağ tıklayıp Set Server Group (Sunucu Grubu Ata) menüsünden grubu kaldırarak yetkiyi geri alabilir.