Limited Login pour Unity

Avec la version 9.0 du SDK iOS, le SDK Unity a été mis à jour pour permettre aux équipes de développement iOS de proposer Limited Login à leurs utilisateurs et utilisatrices. En résumé, cette mise à jour ajoute un token d’authentification permettant de vérifier l’identité d’un·e utilisateur·ice lors de sa connexion, en plus des autres fonctionnalités de l’API Graph disponibles avec le produit Facebook Login standard.

Autorisations

Limited Login vous permet de demander un ensemble limité d’autorisations :

  • public_profile
  • email
  • gaming_profile
  • gaming_user_picture
  • user_age_range
  • user_birthday
  • user_friends
  • user_gender
  • user_hometown
  • user_link
  • user_location
  • user_messenger_contact

Implémenter Limited Login

Pour profiter de Limited Login avec le SDK Unity, utilisez la fonction LoginWithTrackingPreference afin de spécifier que la préférence LoginTracking est LIMITED pour une demande de connexion donnée. Les équipes de développement·ses peuvent également inclure un nonce facultatif destiné à vérifier la réponse du SDK Unity. Pour plus d’informations sur la validation du token OIDC, voir la page Validation du token Limited Login OIDC.

FB.Mobile.LoginWithTrackingPreference(LoginTracking.LIMITED, scopes, "nonce123", this.HandleResult);

Récupération des données du profil

Une fois le processus de connexion terminé pour la connexion Limited Login ou Facebook Login standard, les équipes de développement ont désormais la possibilité de récupérer un AuthenticationToken depuis le SDK Unity. Pour récupérer les informations de base du profil de l’utilisateur·ice, les développeur·ses peuvent demander l’objet Profile à l’aide de la fonction CurrentProfile, qui permet de lire le AuthenticationToken associé.

private void GetProfileInfo()
{
     var profile = FB.Mobile.CurrentProfile();
     if(profile != null) {
          this.userName = profile.Name;
          this.userId = profile.UserID
          this.userEmail = profile.Email;
          this.profileImageUrl = profile.ImageURL;
          this.userBirthday = profile.Birthday;
          this.userAgeRange = profile.AgeRange;
          this.userFriendIDs = profile.FriendIDs;
          this.userGender = profile.Gender;
          this.userLink = profile.LinkURL;
          this.userHometown = profile.Hometown;
          this.userLocation = profile.Location;
     }
}

Notez que Limited Login et la classe « Profile » ne sont actuellement disponibles que pour le SDK iOS. Pour le moment, ils ne le sont pas pour les autres plateformes.

Référence

Principal

Nom Description

LoginTracking

Valeur Enum indiquant si le suivi doit être activé pour la demande de connexion. Les valeurs disponibles sont ENABLED et LIMITED.

AuthenticationToken

Classe d’assistance contenant la chaîne de token d’authentification accordée à votre application par l’utilisateur·ice actuel·le. Ce token inclut les données relatives à l’identifiant, au nom, à la photo de profil et à l’adresse e-mail de l’utilisateur·ice (s’il ou elle a donné son accord).

Profile

Classe d’assistance utilisée pour récupérer les informations de base du profil à partir du AuthenticationToken de l’utilisateur·ice actuel·le.

Méthodes

Nom Description

FB.Mobile.LoginWithTrackingPreference

Invite un utilisateur ou une utilisatrice à autoriser votre application avec les autorisations requises en fonction des préférences de suivi sélectionnées.

FB.Mobile.CurrentAuthenticationToken

Renvoie le token d’authentification accordé à votre application par l’utilisateur·ice actuel·le.

FB.Mobile.CurrentProfile

Renvoie les informations de base du profil accordées à votre application par l’utilisateur·ice actuel·le.

FB.Mobile.LoginWithTrackingPreference

Paramètres :

  1. LoginTracking : valeur Enum à choisir entre ENABLED et LIMITED
  2. Scopes : Permissions pour cette requête
  3. Nonce : chaîne facultative utilisée pour vérifier la réponse
  4. Gestionnaire de résultat (IResult) : fonction de rappel qui traitera la réponse de connexion

Résultat : gère les demandes de connexion utilisateur et la session utilisateur

FB.Mobile.CurrentAuthenticationToken

Paramètres : aucun

Résultat : renvoie un « AuthenticationToken » contenant les informations de base du profil de l’utilisateur·ice, y compris l’identifiant, le nom, la photo de profil et l’adresse e-mail de l’utilisateur·ice (s’il ou elle a donné son accord).

FB.Mobile.CurrentProfile

Paramètres : aucun

Résultat : renvoie un objet « Profile » contenant les informations de base du profil de l’utilisateur·ice. Ces informations sont automatiquement récupérées via le token d’authentification de l’utilisateur·ice.

Valider le token OIDC

Avant d’utiliser le token OIDC côté serveur, validez-le avec les clés publiques de Facebook, en vous assurant que le nonce correspond au nonce que vous avez fourni.