Gestion des clés secrètes

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

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.

​

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