Options de configuration pour Auth0.Android

Comment configurer Auth0.Android selon les besoins de votre application

Auth0.Android peut être configuré au moyen de plusieurs options, présentées ci-dessous.

Les options ci-dessous ont changé depuis la version V1 antérieure. Veuillez consulter le guide de migration pour en savoir plus.

withConnection

L’option withConnection vous permet de préciser la connexion avec laquelle vous souhaitez vous authentifier.

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

withScope

L’utilisation de scope vous permet de renvoyer des revendications précises pour certains champs de votre requête. L’ajout de paramètres à withScope vous permet d’ajouter davantage de scope. Consultez Portées pour plus de détails.

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 particuliers, ou des permissions, auprès du fournisseur d’authentification en question. Consultez Ajout de scopes pour un IdP externe. Toutefois, si vous avez besoin d’un accès précis dans une situation particulière 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 précisé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 lors de l’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 à l’endpoint 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 le Redirect URI, utilisez withScheme. Mettez à jour l’espace réservé auth0Scheme du Manifest dans le fichier app/build.gradle, ainsi que l’AllowList Allowed Callback URLs dans le Dashboard, sous les Settings de l’Application, afin qu’ils correspondent au schéma choisi.

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

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

withAudience

Pour fournir une audience, utilisez withAudience.

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