Passer au contenu principal
PlayFab vous permet de renforcer la sécurité de votre application en protégeant certains appels d’API client à l’aide d’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. Puisque le processus est toujours semblable, nous montrons seulement comment protéger une méthode en particulier, LoginWithCustomID.
Le chiffrement des connexions est destiné à être utilisé pour tous les joueurs dès la création du titre, ou pas du tout. Il ne s’agit pas d’une fonctionnalité que vous pouvez activer plus tard. Vous devez l’utiliser dès le tout début ou pas du tout. En particulier, les joueurs chiffrés ne pourront jamais se connecter de façon non chiffrée, 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é par les joueurs.
  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 qu’il utilise une clé partagée par les joueurs 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 façon sécuritaire 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é par les joueurs

L’API Admin de PlayFab expose une méthode permettant de gérer vos secrets partagés par les joueurs.
La création d’un nouveau secret partagé sous un certain nom remplace la clé existante portant le même nom, le cas échéant. De plus, vous pouvez avoir plusieurs secrets partagés enregistrés sous des noms différents.
Exécutez le code suivant pour ajouter un secret partagé par les joueurs à 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 devrait afficher un secret partagé par les joueurs nouvellement créé. Assurez-vous de l’enregistrer. Si vous le perdez, vous devrez générer un nouveau secret en exécutant l’application de nouveau. 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, ce code connecterait l’utilisateur sans problème. Cependant, cet appel d’API est maintenant protégé, et le code générera une erreur Not Authorized (à ne pas confondre avec Not Authenticated). Nous devons modifier le client pour qu’il chiffre correctement la charge utile de l’appel. Cela se fait en 2 étapes :
  1. Utiliser le secret partagé par les joueurs 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é par les joueurs est créé, il doit être codé en dur dans le code de votre client, car il n’existe aucun moyen de le récupérer ou de le demander au moyen d’un appel d’API.
Dernière modification le 6 octobre 2026