Gizli depolar

Roblox, her oyun için bir gizli depo sunar. Gizli bilgiler, dış hizmetlerle kimlik doğrulamak için kullandığınız API anahtarları, şifreler ve erişim jetonları gibi hassas bilgilerdir. Örneğin, bir üçüncü taraf analiz veya müzik hizmetine bağlanmak istiyorsanız, muhtemelen onunla kimlik doğrulamak için bir API anahtarı kullanmanız gerekebilir.

API anahtarını bir script'e kopyalayabilir veya bir veri deposuna ekleyebilirsiniz, ancak bu yöntemler gereksiz güvenlik riskleri taşır. Daha iyi bir çözüm, gizli depoyu kullanmak ve anahtarı güvenli yöntemler seti ile erişmektir.

Gizli bilgiler ekleme

Gizli bilgileri görüntülemek, oluşturmak veya düzenlemek için oyun sahibi veya grup sahibi olmalısınız. Her oyunda en fazla 500 gizli bilgi olabilir.

1. Yaratıcı Kontrol Paneli'ne gidin.

2. Oyunuzu seçin, ardından Gizli Bilgiler ⟩ Gizli Bilgi Oluştur seçeneğini tıklayın.

3. Bir isim, gizli bilgi ve geçerli alanı girin.

   • İsim, gizli bilgi için benzersiz bir tanımlayıcı olarak işlev görür, bu nedenle tanımlayıcı bir şey önermekteyiz.
   • Gizli bilgiler maksimum 1.024 karakter uzunluğunda olabilir. API anahtarları ve erişim jetonları hizmet sağlayıcısından gelmelidir, ancak gizli bilgi bir şifre ise, muhtemelen kendi oluşturduğunuz bir şifredir.
   • Alan için * gibi sınırlı bir joker karakter sözdizimi kullanabilirsiniz (önerilmez) veya *.example.com gibi example.com üzerindeki herhangi bir alt alan için. Belirli alanlar daha da iyidir, örneğin my.example.com.

Yerel gizli bilgiler

Güvenlik nedenleriyle, her oyun için gizli depolar yalnızca canlı sunucular veya işbirlikçi test ortamlarında mevcuttur. Yerel oynatma testinde bir gizli bilgiye erişmeye çalıştığınızda, Verilen anahtar ile gizli bilgi bulunamıyor hatası alırsınız. Bir istemci şemasından gizli bilgilere erişmeye çalıştığınızda da aynı hatayı alırsınız.

Yerel testler için gizli bilgileri belirtmek üzere Studio'ya gidin ve ardından Dosya ⟩ Deneyim Ayarları ⟩ Güvenlik bölümüne gidin. Gizli Bilgiler bölümünde yeni gizli bilgiler oluşturabilir ve mevcut gizli bilgileri düzenleyebilir veya silebilirsiniz.

Gizli bilgileri kullanma

Oyun içinde gizli bilgileri kullanmadan önce, Studio'nun Dosya ⟩ Deneyim Ayarları penceresinin Güvenlik bölümünde HTTP İsteklerine İzin Ver seçeneğini etkinleştirmeniz gerekmektedir. Ardından, bir sunucu script'inde HttpService:GetSecret() çağrısını yapın:

local HttpService = game:GetService("HttpService")

local testSecret = HttpService:GetSecret("test_secret")

Gizli depoları kullanmanın cazibesinin bir kısmı, yanlışlıkla bir gizli bilgiyi yazdırma olanağınızın olmamasıdır. Bunun yerine, aşağıdaki kod gizli bilgiyi oluştururken sağladığınız ismi çıktılar:

print(testSecret) --> Gizli(test_secret)

Diziyi doğrudan manipüle edemezsiniz. Bunun yerine, Secret veri türü, gizli bilgi ile bir URL oluşturmanıza veya Bearer gibi içerikler eklemenize yardımcı olacak bir ön ek ve sonek eklemenize olanak tanır:

local HttpService = game:GetService("HttpService")

local testSecret = HttpService:GetSecret("test_secret")

local prefix = "https://my.example.com/endpoint?apiKey="
local suffix = "&user=username"
local url = testSecret:AddPrefix(prefix)
url = url:AddSuffix(suffix)
print(url) --> https://my.example.com/endpoint?apiKey=Gizli(test_secret)&user=username

Gizli bilgi eklenmiş bir URL elde ettiğinizde, HttpService:RequestAsync() gibi yöntemleri kullanarak standart HTTP istekleri yapabilirsiniz. Elbette, bu yöntemleri göz ardı edebilir ve gizli bilgiyi doğrudan bir başlığa da ekleyebilirsiniz.