Options de configuration d’Auth0.Android

Comment configurer Auth0.Android pour répondre aux besoins de votre application

Auth0.Android peut être configuré à l’aide de diverses options, présentées ci-dessous.

Les options ci-dessous diffèrent de celles de la version V1 précédente. Consultez le guide de migration pour en savoir plus.

withConnection

L’option withConnection vous permet de spécifier la connexion avec laquelle vous souhaitez vous authentifier.

WebAuthProvider.login(account)
                .withConnection("twitter")
                .start(this, callback)

withScope

L’utilisation de scopes vous permet de renvoyer des claims précis pour des champs particuliers dans votre requête. L’ajout de paramètres à withScope vous permet d’ajouter d’autres scopes. Consultez Scopes pour en savoir plus.

WebAuthProvider.login(account)
                .withScope("openid profile email")
                .start(this, callback)

Le scope par défaut est openid profile email.

withConnectionScope

Il peut arriver que vous deviez vous authentifier avec des scopes de connexion spécifiques, c’est-à-dire des autorisations propres au fournisseur d’authentification concerné. Consultez Ajouter des scopes pour un IdP externe. Toutefois, si vous avez besoin d’un accès précis dans un contexte particulier de votre application, vous pouvez transmettre des paramètres à withConnectionScope. Vous trouverez la liste complète des paramètres disponibles dans les paramètres de cette connexion dans le Dashboard ou dans la documentation du fournisseur d’authentification. Le scope demandé ici s’ajoute à ceux déjà indiqués dans les paramètres de la connexion dans le Dashboard.

WebAuthProvider.login(account)
                .withConnectionScope("email", "profile", "calendar:read")
                .start(this, callback)

withParameters

Pour envoyer des paramètres supplémentaires dans la requête d’authentification, utilisez withParameters.

val parameters = mapOf("param1" to "value1")

WebAuthProvider.login(account)
                .withParameters(parameters)
                .start(this, callback)

withHeaders

Pour envoyer des en-têtes personnalisés au point de terminaison d’autorisation, utilisez withHeaders.

val headers = mapOf("header1" to "value1")

WebAuthProvider.login(account)
                .withHeaders(headers)
                .start(this, callback)

withScheme

Si vous n’utilisez pas les “App Links” d’Android ou si vous souhaitez utiliser un schéma différent pour l’URI de redirection, utilisez withScheme. Mettez à jour le paramètre fictif du manifeste auth0Scheme dans le fichier app/build.gradle ainsi que la liste d’autorisations Allowed Callback URLs dans le Dashboard, sous les paramètres de l’application, pour qu’ils correspondent au schéma choisi.

WebAuthProvider.login(account)
                .withScheme("myapp")
                .start(this, callback)

Le schéma doit être en minuscules et ne peut pas contenir de traits de soulignement.

withAudience

Pour spécifier une audience, utilisez withAudience.

WebAuthProvider.login(account)
                .withAudience("https://YOUR_DOMAIN/userinfo")
                .start(this, callback)