> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gérer les secrets (préversion)

> Ce document fournit des informations sur la fonctionnalité de gestion des secrets, qui permet aux clients de déployer des secrets dans les serveurs de jeu de façon sécurisée.

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](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/upload-secret).
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).

<Note>
  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).
</Note>

Voici un exemple de référencement des secrets :

```csharp theme={null}
var request = new CreateBuildWithCustomContainerRequest()
{
    ContainerImageReference = new ContainerImageReference()
    {
        ImageName = "testimagename",
        Tag = "0.1"
    },
    ContainerFlavor = ContainerFlavor.CustomLinux,
    BuildName = "testbuildwithvmstartupscript",
    VmSize = AzureVmSize.Standard_D2as_v4,
    MultiplayerServerCountPerVm = 3,
    Ports = new List<Port>
    {
        new Port()
        {
            Name = "port",
            Num = 123,
            Protocol = ProtocolType.TCP
        }
    },
    RegionConfigurations = new List<BuildRegionParams>
    {
        new BuildRegionParams()
        {
            Region = "EastUs",
            StandbyServers = 3,
            MaxServers = 6
        }
    },
    GameSecretReferences = new[]
    {
        new GameSecretReferenceParams
        {
            Name = "SecretName"
        }
    }
};
var result = await PlayFabMultiplayerAPI.CreateBuildWithCustomContainerAsync(request);
```

### 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 :

```shell theme={null}
PF_MPS_SECRET_<Secret Name>
```

### Suppression de secrets

Pour supprimer un ancien secret, utilisez l'API [DeleteSecret](https://learn.microsoft.com/en-us/rest/api/playfab/multiplayer/multiplayer-server/delete-secret).

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

* [Déployer des builds à l'aide de PowerShell/de l'API](/fr-CA/services/playfab/multiplayer/servers/deploy-using-powershell-api)
* [Exécution d'un script personnalisé lors de la création d'une machine virtuelle - VmStartupScript (préversion)](/fr-CA/services/playfab/multiplayer/servers/vmstartupscript)


## Related topics

- [Utiliser Playtest pendant la préversion](/fr-CA/publishing/game-publishing/concepts/playtest-preview.md)
- [Démarrage rapide du partitionnement d'événements (préversion)](/fr-CA/services/playfab/data-analytics/export-data/event-partitioning-quickstart.md)
- [Gérer les erreurs PlayFab](/fr-CA/services/playfab/sdks/c/errors.md)
- [Segmentation avancée avec les propriétés personnalisées de joueur](/fr-CA/services/playfab/live-service-management/game-configuration/segmentation/advanced-segmentation.md)
- [Tutoriel de comptage des joueurs d'un segment](/fr-CA/services/playfab/live-service-management/game-configuration/segmentation/segmentation-player-count.md)