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

# Gestion des clés secrètes

> Créez, faites pivoter, désactivez et faites expirer les clés secrètes de développeur PlayFab dans Game Manager pour sécuriser les appels aux API Admin et Server et accorder un accès temporaire au titre.

Les clés secrètes de développeur PlayFab permettent à votre titre d'effectuer des appels aux API Admin et Server de PlayFab. Une clé secrète, également appelée clé de développeur, est associée à un titre PlayFab.

La page **Secret Keys** de **Game Manager** vous permet de créer, supprimer et désactiver vos clés, ainsi que de définir leur expiration. Vous pouvez ainsi faire pivoter les clés secrètes de vos titres (ce qui était difficile auparavant). Cela vous permet également d'accorder un accès temporaire à vos titres.

<Note>
  N'incluez jamais votre clé secrète de développeur dans une build client que vous distribuez à vos clients. Cela exposerait votre titre à des abus.
</Note>

Pour gérer les clés secrètes de votre titre :

1. Connectez-vous à **Game Manager**.
2. Sélectionnez votre titre.
3. Dans le coin supérieur droit, sélectionnez l'icône d'engrenage.
4. Sélectionnez **Title settings**, puis l'onglet **Secret Keys**.

La page **Secret Keys** propose des options pour **supprimer** (**Delete**) des clés, afficher le **statut** (**Status**) de chaque clé, ainsi que son **nom** (**Name**), sa **valeur** (**Value**) et sa date d'**expiration** (**Expiration**), le cas échéant. Ce tableau vous permet d'auditer les clés disponibles.

Vous pouvez renommer, activer ou désactiver des clés existantes, ou définir leur expiration, depuis le tableau de bord. Pour afficher les options d'une clé, sélectionnez-la. Chaque titre commence avec une clé par défaut.

Pour faire pivoter vos clés :

1. Sélectionnez **New Secret Key**.
2. Saisissez le **nom** (**Name**) de la clé et, éventuellement, une date d'expiration.
3. Mettez à jour votre code pour utiliser la nouvelle clé.
4. Désactivez l'ancienne clé. Sélectionnez l'ancienne clé, puis, sur la page **Edit Secret Key**, cochez la case **Disable**.
5. Sélectionnez **SAVE SECRET KEY**.

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/gamemanager/tutorials/game-manager-settings-edit-secret-key.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=315ad34a88e817754d4aae20163f5bcb" alt="Game Manager - Paramètres - Modifier la clé secrète" width="1366" height="892" data-path="images/playfab/live-service-management/gamemanager/tutorials/game-manager-settings-edit-secret-key.png" />

<Info>
  Si vos anciennes clés sont compromises, faites pivoter les clés pour remettre votre titre dans un état sécurisé.
</Info>

Ce processus s'effectue sans interruption de service, et vous pouvez annuler chaque étape en toute sécurité jusqu'à la suppression de l'ancienne clé. En cas de problème à la première étape, vous pouvez supprimer votre nouvelle clé. Personne ne devrait encore l'utiliser.

À la deuxième étape, les deux clés sont actives : vous pouvez donc faire avancer ou revenir en arrière votre code en toute sécurité.

À la troisième étape, vous pouvez réactiver la clé le temps de corriger ce qui en dépendait encore.

Une fois le processus terminé, vous n'avez pas besoin de supprimer l'ancienne clé. Si vous supprimez cette clé, elle ne peut pas être récupérée. La suppression est définitive et irrévocable.

Définir l'expiration d'une clé est utile lorsque vous devez accorder à quelqu'un un accès temporaire à votre titre.

Par exemple, si un prestataire travaille sur votre jeu, vous pouvez lui fournir des clés qui ne donnent accès que pendant la durée prévue de sa mission. S'il a besoin d'un accès au-delà de la date d'expiration initialement prévue, vous pouvez redéfinir la date d'expiration pour prolonger la durée de vie de la clé secrète.

## Liste d'adresses IP autorisées

Les listes d'adresses IP autorisées pour les clés secrètes de titre sont une fonctionnalité de sécurité qui garantit qu'une clé secrète de titre ne peut pas être utilisée en dehors des adresses IP de confiance. Chaque clé secrète peut disposer de sa propre liste d'adresses IPv4 ou IPv6 (ou de plages CIDR) autorisées à l'utiliser.

