Passer au contenu principal
Grâce à cette nouvelle fonctionnalité, les développeurs de jeux peuvent téléverser, répertorier, mettre à jour et utiliser de façon sécurisée des secrets, tels que des clés d’instrumentation et des clés secrètes, sur les serveurs de jeu.

Utiliser la fonctionnalité de gestion des secrets

Pour gérer et utiliser efficacement les secrets, le flux de travail recommandé comprend :
  1. L’ajout de secrets (cette étape peut être répétée pour plusieurs secrets)
  2. Le référencement des secrets par leur nom lors de la création d’une build
  3. L’accès aux secrets depuis votre serveur de jeu
  4. La mise à jour des secrets si nécessaire

Ajout de secrets

Les secrets peuvent être ajoutés au moyen de l’API UploadSecret. Cette API permet de téléverser un nouveau secret dans le service ou de mettre à jour un secret existant en définissant le paramètre ForceUpdate sur true.

Déploiement des secrets

Pour déployer des secrets sur des machines virtuelles nouvellement créées, incorporez le secret dans une build à l’aide du paramètre GameSecretReferences des API CreateBuild (applicable aux déploiements basés sur un conteneur comme sur un processus).
Une fois une build créée, il n’est pas possible d’y ajouter de nouveaux secrets; toutefois, la mise à jour d’un secret existant permet d’utiliser sa valeur mise à jour sur les nouvelles machines virtuelles (les machines virtuelles existantes conservent les valeurs d’origine).
Voici un exemple de référencement des secrets :

Accès aux secrets

Une fois les secrets ajoutés et référencés dans de nouvelles builds, les serveurs de jeu peuvent accéder à leurs valeurs au moyen de variables d’environnement dans chaque serveur de jeu, qu’il soit basé sur un conteneur ou sur un processus. La convention de nommage des variables d’environnement est la suivante :

Suppression de secrets

Pour supprimer un ancien secret, utilisez l’API DeleteSecret. Assurez-vous que le secret n’est utilisé dans aucune build avant de tenter de le supprimer; sinon, la suppression échouera.

Utiliser des secrets dans les scripts de démarrage de machine virtuelle

Les scripts de démarrage de machine virtuelle peuvent utiliser les valeurs des secrets en référençant les variables d’environnement décrites ci-dessus. Cela permet, par exemple, d’utiliser des clés de télémétrie ou d’autres valeurs nécessaires avant de lancer un serveur de jeu.

Voir aussi

Dernière modification le 8 octobre 2026