Skip to main content
Auth0.Android est une bibliothèque côté client que vous pouvez utiliser dans votre application Android pour authentifier les utilisateurs et accéder aux API Auth0. Consultez le dépôt Auth0.Android sur GitHub.

​
Exigences

Android API version 21 ou une version ultérieure est requise.

​
Installation

Ajoutez le SDK à votre projet. La bibliothèque enverra des requêtes aux API Authentication et Management d’Auth0.

​
Ajouter Auth0 à Gradle

Dans la section des dépendances du fichier build.gradle de votre application, ajoutez ce qui suit : 
dependencies {
  // Ajouter le SDK Auth0 Android
  implementation 'com.auth0.android:auth0:2.+'
}
Si Android Studio signale une erreur sur le signe +, ou si vous voulez utiliser une version fixe, consultez la plus récente dans Maven.

Synchroniser le projet avec Gradle

N’oubliez pas de synchroniser le projet à l’aide de l’invite d’Android Studio ou d’exécuter ./gradlew clean build à partir de la ligne de commande.
Dans la section android, ciblez le bytecode Java 8 pour les plugins Android et Kotlin, respectivement. 
android {
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
  kotlinOptions {
    jvmTarget = '1.8'
  }
}

​
Autorisations

Ouvrez le fichier AndroidManifest.xml de votre application et ajoutez l’autorisation suivante. 
<uses-permission android:name="android.permission.INTERNET" />

​
Configurer Universal Login

Tout d’abord, accédez à Auth0 Dashboard > Applications et cliquez sur le nom de l’application que vous souhaitez modifier. Dans Allowed Callback URLs, assurez-vous que votre URL respecte le format suivant : https://YOUR_DOMAIN/android/{YOUR_APP_PACKAGE_NAME}/callback Ensuite, remplacez {YOUR_APP_PACKAGE_NAME} par le nom de package réel de votre application. Vous le trouverez dans votre fichier app/build.gradle, comme valeur de applicationId. Puis, dans votre fichier app/build.gradle, ajoutez les espaces réservés du manifeste pour les propriétés Domaine Auth0 et Schéma Auth0, que la bibliothèque utilisera pour enregistrer un filtre d’intention qui intercepte l’URI de callback.
Si vous ne prévoyez pas utiliser la fonctionnalité Web Authentication et que vous ne déclarez pas les espaces réservés du manifeste, vous pouvez redéclarer manuellement l’activité dans le fichier manifeste de votre application Android afin de la retirer du fichier manifeste fusionné. Cela empêchera Gradle de signaler que les espaces réservés du manifeste sont manquants.Veuillez consulter la FAQ pour en savoir plus.
apply plugin: 'com.android.application'

android {
    compileSdkVersion 30
    defaultConfig {
        applicationId "com.auth0.samples"
        minSdkVersion 21
        targetSdkVersion 30
        //...

        //---> Ajouter la ligne suivante
        manifestPlaceholders = [auth0Domain: "@string/com_auth0_domain", auth0Scheme: "https"]
        //<---
    }
    //...
}
Il est recommandé de définir des ressources réutilisables comme @string/com_auth0_domain au lieu de les coder en dur.

​
Initialiser Auth0

Créez un nouvel objet Auth0 à l’aide de votre Auth0 et de votre domaine. Cet objet sera ensuite utilisé pour interagir avec les points de terminaison d’Auth0. 
val auth0 = Auth0("{yourClientId}", "YOUR_DOMAIN")
Vous pouvez aussi initialiser cet objet à l’aide d’un objet Context d’Android, comme illustré dans cet exemple d’utilisation.

​
Prochaines étapes

Permettez aux utilisateurs d’ouvrir et de fermer une session dans votre application à l’aide de la classe WebAuthProvider.

​
Réinitialiser le mot de passe d’un utilisateur

Pour lancer une réinitialisation du mot de passe pour un utilisateur, appelez resetPassword en fournissant l’adresse courriel de l’utilisateur et le nom de la connexion de base de données comme paramètres. Les demandes de réinitialisation du mot de passe échouent en cas d’erreurs liées au réseau, mais elles n’échouent pas si le courriel indiqué n’existe pas dans la base de données (pour des raisons de sécurité).

​
En savoir plus