Lorsqu'une liste d'adresses IP autorisées est configurée pour une clé secrète de titre, les appels privilégiés (API Server et Admin) effectués avec cette clé ne sont acceptés que s'ils proviennent d'adresses IP sources correspondant à une entrée de la liste. Les appels provenant de toute autre adresse IP sont rejetés, même si la clé elle-même est par ailleurs valide. Chaque modification d'une clé, y compris les modifications de la liste d'adresses autorisées, est enregistrée dans l'événement PlayStream existant de modification de clé secrète.

**Formats pris en charge :**

* Les adresses IPv4 et IPv6 sont toutes deux prises en charge (par exemple, `203.0.113.7` ou `2001:db8::1`).
* Les plages CIDR sont prises en charge dans les deux familles (par exemple, `203.0.113.0/24` ou `2001:db8::/32`).

**Comment configurer une liste d'adresses IP autorisées pour votre clé secrète de titre :**

1. Dans **Game Manager**, accédez à **Title Settings** > **Secret Keys**.
2. Modifiez (ou créez) une clé secrète.
3. Activez **Enable IP allowlist**.
4. Ajoutez vos adresses IP de sortie ou vos plages CIDR, une par ligne (par exemple, `203.0.113.7` ou `2001:db8::/32`).
5. Sélectionnez **Save**.

<Info>
  Vérifiez attentivement la liste avant d'enregistrer. Une entrée incorrecte bloque toutes les adresses IP qui ne figurent pas dans la liste, ce qui peut empêcher vos services d'accéder aux API Server et Admin.
</Info>

## Liste d'API autorisées

Les listes d'API autorisées limitent une clé secrète de titre à un ensemble spécifique d'API PlayFab. Les requêtes adressées à des API ne figurant pas dans la liste renvoient une erreur HTTP 403 (`NotAuthorized`). Chaque modification d'une clé, y compris les modifications de la liste d'API autorisées, est enregistrée dans l'événement PlayStream existant de modification de clé secrète.

Une clé secrète sans liste d'API autorisées reste sans restriction. Les clés secrètes existantes ne sont pas affectées tant que vous n'activez et ne configurez pas de liste d'API autorisées.

<Info>
  Sélectionner toutes les API crée un instantané des API disponibles à ce moment-là. Il ne s'agit pas d'un caractère générique, et les API ajoutées ultérieurement ne sont pas automatiquement autorisées. Pour qu'une clé reste sans restriction pour les API actuelles et futures, n'activez pas de liste d'API autorisées.
</Info>

<Warning>
  Autoriser `GetEntityToken` peut fournir un accès plus large que prévu. Le jeton d'entité renvoyé par cette API n'est pas limité par la liste d'API autorisées de la clé secrète de titre.
</Warning>

Pour configurer une liste d'API autorisées :

1. Dans **Game Manager**, accédez à **Title Settings** > **Secret Keys**.
2. Modifiez ou créez une clé secrète.
3. Activez **Enable API allowlist**.
4. Utilisez **Search APIs** pour rechercher et sélectionner chaque API requise, par exemple `/Server/GetUserData`.
5. Sélectionnez **Save**, puis confirmez la modification.

Les modifications de la liste d'API autorisées ne sont pas immédiates. Elles prennent effet à mesure que les caches existants des clés secrètes expirent. Pour révoquer tout accès pour la clé, désactivez-la plutôt que de vous fier à une modification de la liste d'API autorisées.

Pour supprimer une restriction d'API :

1. Modifiez la clé secrète.
2. Désactivez **Enable API allowlist**.
3. Sélectionnez **Save**, puis confirmez la modification.

La clé secrète est alors sans restriction pour les API actuelles et futures.


## Related topics

- [XR015 Gestion des communications des joueurs](/fr-CA/publishing/certification/fma/xr-015.md)
- [XR-015 Gestion des communications des joueurs](/fr-CA/publishing/certification/xr/xr-015.md)
- [XR-015 Gestion des communications entre joueurs](/fr/publishing/certification/xr/xr-015.md)
- [XR014 Données des joueurs et renseignements personnels](/fr-CA/publishing/certification/fma/xr-014.md)
- [XR014 Données des joueurs et informations personnelles](/fr/publishing/certification/fma/xr-014.md)
