除了 在游戏中管理秘密 之外,您还可以使用 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 b64encodefrom nacl import encoding, publicpublic_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>'