Skip to main content
Con esta nueva característica, los desarrolladores de juegos pueden cargar, enumerar, actualizar y usar de forma segura secretos como claves de instrumentación y claves secretas en los servidores de juego.

Cómo usar la característica de administración de secretos

Para administrar y utilizar los secretos de forma eficaz, el flujo de trabajo recomendado incluye:
  1. Agregar secretos (este paso puede repetirse para varios secretos)
  2. Hacer referencia a los secretos por nombre al crear una compilación nueva
  3. Acceder a los secretos desde el servidor de juegos
  4. Actualizar los secretos según sea necesario

Agregar secretos

Los secretos pueden agregarse mediante la API UploadSecret. Esta API permite cargar un secreto nuevo en el servicio o actualizar un secreto existente con el parámetro ForceUpdate establecido en true.

Implementación de secretos

Para implementar secretos en máquinas virtuales recién creadas, incorpore el secreto en una compilación mediante el parámetro GameSecretReferences en las API CreateBuild (aplicable tanto a implementaciones basadas en contenedores como en procesos).
Una vez creada una compilación, no es posible agregarle secretos nuevos; sin embargo, la actualización de un secreto existente permitirá que su valor actualizado se use en las máquinas virtuales nuevas (las máquinas virtuales existentes conservarán los valores originales).
Este es un ejemplo de cómo hacer referencia a los secretos:

Acceso a los secretos

Una vez que los secretos se agregan y se hace referencia a ellos en compilaciones nuevas, los servidores de juego pueden acceder a estos valores secretos a través de variables de entorno dentro de cada servidor de juegos, ya sea basado en contenedores o en procesos. La convención de nomenclatura de las variables de entorno es:

Eliminación de secretos

Para quitar un secreto antiguo, utilice la API DeleteSecret. Asegúrese de que el secreto no se use en ninguna compilación antes de intentar eliminarlo; de lo contrario, la eliminación no se realizará correctamente.

Uso de secretos en scripts de inicio de máquina virtual

Los scripts de inicio de máquina virtual pueden utilizar los valores secretos haciendo referencia a las variables de entorno como se ha descrito. Esto permite, por ejemplo, usar claves de telemetría u otros valores necesarios antes de iniciar cualquier servidor de juegos.

Consulte también

Última modificación el 28 de agosto de 2026