Kho lưu trữ bí mật

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

Ngoài việc quản lý các bí mật của bạn trong trò chơi, bạn có thể quản lý bí mật bằng API kho lưu trữ bí mật Open Cloud.

Trước khi sử dụng API, bạn phải tạo một khóa API với hệ thống API secret-store hoặc cấu hình ứng dụng OAuth 2.0 của bạn với loại phạm vi universe.secret. Các ví dụ trên trang này sử dụng khóa API.

Mã hóa bí mật

Khi tạo hoặc cập nhật bí mật trên Roblox, bạn phải mã hóa các bí mật bằng LibSodium sealed box và khóa công khai của trò chơi của bạn, và sau đó mã hóa kết quả thành base64.

Đầu tiên, lấy khóa công khai của trò chơi của bạn:


curl --location 'https://apis.roblox.com/cloud/v2/universes/{universeId}/secrets/public-key' \
--request GET \
--header 'x-api-key: <your-secret-here>' \

Tiếp theo, tạo một sealed box và mã hóa nó thành base64. Ví dụ dưới đây sử dụng Python và PyNaCl. (Chạy pip install pynacl để cài đặt nó cục bộ).


from base64 import b64encode
from nacl import encoding, public
public_key = "Zgj4+V7vSaEZ06rXazKJUIcUnVa95tUNiwXAif/vdHo="
secret_content = "my_api_key_content"
public_key = public.PublicKey(public_key.encode("utf-8"), encoding.Base64Encoder())
sealed_box = public.SealedBox(public_key)
encrypted = sealed_box.encrypt(secret_content.encode("utf-8"))
print(b64encode(encrypted).decode("utf-8"))

Bạn có thể tạo hoặc cập nhật một bí mật bằng cách sử dụng đầu ra. Ví dụ này tạo một bí mật mới:


curl --location 'https://apis.roblox.com/cloud/v2/universes/6930499524/secrets' \
--request POST \
--header 'Content-Type: application/json' \
--header 'x-api-key: <your-secret-here>' \
--data '{
"id": "mySecret",
"secret": "fP9scJkcDk492F4c1VHZ5QS8v2qsAg7uI+NVVEw6zC0GBnj7xpi7UrNr++lCfr4wyq3ia9Uuu+Ao8HtIXz2gRxBX",
"key_id": "1200590785272263122"
}'

Sau khi bạn tạo một cái, xem Sử dụng bí mật để sử dụng bí mật của bạn trong trò chơi.

Cập nhật bí mật

Để cập nhật bí mật ở trên:


curl --location 'https://apis.roblox.com/cloud/v2/universes/6930499524/secrets/mySecret' \
--request PATCH \
--header 'Content-Type: application/json' \
--header 'x-api-key: <your-secret-here>' \
--data '{
"secret": "2Fczw/PL7woOzHnGHQ65sT0MbzJjEOlfibyKxy374CqzFyEb2QTS8grtNBgG/0sfIvSHEo9JWN+pUr0NTPs0V6lj",
"key_id": "1200590785272263122"
}'

Nếu bạn cần xóa một bí mật, yêu cầu xóa trông như thế này:


curl --location 'https://apis.roblox.com/cloud/v2/universes/6930499524/secrets/mySecret' \
--request DELETE \
--header 'Content-Type: application/json' \
--header 'x-api-key: <your-secret-here>'
©2026 Roblox Corporation. Roblox, logo Roblox và Powering Imagination là các nhãn hiệu đã đăng ký và chưa đăng ký của chúng tôi tại Hoa Kỳ và các quốc gia khác.