Passer au contenu principal
Les fonctionnalités d’API de PlayFab Game Manager sont un ensemble d’options permettant de gérer le comportement des API PlayFab pour votre titre. Ces options vous donnent les outils nécessaires pour gérer l’accès, la confidentialité et d’autres fonctionnalités. Pour accéder à l’écran de configuration de ces options :
  • Accédez à Game Manager.
  • Sélectionnez Settings dans le menu de gauche.
  • Sélectionnez l’onglet API Features.
Game Manager : paramètres, fonctionnalités d'API Certaines de ces cases à cocher sont évidentes, d’autres moins. Dans ce tutoriel, nous allons en détailler plusieurs.
Plusieurs captures d’écran et démonstrations de ce tutoriel utilisent Postman.

​
Exiger un JSON valide pour les valeurs de données personnalisées

Les clients piratés peuvent causer de graves problèmes aux jeux. Les appelants d’API malveillants qui publient des données mal formatées peuvent générer du bruit, des bogues et des problèmes pour les développeurs. Les joueurs dont les données sont mal formatées nécessitent souvent une intervention manuelle pour les nettoyer. Exiger un JSON valide pour les valeurs de données personnalisées permet d’effectuer une validation de base du type de contenu avant l’enregistrement des données dans la base de données. Détecter ces problèmes tôt évite qu’ils ne perdurent et empêche les pirates d’interférer avec le développement normal. Lorsque cet indicateur est défini, les clients sont tenus de transmettre un JSON valide pour chaque clé de leurs données personnalisées. Une simple validation JSON ne suffit pas à éviter tous les problèmes, mais elle peut aider à éliminer certains comportements indésirables. Si vous cochez cette option, chaque clé enregistrée dans l’ensemble des données personnalisées, y compris les données de joueur, d’éditeur, de personnage, de titre et d’article, doit être un JSON valide.
Cet indicateur peut être activé ou désactivé à tout moment. Mais il n’est pas rétroactif : les valeurs existantes ne sont pas affectées. Seules les valeurs nouvellement écrites sont validées.
Si vous tentez de transmettre un JSON non valide comme valeur, la requête est rejetée avec un HTTP Status Code 400 "Bad Request". Postman : envoi d'un JSON non valide

​
Désactivation de tout accès aux requêtes d’API

Aussi surprenant que cela puisse paraître, il peut être utile de désactiver tout accès aux API de vos titres. Si, par exemple, vous effectuez une migration sensible avec interruption de service, des requêtes d’API intempestives pourraient provoquer de graves interruptions. Si vous retirez votre jeu, cela vous garantit qu’il est réellement désactivé.
N’oubliez pas que cocher cette case cassera littéralement votre jeu : utilisez-la avec prudence!
Une fois que vous avez décidé de désactiver l’accès aux API et que vous avez coché la case, toutes les requêtes d’API commencent à échouer en quelques minutes. PlayFab retourne un HTTP Status Code 400 "Bad Request", indiquant que le titre a désactivé cette utilisation. Postman : accès à une API désactivée Ces réponses HTTP Status Code 400 persistent jusqu’à ce que vous décochiez la case. Là encore, la prise en compte de la désactivation peut prendre quelques minutes.

​
Activation de l’obfuscation des adresses IP des joueurs

Pour de nombreux studios, détenir des informations d’identification personnelle (PII) est une responsabilité qu’il vaut mieux éviter. L’adresse IP est une forme courante (et utile) de PII. L’adresse IP est utile pour plusieurs raisons, notamment la géolocalisation. Toutefois, l’adresse IP complète est souvent considérée comme une PII. PlayFab peut vous aider à limiter ce risque en masquant une partie des adresses IP. Désormais, en cochant une case, vous pouvez cesser de collecter ces données sensibles. Une fois cette case cochée, PlayFab enregistre toujours 0 pour le dernier octet de l’adresse IP d’un joueur. Vous pouvez vérifier que cela fonctionne en consultant l’historique de connexion des joueurs dans l’onglet Players. Vous devriez constater que toutes les adresses IP se terminent par .0. Les adresses IP enregistrées avant l’activation de l’obfuscation conservent tous leurs détails. Si votre jeu est sensible aux PII, cochez donc cette case avant le lancement.
L’activation de l’obfuscation affecte d’autres fonctionnalités qui utilisent les adresses IP. Les trois plus directement concernées sont la géolocalisation basée sur l’IP, les bannissements d’IP et les bannissements de joueurs spécifiant une adresse IP.
PlayFab effectue automatiquement une géolocalisation basée sur l’IP lors des connexions. Cela vous aide à déterminer automatiquement d’où viennent vos joueurs dans le monde. Toutefois, la précision peut être réduite, en particulier au niveau de la ville, lors de l’utilisation d’adresses IP masquées. C’est intentionnel, car l’objectif de l’obfuscation des adresses IP est d’éviter d’enregistrer des PII, y compris des localisations exactes. En outre, l’obfuscation des adresses IP peut affecter les bannissements d’IP. Il est souvent plus pratique de bannir une adresse IP que de bannir un compte à la fois, car l’acteur malveillant peut simplement créer de nouveaux comptes. Bannir une adresse IP empêche l’acteur malveillant de créer de nouveaux comptes depuis la même connexion Internet. Dans de nombreux cas, c’est un outil efficace. Toutefois, avec des adresses IP masquées, le bannissement d’une adresse IP exacte ne peut pas fonctionner. Vous devez plutôt bannir une adresse IP dont le dernier octet est .0. N’oubliez pas que cela revient à bannir une plage d’adresses IP entière. Game Manager : bannissements d'IP, ajouter un bannissement Pour rendre la portée explicite, entrez la plage CIDR équivalente au lieu de vous fier à une adresse masquée se terminant par .0, comme illustré ci-dessous. Les deux bannissements sont fonctionnellement équivalents. Game Manager : bannissements d'IP, bannissement de plage Cela bannira toujours l’acteur malveillant, mais d’autres joueurs innocents ayant des adresses IP similaires peuvent être affectés. En outre, les bannissements existants portant sur des adresses IP précises non masquées ne seront plus effectifs.
Dernière modification le 8 octobre 2026

Sujets connexes

Notes de publication PlayFab 2017Exemple Windows RunnerRéférence de Game ManagerDocumentation de la gestion des services en direct PlayFabUtilisation des statistiques et des classements réinitialisables