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

​
Exigences

L’API Android version 21 ou plus récente est requise.

​
Installation

Ajoutez la trousse SDK à votre projet. La bibliothèque adressera des demandes aux Authentication et d’Auth0.

​
Ajouter Auth0 à Gradle

In your app’s build.gradle dependencies section, add the following: 
dependencies {
  // Add the Auth0 Android SDK
  implementation 'com.auth0.android:auth0:2.+'
}
Si Android Studio signale une erreur sur le signe +, ou si vous souhaitez utiliser une version fixe, vérifiez la dernière version sur Maven ou JCenter.

Synchroniser le projet avec Gradle

Souvenez-vous de synchroniser en utilisant l’invite d’Android Studio ou en exécutant ./gradlew clean build à partir de la ligne de commande. Pour en savoir plus à propos de l’utilisation de Gradle, consultez leur documentation officielle.
Dans la section android, ciblez le code Java 8+ pour les plugiciels Android et Kotlin respectivement. 
android {
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
  kotlinOptions {
    jvmTarget = '1.8'
  }
}

​
Autorisations

Open your application’s AndroidManifest.xml file and add the following permission. 
<uses-permission android:name="android.permission.INTERNET" />

​
Configurer pour la connexion universelle

Accédez d’abord à Dashboard > Applications et cliquez sur le nom de l’application à modifier. Dans le champ URL de rappel autorisées, assurez-vous que votre URL suit ce format : https://YOUR_DOMAIN/android/{YOUR_APP_PACKAGE_NAME}/callback Next, replace {YOUR_APP_PACKAGE_NAME} with your actual application’s package name. You can find this in your app/build.gradle file as the applicationId value. Ensuite, dans le fichier app/build.gradle de votre application, ajoutez les paramètres fictifs manifestes pour les propriétés Auth0 Domain et Auth0 Scheme. La bibliothèque les utilisera pour enregistrer un élément intent-filter qui capture l’URI de rappel.
Si vous n’avez pas l’intention d’utiliser la fonctionnalité d’ authentification Web  et de ne pas déclarer les espaces réservés dans le manifeste, vous pouvez redéclarer manuellement l’activité dans le fichier manifeste de votre application Android afin de la supprimer du fichier manifeste fusionné. Cela empêchera Gradle de signaler l’absence d’espaces réservés dans le manifeste.Veuillez lire la FAQ pour plus d’informations.
apply plugin: 'com.android.application'

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

        //---> Add the next line
        manifestPlaceholders = [auth0Domain: "@string/com_auth0_domain", auth0Scheme: "https"]
        //<---
    }
    //...
}
Nous recommandons de définir des ressources réutilisables, telles que @string/com_auth0_domain plutôt que de les coder en dur.

​
Initialiser Auth0

Créez un nouvel objet Auth0 en utilisant votre ID client Auth0 et votre valeur de domaine. Les objets l’utiliseront ultérieurement lors de l’interaction avec les points de terminaison d’Auth0. 
val auth0 = Auth0("YOUR_CLIENT_ID", "YOUR_DOMAIN")
Vous pouvez également initialiser cet objet à l’aide d’un contexte Android, comme illustré dans cet exemple d’utilisation.

​
Prochaines étapes

Connectez les utilisateurs à votre application et déconnectez-les à l’aide de la classe WebAuthProvider.

​
Réinitialiser le mot de passe de l’utilisateur

To initiate a password reset for a user, call resetPassword with the user’s email address and the database connection name as parameters. Les demandes de réinitialisation de mot de passe échoueront en cas d’erreurs liées au réseau, mais n’échoueront pas si le courriel désigné n’existe pas dans la base de données (pour des raisons de sécurité).

​
En savoir plus

⌘I