Magasins de secrets

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

En plus de gérer vos secrets dans les jeux, vous pouvez gérer les secrets en utilisant l'API du magasin de secrets Open Cloud.

Avant d'utiliser l'API, vous devez générer une clé API avec le système API secret-store ou configurer votre application OAuth 2.0 avec le type de champ universe.secret. Les exemples sur cette page utilisent des clés API.

Cryptage des secrets

Lors de la création ou de la mise à jour des secrets sur Roblox, vous devez crypter les secrets avec une boîte scellée LibSodium et la clé publique de votre jeu, puis encoder le résultat en base64.

Tout d'abord, obtenez la clé publique de votre jeu :


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

Ensuite, créez une boîte scellée et encodez-la en base64. L'exemple ci-dessous utilise Python et PyNaCl. (Exécutez pip install pynacl pour l'installer localement).


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

Vous pouvez ensuite créer ou mettre à jour un secret en utilisant la sortie. Cet exemple crée un nouveau secret :


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

Après en avoir créé un, consultez Utiliser des secrets pour utiliser votre secret dans le jeu.

Mettre à jour les secrets

Pour mettre à jour le secret ci-dessus :


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

Si vous devez nettoyer un secret, une demande de suppression ressemble à ceci :


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 Société Roblox. Roblox, le logo Roblox et Powering Imagination font partie de nos marques déposées aux États-Unis et dans d'autres pays.