Auth0.Android

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 Management API 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.+'
}

Was this helpful?

/

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'
  }
}

Was this helpful?

/

Autorisations

Open your application’s AndroidManifest.xml file and add the following permission.

<uses-permission android:name="android.permission.INTERNET" />

Was this helpful?

/

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.

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"]
        //<---
    }
    //...
}

Was this helpful?

/

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")

Was this helpful?

/

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