> ## 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.
# Paramètres des fonctionnalités d'API dans PlayFab Game Manager
> Configurez les paramètres des fonctionnalités d'API dans PlayFab Game Manager, notamment la validation JSON des données personnalisées, les options de confidentialité et d'autres comportements d'API à l'échelle du titre.
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**.
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](/fr-CA/services/playfab/sdks/postman/postman-quickstart).
## 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"`.
## 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.
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](/fr-CA/services/playfab/player-progression/player-data/ip-bans). 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*.
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.
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.
## Related topics
- [Exemple Windows Runner](/fr-CA/services/playfab/multiplayer/servers/windows-runner-sample.md)
- [Notes de publication PlayFab 2017](/fr-CA/services/playfab/release-notes/2017.md)
- [Référence de Game Manager](/fr-CA/services/playfab/live-service-management/gamemanager/reference.md)
- [Documentation de la gestion des services en direct PlayFab](/fr-CA/services/playfab/live-service-management/index.md)
- [Utilisation des statistiques et des classements réinitialisables](/fr-CA/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards.md)