Auth0.Android: Gestion des utilisateurs

Comment gérer les utilisateurs avec Auth0.Android

La Management API offre des fonctionnalités que vous pouvez utiliser pour gérer les utilisateurs de votre application, notamment les tâches suivantes :

• Lier des comptes d’utilisateur distincts provenant de différents fournisseurs afin de les associer à un seul profil. Pour en savoir plus, consultez Liaison de comptes d’utilisateur.
• Dissocier des comptes d’utilisateur pour en refaire des identités distinctes.
• Mettre à jour les métadonnées utilisateur. Pour en savoir plus, consultez Comprendre le fonctionnement des métadonnées dans les profils utilisateur.

Initialiser le UsersAPIClient

Pour commencer, créez une nouvelle instance de UsersAPIClient en lui passant le account et le jeton de l’identité principale. Dans le cas de la liaison d’utilisateurs, cette identité principale correspond au profil utilisateur dont vous souhaitez “conserver” les données et auquel vous prévoyez de lier d’autres identités.

Lier des utilisateurs

La liaison de comptes d’utilisateur permet à un utilisateur de s’authentifier avec n’importe lequel de ses comptes. Peu importe le compte utilisé pour s’authentifier, il se connecte au même profil. Sans liaison de comptes, Auth0 traite chaque compte différent comme un profil distinct.

La méthode link accepte deux paramètres : l’ID de l’utilisateur principal et le jeton de l’utilisateur secondaire (le jeton obtenu après la connexion avec cette identité). L’ID utilisateur en question est l’identifiant unique de ce compte d’utilisateur. Si l’ID est au format facebook|1234567890, l’ID requis correspond à la partie après la barre verticale de séparation.

client
    .link("primary user id", "secondary user token")
    .start(object: Callback<List<UserIdentity>, ManagementException>() {
        override fun onSuccess(payload: List<UserIdentity>) {
            // Identités mises à jour ! Comptes liés.
        }

        override fun onFailure(error: ManagementException) {
            // Erreur !
        }
    })

Dissocier des utilisateurs

La dissociation d’utilisateurs rétablit des profils distincts pour les comptes. La méthode unlink prend trois paramètres : l’ID utilisateur principal, l’ID utilisateur secondaire et le fournisseur secondaire (de l’utilisateur secondaire).

users
    .unlink("primary user id", "secondary user id", "secondary provider")
    .start(object: Callback<List<UserIdentity>, ManagementException>() {
        override fun onSuccess(payload: List<UserIdentity>) {
            // Identités mises à jour ! Comptes liés.
        }

        override fun onFailure(error: ManagementException) {
            // Erreur !
        }
    })

Lorsque des comptes sont liés, les métadonnées du compte secondaire ne sont pas fusionnées avec celles du compte principal. De même, lorsqu’on dissocie deux comptes, le compte secondaire ne conserve pas les métadonnées du compte principal.

Mise à jour des métadonnées de l’utilisateur

Lorsque vous mettez à jour les métadonnées de l’utilisateur, créez un objet metadata, puis appelez la méthode updateMetadata en lui passant l’ID de l’utilisateur et l’objet metadata. Les valeurs de cet objet remplacent les valeurs existantes associées à la même clé ou ajoutent de nouvelles valeurs pour les clés qui n’existent pas encore dans les métadonnées de l’utilisateur.

val metadata = mutableMapOf<String, Any?>()
metadata.put("name", listOf("My", "Name", "Is"));
metadata.put("phoneNumber", "1234567890");

users
    .updateMetadata("user id", metadata)
    .start(object: Callback<UserProfile, ManagementException>() {
        override fun onSuccess(payload: UserProfile) {
            // Métadonnées mises à jour
        }

        override fun onFailure(error: ManagementException) {
            // Erreur !
        }
    })