Passer au contenu principal
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. À partir de la page Secret Keys de Game Manager, vous pouvez créer, supprimer et désactiver vos clés, et définir leur expiration. Cela vous permet de permuter les clés secrètes de vos titres (ce qui était difficile à faire auparavant). Cela vous permet également d’accorder un accès temporaire à vos titres.
N’incluez jamais votre clé secrète de développeur dans une version client que vous distribuez à vos clients. Cela exposerait votre titre à des abus.
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 sélectionnez l’onglet Secret Keys.
La page Secret Keys offre des options pour supprimer (Delete) des clés et affiche le statut (Status) de chaque clé, ainsi que son nom (Name), sa valeur (Value) et son délai 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, à partir du tableau de bord. Pour afficher les options d’une clé, sélectionnez-la. Chaque titre commence avec une clé par défaut. Pour permuter vos clés :
  1. Sélectionnez New Secret Key.
  2. Entrez le nom (Name) de la clé et une date d’expiration facultative.
  3. Mettez à jour votre code pour utiliser la nouvelle clé.
  4. Désactivez l’ancienne clé. Sélectionnez l’ancienne clé, puis, dans la page Edit Secret Key, cochez la case Disable.
  5. Sélectionnez SAVE SECRET KEY.
Game Manager - Paramètres - Modifier la clé secrète
Si vos anciennes clés sont compromises, permutez les clés pour rétablir la sécurité de votre titre.
Ce processus s’effectue sans interruption de service, et vous pouvez annuler chaque étape en toute sécurité jusqu’à ce que vous supprimiez l’ancienne clé. En cas de problème à la première étape, vous pouvez supprimer votre nouvelle clé. Personne ne devrait l’utiliser. À la deuxième étape, les deux clés sont actives; vous pouvez donc faire avancer ou reculer votre code en toute sécurité. À la troisième étape, vous pouvez réactiver la clé pendant que vous corrigez 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 permanente 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 sous-traitant travaille sur votre jeu, vous pouvez lui donner des clés qui ne donnent accès que pendant la durée prévue de son besoin. S’il a besoin d’un accès au-delà de la date d’expiration prévue initialement, 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 à partir d’adresses IP autres que celles auxquelles vous faites confiance. Chaque clé secrète peut avoir 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 apportée à une clé, y compris les modifications de la liste d’autorisation, est consigné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 pour 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 plages CIDR, une par ligne (par exemple, 203.0.113.7 ou 2001:db8::/32).
  5. Sélectionnez Save.
Vérifiez soigneusement la liste avant de l’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.

​
Liste d’API autorisées

Les listes d’API autorisées limitent une clé secrète de titre à un ensemble précis d’API PlayFab. Les requêtes vers des API ne figurant pas dans la liste d’autorisation retournent une erreur HTTP 403 (NotAuthorized). Chaque modification apportée à une clé, y compris les modifications de la liste d’API autorisées, est consignée dans l’événement PlayStream existant de modification de clé secrète. Une clé secrète sans liste d’API autorisées demeure sans restriction. Les clés secrètes existantes ne sont pas touchées tant que vous n’activez pas et ne configurez pas une liste d’API autorisées.
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.
Autoriser GetEntityToken peut fournir un accès plus large que prévu. Le jeton d’entité retourné par cette API n’est pas limité par la liste d’API autorisées de la clé secrète de titre.
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, comme /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 clé 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.
Dernière modification le 6 octobre 2026

Sujets connexes

Demander des parties depuis vos services avec RequestPartyServiceDocumentation de la gestion des services en direct PlayFabInstaller le SDK PlayFab sans les Editor Extensions dans UnityDéployer des builds à l'aide de PowerShell/de l'APIProcédure pas à pas : déployer des builds à l'aide de PowerShell/de l'API