Sklepy z sekretami

Roblox oferuje sklep z sekretami dla każdej gry. Sekrety to wrażliwe informacje, takie jak klucze API, hasła i tokeny dostępu, które używasz do uwierzytelniania w usługach zewnętrznych. Na przykład, jeśli chcesz połączyć się z zewnętrzną usługą analityczną lub muzyczną, prawdopodobnie będziesz musiał użyć klucza API do uwierzytelnienia.

Możesz skopiować i wkleić klucz API do skryptu lub dodać go do magazynu danych, ale te podejścia niosą ze sobą niepotrzebne ryzyko bezpieczeństwa. Lepszym rozwiązaniem jest użycie sklepu z sekretami i uzyskanie dostępu do klucza za pomocą małego zestawu bezpiecznych metod.

Dodaj sekrety

Aby wyświetlić, utworzyć lub edytować sekrety, musisz być właścicielem gry lub właścicielem grupy. Możesz mieć do 500 sekretów na grę.

1. Przejdź do Panelu Twórcy.

2. Wybierz swoją grę, a następnie wybierz Sekrety ⟩ Utwórz sekret.

3. Wprowadź nazwę, sekret i odpowiednią domenę.

   • Nazwa działa jako unikalny identyfikator dla sekretu, dlatego zalecamy coś opisowego.
   • Sekrety mogą mieć długość do 1 024 znaków. Klucze API i tokeny dostępu powinny pochodzić od dostawcy usługi, ale jeśli sekret to hasło, prawdopodobnie stworzyłeś je sam.
   • Możesz używać ograniczonej składni symboli wieloznacznych dla domeny, takiej jak * dla dowolnej domeny (niezalecane) lub *.example.com dla dowolnej subdomeny na example.com. Jeszcze lepsze są konkretne domeny, takie jak my.example.com.

Lokalne sekrety

Z powodów bezpieczeństwa sklep z sekretami dla każdej gry jest dostępny tylko na serwerach na żywo lub w środowiskach testowania współpracy. Jeśli spróbujesz uzyskać dostęp do sekretu podczas lokalnego testowania, otrzymasz błąd Nie można znaleźć sekretu o podanym kluczu. Otrzymasz identyczny błąd, jeśli spróbujesz uzyskać dostęp do sekretów z skryptu klienta.

Aby określić sekrety do lokalnego testowania, przejdź do Studio, a następnie do Plik ⟩ Ustawienia doświadczenia ⟩ Bezpieczeństwo. Możesz tworzyć nowe sekrety oraz edytować lub usuwać istniejące sekrety w sekcji Lokalne sekrety.

Użyj sekretów

Przed użyciem sekretów w swojej grze musisz włączyć Zezwól na żądania HTTP w sekcji Bezpieczeństwo okna Plik ⟩ Ustawienia doświadczenia w Studio. Następnie wywołaj HttpService:GetSecret() w skrypcie serwera:

local HttpService = game:GetService("HttpService")

local testSecret = HttpService:GetSecret("test_secret")

Częścią atrakcyjności korzystania z sklepów z sekretami jest to, że nie możesz przypadkowo wydrukować sekretu. Zamiast samego sekretu, poniższy kod wyświetla nazwę, którą podałeś podczas tworzenia sekretu:

print(testSecret) --> Sekret(test_secret)

Nie możesz manipulować ciągiem bezpośrednio. Zamiast tego typ danych Secret pozwala dodać prefiks i sufiks do sekretu, aby pomóc w utworzeniu adresu URL lub wstawieniu treści, takiej jak Bearer:

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=Sekret(test_secret)&user=username

Po uzyskaniu adresu URL z wstawionym sekretem możesz wykonywać standardowe żądania HTTP za pomocą metod takich jak HttpService:RequestAsync(). Oczywiście możesz zignorować te metody i wstawić sekret bezpośrednio do nagłówka.