Passer au contenu principal
PlayFab vous permet de renforcer la sécurité de votre application en protégeant certains appels d’API client avec un chiffrement personnalisé. Ce tutoriel vous montre comment activer le chiffrement pour votre client. La méthode que nous allons utiliser vous permet de protéger n’importe quel appel d’API de connexion. Comme le processus est toujours similaire, nous montrons uniquement comment protéger une méthode particulière, LoginWithCustomID.
Le chiffrement des connexions est destiné à être utilisé pour tous les joueurs après la création du titre, ou pas du tout. Ce n’est pas une fonctionnalité qui peut être activée ultérieurement. Vous devez l’utiliser dès le début ou pas du tout. En particulier, les joueurs chiffrés ne pourront jamais se connecter sans chiffrement, et les joueurs non chiffrés ne pourront jamais devenir des joueurs chiffrés.
Dans ce guide, nous allons :
  1. Créer un secret partagé de joueur.
  2. Introduire une règle de stratégie d’API pour activer la protection sur une méthode donnée.
  3. Modifier le client pour utiliser une clé partagée de joueur afin de récupérer la clé publique du titre et de chiffrer la charge utile.
PlayFab émet l’avertissement suivant : « Tous nos appels d’API sont déjà chiffrés de manière sécurisée selon les normes modernes, et le chiffrement standard des appels d’API est tout ce dont la plupart des clients auront besoin. Cette fonctionnalité représente une couche de sécurité supplémentaire conçue pour rendre plus difficile l’utilisation d’un client non autorisé par les joueurs. Elle n’est pas infaillible : elle ne fait qu’augmenter le niveau de difficulté pour les pirates. Pour la plupart des développeurs, ce léger gain de sécurité ne vaudra pas l’effort supplémentaire requis. »

Création d’un secret partagé de joueur

L’API Admin de PlayFab expose une méthode permettant de gérer vos secrets partagés de joueur.
La création d’un nouveau secret partagé portant un certain nom remplace la clé existante portant le même nom, le cas échéant. En outre, vous pouvez avoir plusieurs secrets partagés enregistrés sous des noms différents.
Exécutez le code suivant pour ajouter un secret partagé de joueur à votre titre.
Pour exécuter ce code, vous avez besoin d’une clé secrète de développeur. Pour plus d’informations sur les clés secrètes, consultez Gestion des clés secrètes. Cette application doit afficher un secret partagé de joueur nouvellement créé. Veillez à l’enregistrer. S’il est perdu, vous devrez générer un nouveau secret en exécutant à nouveau l’application. Le secret ressemble à ceci : QC953WQ3TU6ZJTZMAT1FNJQIKR92FPUQTISW4Q6WD8SY841MQQ

Mise à jour de la stratégie

Nous avons créé un nouveau secret partagé. Nous devons maintenant indiquer à PlayFab quels appels d’API protéger. Exécutez le code ci-dessous pour protéger l’appel d’API LoginWithCustomId et retirer la protection des autres appels d’API.

Configuration du client

Maintenant que la stratégie est mise à jour, vous ne pouvez plus simplement appeler l’API LoginWithCustomID. Examinez le code ci-dessous.
Normalement, cela connecterait l’utilisateur sans problème. Cependant, cet appel d’API est désormais protégé, et le code renverra une erreur Not Authorized (à ne pas confondre avec Not Authenticated). Nous devons modifier le client pour chiffrer correctement la charge utile de l’appel. Cela se fait en 2 étapes :
  1. Utiliser le secret partagé de joueur pour récupérer la clé publique du titre.
  2. Utiliser la clé publique du titre pour chiffrer la charge utile.
Le code ci-dessous illustre ce processus.
Une fois le code exécuté, vous devriez pouvoir vous connecter. N’oubliez pas qu’une fois qu’un secret partagé de joueur est créé, il doit être codé en dur dans votre code client, car il n’existe aucun moyen de le récupérer ou de le demander à l’aide d’un appel d’API.
Dernière modification le 6 octobre 2026