秘密存储

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

除了 在游戏中管理秘密 之外,您还可以使用 Open Cloud 秘密存储 API 来管理秘密。

在使用该 API 之前,您必须 生成 API 密钥,并选择 secret-store API 系统,或者 配置您的 OAuth 2.0 应用,并选择 universe.secret 范围类型。本页面中的示例使用 API 密钥。

秘密加密

在 Roblox 上创建或更新秘密时,您必须使用 LibSodium 密封箱 和您游戏的公钥对秘密进行加密,然后对结果进行 base64 编码。

首先,获取您游戏的公钥:


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

接下来,创建一个密封箱并进行 base64 编码。下面的示例使用 Python 和 PyNaCl。 (运行 pip install pynacl 以在本地安装它)。


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"))

然后,您可以使用输出创建或更新秘密。此示例创建一个新秘密:


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"
}'

创建之后,请参见 使用秘密 以在游戏中使用您的秘密。

更新秘密

要更新上述秘密:


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"
}'

如果您需要清理一个秘密,删除请求如下所示:


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、Roblox 标志及 Powering Imagination 是我们在美国及其他国家或地区的注册与未注册商标。