Skip to main content
Auth0.Android es una biblioteca del lado del cliente que puede usar con su aplicación de Android para autenticar a los usuarios y acceder a las API de Auth0. Consulte el repositorio de Auth0.Android en GitHub.

Requisitos

Se requiere Android API versión 21 o una posterior.

Instalación

Añade el SDK a tu proyecto. La biblioteca enviará solicitudes a las API Authentication y Management de Auth0.

Agrega Auth0 a Gradle

En la sección de dependencias de build.gradle de tu aplicación, agrega lo siguiente:
dependencies {
  // Agrega el SDK de Auth0 para Android
  implementation 'com.auth0.android:auth0:2.+'
}
Si Android Studio marca el signo +, o si quiere usar una versión fija, consulte la más reciente en Maven.

Sincronice el proyecto con Gradle

Recuerde sincronizarlo desde el aviso de Android Studio o ejecutar ./gradlew clean build desde la línea de comandos.
En la sección android, configure Java 8 como bytecode de destino para los plugins de Android y Kotlin, respectivamente.
android {
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
  kotlinOptions {
    jvmTarget = '1.8'
  }
}

Permisos

Abra el archivo AndroidManifest.xml de su aplicación y añada el siguiente permiso.
<uses-permission android:name="android.permission.INTERNET" />

Configurar para Universal Login

Primero, vaya a Dashboard > Applications y haga clic en el nombre de la aplicación que quiera editar. En Allowed Callback URLs, asegúrese de que la URL siga este formato: https://YOUR_DOMAIN/android/{YOUR_APP_PACKAGE_NAME}/callback A continuación, reemplace {YOUR_APP_PACKAGE_NAME} por el nombre real del paquete de su aplicación. Puede encontrarlo en el archivo app/build.gradle como el valor de applicationId. Luego, en el archivo app/build.gradle, agregue los marcadores de posición del manifiesto para las propiedades dominio de Auth0 y Auth0 Scheme, que la biblioteca usará para registrar un intent-filter que capture el URI de callback.
Si no planea usar la funcionalidad de autenticación web ni declarar los marcadores de posición del manifiesto, puede volver a declarar manualmente la actividad en el archivo de manifiesto de su aplicación Android para quitarla del manifiesto combinado. Esto evitará que Gradle se queje de que faltan los marcadores de posición del manifiesto.Consulte las preguntas frecuentes para obtener más información.
apply plugin: 'com.android.application'

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

        //---> Agrega la siguiente línea
        manifestPlaceholders = [auth0Domain: "@string/com_auth0_domain", auth0Scheme: "https"]
        //<---
    }
    //...
}
Es una buena práctica definir recursos reutilizables como @string/com_auth0_domain en lugar de incluirlos directamente en el código.

Inicializar Auth0

Cree un nuevo objeto Auth0 con su y el valor de dominio. Más adelante, los objetos lo usarán al interactuar con los endpoints de Auth0.
val auth0 = Auth0("{yourClientId}", "YOUR_DOMAIN")
También puede inicializar este objeto con un Context de Android, como se muestra en este ejemplo de uso.

Próximos pasos

Inicie y cierre la sesión de los usuarios en su aplicación usando la clase WebAuthProvider.

Restablecer la contraseña de un usuario

Para iniciar el restablecimiento de la contraseña de un usuario, llama a resetPassword con el correo electrónico del usuario y el nombre de la conexión de base de datos como parámetros. Las solicitudes de restablecimiento de contraseña fallarán si se producen errores de red, pero no fallarán si el correo electrónico indicado no existe en la base de datos (por motivos de seguridad).

Más información