En este artículo, repasaremos los pasos para construir rápidamente la experiencia de inicio de sesión de Amazon (autenticación de usuario) con Android (Kotlin / Java) y Logto.

Requisitos previos

• Una instancia de Logto en funcionamiento. Consulta la página de introducción para comenzar.
• Conocimientos básicos de Android (Kotlin / Java).
• Una cuenta de Amazon utilizable.

Crear una aplicación en Logto​

Logto se basa en la autenticación OpenID Connect (OIDC) y la autorización OAuth 2.0. Admite la gestión de identidad federada a través de múltiples aplicaciones, comúnmente llamada inicio de sesión único (SSO).

Para crear tu aplicación Aplicación nativa, simplemente sigue estos pasos:

1. Abre la Consola de Logto. En la sección "Comenzar", haz clic en el enlace "Ver todo" para abrir la lista de marcos de aplicaciones. Alternativamente, puedes navegar a Consola de Logto > Aplicaciones, y hacer clic en el botón "Crear aplicación".
2. En el modal que se abre, haz clic en la sección "Aplicación nativa" o filtra todos los marcos "Aplicación nativa" disponibles usando las casillas de filtro rápido a la izquierda. Haz clic en la tarjeta del marco "Android" para comenzar a crear tu aplicación.
3. Ingresa el nombre de la aplicación, por ejemplo, "Librería", y haz clic en "Crear aplicación".

🎉 ¡Ta-da! Acabas de crear tu primera aplicación en Logto. Verás una página de felicitaciones que incluye una guía de integración detallada. Sigue la guía para ver cómo será la experiencia en tu aplicación.

Integrar el SDK de Android​

Instalación​

Antes de instalar Logto Android SDK, asegúrate de que mavenCentral() esté agregado a la configuración de tu repositorio en el archivo de construcción del proyecto Gradle:

dependencyResolutionManagement {
  repositories {
    mavenCentral()
  }
}

Añade Logto Android SDK a tus dependencias:

dependencies {
  implementation("io.logto.sdk:android:1.1.3")
}

dependencies {
  implementation 'io.logto.sdk:android:1.1.3'
}

Dado que el SDK necesita acceso a internet, debes añadir el siguiente permiso a tu archivo AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools">

  <!-- añadir permiso de internet -->
  <uses-permission android:name="android.permission.INTERNET" />

  <!-- otras configuraciones... -->
</manifest>

Inicializar LogtoClient​

Crea un LogtoViewModel.kt e inicializa LogtoClient en este modelo de vista:

//...con otras importaciones
import io.logto.sdk.android.LogtoClient
import io.logto.sdk.android.type.LogtoConfig

class LogtoViewModel(application: Application) : AndroidViewModel(application) {
    private val logtoConfig = LogtoConfig(
          endpoint = "<your-logto-endpoint>",
          appId = "<your-app-id>",
          scopes = null,
          resources = null,
          usingPersistStorage = true,
    )

    private val logtoClient = LogtoClient(logtoConfig, application)

    companion object {
        val Factory: ViewModelProvider.Factory = object : ViewModelProvider.Factory {
            @Suppress("UNCHECKED_CAST")
            override fun <T : ViewModel> create(
                modelClass: Class<T>,
                extras: CreationExtras
            ): T {
                // Obtén el objeto Application de extras
                val application = checkNotNull(extras[APPLICATION_KEY])
                return LogtoViewModel(application) as T
            }
        }
    }
}

luego, crea un LogtoViewModel para tu MainActivity.kt:

//...con otras importaciones
class MainActivity : AppCompatActivity() {
    private val logtoViewModel: LogtoViewModel by viewModels { LogtoViewModel.Factory }
    //...otros códigos
}

Configurar URI de redirección​

Vamos a cambiar a la página de detalles de la aplicación en Logto Console. Añade un URI de redirección io.logto.android://io.logto.sample/callback y haz clic en "Guardar cambios".

Implementar inicio y cierre de sesión​

Puedes usar logtoClient.signIn para iniciar sesión del usuario y logtoClient.signOut para cerrar sesión del usuario.

Por ejemplo, en una aplicación Android:

//...con otras importaciones
class LogtoViewModel(application: Application) : AndroidViewModel(application) {
    // ...otros códigos

    // Añadir un live data para observar el estado de autenticación
    private val _authenticated = MutableLiveData(logtoClient.isAuthenticated)
    val authenticated: LiveData<Boolean>
        get() = _authenticated

    fun signIn(context: Activity) {
        logtoClient.signIn(context, "io.logto.android://io.logto.sample/callback") { logtoException ->
            logtoException?.let { println(it) }
            // Actualizar el live data
            _authenticated.postValue(logtoClient.isAuthenticated)
        }
    }

    fun signOut() {
        logtoClient.signOut { logtoException ->
            logtoException?.let { println(it) }
            // Actualizar el live data
            _authenticated.postValue(logtoClient.isAuthenticated)
        }
    }
}

Luego llama a los métodos signIn y signOut en tu actividad:

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        //...otros códigos

        // Supón que tienes un botón con id "sign_in_button" en tu diseño
        val signInButton = findViewById<Button>(R.id.sign_in_button)
        signInButton.setOnClickListener {
            logtoViewModel.signIn(this)
        }

        // Supón que tienes un botón con id "sign_out_button" en tu diseño
        val signOutButton = findViewById<Button>(R.id.sign_out_button)
        signOutButton.setOnClickListener {
            if (logtoViewModel.authenticated) { // Verifica si el usuario está autenticado
                logtoViewModel.signOut()
            }
        }

        // Observa el estado de autenticación para actualizar la interfaz de usuario
        logtoViewModel.authenticated.observe(this) { authenticated ->
            if (authenticated) {
                // El usuario está autenticado
                signInButton.visibility = View.GONE
                signOutButton.visibility = View.VISIBLE
            } else {
                // El usuario no está autenticado
                signInButton.visibility = View.VISIBLE
                signOutButton.visibility = View.GONE
            }
        }

    }
}

Punto de control: Prueba tu aplicación​

Ahora, puedes probar tu aplicación:

1. Ejecuta tu aplicación, verás el botón de inicio de sesión.
2. Haz clic en el botón de inicio de sesión, el SDK iniciará el proceso de inicio de sesión y te redirigirá a la página de inicio de sesión de Logto.
3. Después de iniciar sesión, serás redirigido de vuelta a tu aplicación y verás el botón de cierre de sesión.
4. Haz clic en el botón de cierre de sesión para limpiar el almacenamiento de tokens y cerrar sesión.

Añadir el conector Amazon​

Para habilitar un inicio de sesión rápido y mejorar la conversión de usuarios, conéctate con Android como un proveedor de identidad (IdP). El conector social de Logto te ayuda a establecer esta conexión en minutos permitiendo la entrada de varios parámetros.

Para añadir un conector social, simplemente sigue estos pasos:

1. Navega a Console > Connectors > Social Connectors.
2. Haz clic en "Add social connector" y selecciona "Amazon".
3. Sigue la guía README y completa los campos requeridos y personaliza la configuración.

Configura Amazon​

Configura una aplicación de Amazon​

Ve al Portal de Desarrolladores de Amazon e inicia sesión con tu cuenta. Si no tienes una cuenta, puedes registrarte para obtener una.

Luego, crea una aplicación.

Paso 1: Ve al bloque "Login with Amazon" en la página de inicio.

O puedes visitar esta página.

Sigue la guía para crear un nuevo perfil de seguridad.

Después de crear el perfil de seguridad, obtendrás un Client ID y un Client Secret de la tabla.

Paso 2: Configura las URLs de callback.

Haz clic en el botón "Manage" en el lado derecho de la tabla y ve a la pestaña "Web Settings".

En el campo "Allowed redirect URLs", añade la siguiente URL:

• ${your_logto_origin}/callback/${connector_id}.

El connector_id se puede encontrar en la barra superior de la página de detalles del conector en la Logto Admin Console.

Configura tu conector​

En la configuración de tu conector de Logto, completa los siguientes campos con los valores obtenidos en el último paso:

• clientId: El Client ID de tu aplicación.
• clientSecret: El Client Secret de tu aplicación.

scope es una lista de OIDC scopes delimitada por espacios. Si no se proporciona, el scope predeterminado es openid profile.

Tipos de configuración​

Guarda tu configuración​

Verifica que hayas completado los valores necesarios en el área de configuración del conector Logto. Haz clic en "Guardar y listo" (o "Guardar cambios") y el conector Amazon debería estar disponible ahora.

Habilitar el conector Amazon en la Experiencia de inicio de sesión​

Una vez que crees un conector social con éxito, puedes habilitarlo como un botón "Continuar con Amazon" en la Experiencia de inicio de sesión.

1. Navega a Consola > Experiencia de inicio de sesión > Registro e inicio de sesión.
2. (Opcional) Elige "No aplicable" para el identificador de registro si solo necesitas inicio de sesión social.
3. Añade el conector Amazon configurado a la sección "Inicio de sesión social".

Pruebas y Validación​

Regresa a tu aplicación Android (Kotlin / Java). Ahora deberías poder iniciar sesión con Amazon. ¡Disfruta!

Lecturas adicionales​

Flujos de usuario final: Logto proporciona flujos de autenticación listos para usar, incluyendo MFA y SSO empresarial, junto con potentes APIs para la implementación flexible de configuraciones de cuenta, verificación de seguridad y experiencia multi-tenant.

Autorización (Authorization): La autorización define las acciones que un usuario puede realizar o los recursos a los que puede acceder después de ser autenticado. Explora cómo proteger tu API para aplicaciones nativas y de una sola página e implementar el Control de Acceso Basado en Roles (RBAC).

Organizaciones (Organizations): Particularmente efectivo en aplicaciones SaaS multi-tenant y B2B, la función de organización permite la creación de inquilinos, gestión de miembros, RBAC a nivel de organización y aprovisionamiento justo a tiempo.

Serie IAM del cliente: Nuestros artículos de blog en serie sobre la Gestión de Identidad y Acceso del Cliente (o Consumidor), desde los conceptos básicos hasta temas avanzados y más allá.

En este artículo, repasaremos los pasos para construir rápidamente la experiencia de inicio de sesión de Apple (autenticación de usuario) con Android (Kotlin / Java) y Logto.

Requisitos previos

• Una instancia de Logto en funcionamiento. Consulta la página de introducción para comenzar.
• Conocimientos básicos de Android (Kotlin / Java).
• Una cuenta de Apple utilizable.

Crear una aplicación en Logto​

Logto se basa en la autenticación OpenID Connect (OIDC) y la autorización OAuth 2.0. Admite la gestión de identidad federada a través de múltiples aplicaciones, comúnmente llamada inicio de sesión único (SSO).

Para crear tu aplicación Aplicación nativa, simplemente sigue estos pasos:

1. Abre la Consola de Logto. En la sección "Comenzar", haz clic en el enlace "Ver todo" para abrir la lista de marcos de aplicaciones. Alternativamente, puedes navegar a Consola de Logto > Aplicaciones, y hacer clic en el botón "Crear aplicación".
2. En el modal que se abre, haz clic en la sección "Aplicación nativa" o filtra todos los marcos "Aplicación nativa" disponibles usando las casillas de filtro rápido a la izquierda. Haz clic en la tarjeta del marco "Android" para comenzar a crear tu aplicación.
3. Ingresa el nombre de la aplicación, por ejemplo, "Librería", y haz clic en "Crear aplicación".

🎉 ¡Ta-da! Acabas de crear tu primera aplicación en Logto. Verás una página de felicitaciones que incluye una guía de integración detallada. Sigue la guía para ver cómo será la experiencia en tu aplicación.

Integrar el SDK de Android​

Instalación​

Antes de instalar Logto Android SDK, asegúrate de que mavenCentral() esté agregado a la configuración de tu repositorio en el archivo de construcción del proyecto Gradle:

dependencyResolutionManagement {
  repositories {
    mavenCentral()
  }
}

Añade Logto Android SDK a tus dependencias:

dependencies {
  implementation("io.logto.sdk:android:1.1.3")
}

dependencies {
  implementation 'io.logto.sdk:android:1.1.3'
}

Dado que el SDK necesita acceso a internet, debes añadir el siguiente permiso a tu archivo AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools">

  <!-- añadir permiso de internet -->
  <uses-permission android:name="android.permission.INTERNET" />

  <!-- otras configuraciones... -->
</manifest>

Inicializar LogtoClient​

Crea un LogtoViewModel.kt e inicializa LogtoClient en este modelo de vista:

//...con otras importaciones
import io.logto.sdk.android.LogtoClient
import io.logto.sdk.android.type.LogtoConfig

class LogtoViewModel(application: Application) : AndroidViewModel(application) {
    private val logtoConfig = LogtoConfig(
          endpoint = "<your-logto-endpoint>",
          appId = "<your-app-id>",
          scopes = null,
          resources = null,
          usingPersistStorage = true,
    )

    private val logtoClient = LogtoClient(logtoConfig, application)

    companion object {
        val Factory: ViewModelProvider.Factory = object : ViewModelProvider.Factory {
            @Suppress("UNCHECKED_CAST")
            override fun <T : ViewModel> create(
                modelClass: Class<T>,
                extras: CreationExtras
            ): T {
                // Obtén el objeto Application de extras
                val application = checkNotNull(extras[APPLICATION_KEY])
                return LogtoViewModel(application) as T
            }
        }
    }
}

luego, crea un LogtoViewModel para tu MainActivity.kt:

//...con otras importaciones
class MainActivity : AppCompatActivity() {
    private val logtoViewModel: LogtoViewModel by viewModels { LogtoViewModel.Factory }
    //...otros códigos
}

Configurar URI de redirección​

Vamos a cambiar a la página de detalles de la aplicación en Logto Console. Añade un URI de redirección io.logto.android://io.logto.sample/callback y haz clic en "Guardar cambios".

Implementar inicio y cierre de sesión​

Puedes usar logtoClient.signIn para iniciar sesión del usuario y logtoClient.signOut para cerrar sesión del usuario.

Por ejemplo, en una aplicación Android:

//...con otras importaciones
class LogtoViewModel(application: Application) : AndroidViewModel(application) {
    // ...otros códigos

    // Añadir un live data para observar el estado de autenticación
    private val _authenticated = MutableLiveData(logtoClient.isAuthenticated)
    val authenticated: LiveData<Boolean>
        get() = _authenticated

    fun signIn(context: Activity) {
        logtoClient.signIn(context, "io.logto.android://io.logto.sample/callback") { logtoException ->
            logtoException?.let { println(it) }
            // Actualizar el live data
            _authenticated.postValue(logtoClient.isAuthenticated)
        }
    }

    fun signOut() {
        logtoClient.signOut { logtoException ->
            logtoException?.let { println(it) }
            // Actualizar el live data
            _authenticated.postValue(logtoClient.isAuthenticated)
        }
    }
}

Luego llama a los métodos signIn y signOut en tu actividad:

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        //...otros códigos

        // Supón que tienes un botón con id "sign_in_button" en tu diseño
        val signInButton = findViewById<Button>(R.id.sign_in_button)
        signInButton.setOnClickListener {
            logtoViewModel.signIn(this)
        }

        // Supón que tienes un botón con id "sign_out_button" en tu diseño
        val signOutButton = findViewById<Button>(R.id.sign_out_button)
        signOutButton.setOnClickListener {
            if (logtoViewModel.authenticated) { // Verifica si el usuario está autenticado
                logtoViewModel.signOut()
            }
        }

        // Observa el estado de autenticación para actualizar la interfaz de usuario
        logtoViewModel.authenticated.observe(this) { authenticated ->
            if (authenticated) {
                // El usuario está autenticado
                signInButton.visibility = View.GONE
                signOutButton.visibility = View.VISIBLE
            } else {
                // El usuario no está autenticado
                signInButton.visibility = View.VISIBLE
                signOutButton.visibility = View.GONE
            }
        }

    }
}

Punto de control: Prueba tu aplicación​

Ahora, puedes probar tu aplicación:

1. Ejecuta tu aplicación, verás el botón de inicio de sesión.
2. Haz clic en el botón de inicio de sesión, el SDK iniciará el proceso de inicio de sesión y te redirigirá a la página de inicio de sesión de Logto.
3. Después de iniciar sesión, serás redirigido de vuelta a tu aplicación y verás el botón de cierre de sesión.
4. Haz clic en el botón de cierre de sesión para limpiar el almacenamiento de tokens y cerrar sesión.

Añadir el conector Apple​

Para habilitar un inicio de sesión rápido y mejorar la conversión de usuarios, conéctate con Android como un proveedor de identidad (IdP). El conector social de Logto te ayuda a establecer esta conexión en minutos permitiendo la entrada de varios parámetros.

Para añadir un conector social, simplemente sigue estos pasos:

1. Navega a Console > Connectors > Social Connectors.
2. Haz clic en "Add social connector" y selecciona "Apple".
3. Sigue la guía README y completa los campos requeridos y personaliza la configuración.

Configura Apple Sign-in​

Necesitas inscribirte en el Apple Developer Program antes de continuar.

Habilitar el inicio de sesión con Apple para tu aplicación​

Puedes hacerlo a través de Xcode -> Configuración del proyecto -> Firmado y Capacidades, o visitar Certificates, Identifiers & Profiles.

Consulta la sección "Habilitar un ID de aplicación" en los documentos oficiales de Apple para más información.

Crear un identificador​

1. Visita Certificates, Identifiers & Profiles, luego haz clic en el botón "+" junto a "Identifier".
2. En la página "Registrar un nuevo identificador", elige "Services IDs" y haz clic en "Continue".
3. Completa "Description" e "Identifier" (Ej., Logto Test y io.logto.test), luego haz clic en "Continue".
4. Verifica la información y haz clic en "Register".

Habilitar el inicio de sesión con Apple para tu identificador​

Haz clic en el identificador que acabas de crear. Marca "Sign in with Apple" en la página de detalles y haz clic en "Configure".

En el modal que se abre, selecciona el ID de aplicación al que acabas de habilitar el inicio de sesión con Apple.

Ingresa el dominio de tu instancia de Logto sin protocolo ni puerto, por ejemplo, your.logto.domain; luego ingresa la "Return URL" (es decir, Redirect URI), que es la URL de Logto con /callback/${connector_id}, por ejemplo, https://your.logto.domain/callback/apple-universal. Puedes obtener el connector_id generado aleatoriamente después de crear el conector de Apple en la Consola de Administración.

Haz clic en "Next" y luego en "Done" para cerrar el modal. Haz clic en "Continue" en la esquina superior derecha, luego haz clic en "Save" para guardar tu configuración.

Configurar alcance​

Para obtener el correo electrónico del usuario de Apple, necesitas configurar el alcance para incluir email. Para obtener tanto el correo electrónico como el nombre, puedes usar name email como el alcance. Consulta los documentos oficiales de Apple para más información.

Guarda tu configuración​

Verifica que hayas completado los valores necesarios en el área de configuración del conector Logto. Haz clic en "Guardar y listo" (o "Guardar cambios") y el conector Apple debería estar disponible ahora.

Habilitar el conector Apple en la Experiencia de inicio de sesión​

Una vez que crees un conector social con éxito, puedes habilitarlo como un botón "Continuar con Apple" en la Experiencia de inicio de sesión.

1. Navega a Consola > Experiencia de inicio de sesión > Registro e inicio de sesión.
2. (Opcional) Elige "No aplicable" para el identificador de registro si solo necesitas inicio de sesión social.
3. Añade el conector Apple configurado a la sección "Inicio de sesión social".

Pruebas y Validación​

Regresa a tu aplicación Android (Kotlin / Java). Ahora deberías poder iniciar sesión con Apple. ¡Disfruta!

Lecturas adicionales​

Flujos de usuario final: Logto proporciona flujos de autenticación listos para usar, incluyendo MFA y SSO empresarial, junto con potentes APIs para la implementación flexible de configuraciones de cuenta, verificación de seguridad y experiencia multi-tenant.

Autorización (Authorization): La autorización define las acciones que un usuario puede realizar o los recursos a los que puede acceder después de ser autenticado. Explora cómo proteger tu API para aplicaciones nativas y de una sola página e implementar el Control de Acceso Basado en Roles (RBAC).

Organizaciones (Organizations): Particularmente efectivo en aplicaciones SaaS multi-tenant y B2B, la función de organización permite la creación de inquilinos, gestión de miembros, RBAC a nivel de organización y aprovisionamiento justo a tiempo.

Serie IAM del cliente: Nuestros artículos de blog en serie sobre la Gestión de Identidad y Acceso del Cliente (o Consumidor), desde los conceptos básicos hasta temas avanzados y más allá.

En este artículo, repasaremos los pasos para construir rápidamente la experiencia de inicio de sesión de AWS SES (autenticación de usuario) con Android (Kotlin / Java) y Logto.

Requisitos previos

• Una instancia de Logto en funcionamiento. Consulta la página de introducción para comenzar.
• Conocimientos básicos de Android (Kotlin / Java).
• Una cuenta de AWS SES utilizable.

Crear una aplicación en Logto​

Logto se basa en la autenticación OpenID Connect (OIDC) y la autorización OAuth 2.0. Admite la gestión de identidad federada a través de múltiples aplicaciones, comúnmente llamada inicio de sesión único (SSO).

Para crear tu aplicación Aplicación nativa, simplemente sigue estos pasos:

1. Abre la Consola de Logto. En la sección "Comenzar", haz clic en el enlace "Ver todo" para abrir la lista de marcos de aplicaciones. Alternativamente, puedes navegar a Consola de Logto > Aplicaciones, y hacer clic en el botón "Crear aplicación".
2. En el modal que se abre, haz clic en la sección "Aplicación nativa" o filtra todos los marcos "Aplicación nativa" disponibles usando las casillas de filtro rápido a la izquierda. Haz clic en la tarjeta del marco "Android" para comenzar a crear tu aplicación.
3. Ingresa el nombre de la aplicación, por ejemplo, "Librería", y haz clic en "Crear aplicación".

🎉 ¡Ta-da! Acabas de crear tu primera aplicación en Logto. Verás una página de felicitaciones que incluye una guía de integración detallada. Sigue la guía para ver cómo será la experiencia en tu aplicación.

Integrar Logto SDK​

Instalación​

Antes de instalar Logto Android SDK, asegúrate de que mavenCentral() esté agregado a la configuración de tu repositorio en el archivo de construcción del proyecto Gradle:

dependencyResolutionManagement {
  repositories {
    mavenCentral()
  }
}

Añade Logto Android SDK a tus dependencias:

dependencies {
  implementation("io.logto.sdk:android:1.1.3")
}

dependencies {
  implementation 'io.logto.sdk:android:1.1.3'
}

Dado que el SDK necesita acceso a internet, debes añadir el siguiente permiso a tu archivo AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools">

  <!-- añadir permiso de internet -->
  <uses-permission android:name="android.permission.INTERNET" />

  <!-- otras configuraciones... -->
</manifest>

Inicializar LogtoClient​

Crea un LogtoViewModel.kt e inicializa LogtoClient en este modelo de vista:

//...con otras importaciones
import io.logto.sdk.android.LogtoClient
import io.logto.sdk.android.type.LogtoConfig

class LogtoViewModel(application: Application) : AndroidViewModel(application) {
    private val logtoConfig = LogtoConfig(
          endpoint = "<your-logto-endpoint>",
          appId = "<your-app-id>",
          scopes = null,
          resources = null,
          usingPersistStorage = true,
    )

    private val logtoClient = LogtoClient(logtoConfig, application)

    companion object {
        val Factory: ViewModelProvider.Factory = object : ViewModelProvider.Factory {
            @Suppress("UNCHECKED_CAST")
            override fun <T : ViewModel> create(
                modelClass: Class<T>,
                extras: CreationExtras
            ): T {
                // Obtén el objeto Application de extras
                val application = checkNotNull(extras[APPLICATION_KEY])
                return LogtoViewModel(application) as T
            }
        }
    }
}

luego, crea un LogtoViewModel para tu MainActivity.kt:

//...con otras importaciones
class MainActivity : AppCompatActivity() {
    private val logtoViewModel: LogtoViewModel by viewModels { LogtoViewModel.Factory }
    //...otros códigos
}

Configurar URI de redirección​

Vamos a cambiar a la página de detalles de la aplicación en Logto Console. Añade un URI de redirección io.logto.android://io.logto.sample/callback y haz clic en "Guardar cambios".

Implementar inicio y cierre de sesión​

Puedes usar logtoClient.signIn para iniciar sesión del usuario y logtoClient.signOut para cerrar sesión del usuario.

Por ejemplo, en una aplicación Android:

//...con otras importaciones
class LogtoViewModel(application: Application) : AndroidViewModel(application) {
    // ...otros códigos

    // Añadir un live data para observar el estado de autenticación
    private val _authenticated = MutableLiveData(logtoClient.isAuthenticated)
    val authenticated: LiveData<Boolean>
        get() = _authenticated

    fun signIn(context: Activity) {
        logtoClient.signIn(context, "io.logto.android://io.logto.sample/callback") { logtoException ->
            logtoException?.let { println(it) }
            // Actualizar el live data
            _authenticated.postValue(logtoClient.isAuthenticated)
        }
    }

    fun signOut() {
        logtoClient.signOut { logtoException ->
            logtoException?.let { println(it) }
            // Actualizar el live data
            _authenticated.postValue(logtoClient.isAuthenticated)
        }
    }
}

Luego llama a los métodos signIn y signOut en tu actividad:

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        //...otros códigos

        // Supón que tienes un botón con id "sign_in_button" en tu diseño
        val signInButton = findViewById<Button>(R.id.sign_in_button)
        signInButton.setOnClickListener {
            logtoViewModel.signIn(this)
        }

        // Supón que tienes un botón con id "sign_out_button" en tu diseño
        val signOutButton = findViewById<Button>(R.id.sign_out_button)
        signOutButton.setOnClickListener {
            if (logtoViewModel.authenticated) { // Verifica si el usuario está autenticado
                logtoViewModel.signOut()
            }
        }

        // Observa el estado de autenticación para actualizar la interfaz de usuario
        logtoViewModel.authenticated.observe(this) { authenticated ->
            if (authenticated) {
                // El usuario está autenticado
                signInButton.visibility = View.GONE
                signOutButton.visibility = View.VISIBLE
            } else {
                // El usuario no está autenticado
                signInButton.visibility = View.VISIBLE
                signOutButton.visibility = View.GONE
            }
        }

    }
}

Punto de control: Prueba tu aplicación​

Ahora, puedes probar tu aplicación:

1. Ejecuta tu aplicación, verás el botón de inicio de sesión.
2. Haz clic en el botón de inicio de sesión, el SDK iniciará el proceso de inicio de sesión y te redirigirá a la página de inicio de sesión de Logto.
3. Después de iniciar sesión, serás redirigido de vuelta a tu aplicación y verás el botón de cierre de sesión.
4. Haz clic en el botón de cierre de sesión para limpiar el almacenamiento de tokens y cerrar sesión.

Añadir conector AWS SES​

El conector Email es un método utilizado para enviar contraseñas de un solo uso (OTPs) para la autenticación. Permite la verificación de Dirección de correo electrónico para admitir la autenticación sin contraseña, incluyendo el registro basado en Email, inicio de sesión, autenticación de dos factores (2FA) y recuperación de cuenta. Puedes conectar fácilmente AWS SES como tu proveedor de Email. Con el conector Email de Logto, puedes configurarlo en solo unos minutos.

Para añadir un conector Email, simplemente sigue estos pasos:

1. Navega a Console > Connector > Email and SMS connectors.
2. Para añadir un nuevo conector Email, haz clic en el botón "Set up" y selecciona "AWS SES".
3. Revisa la documentación README para tu proveedor seleccionado.
4. Completa los campos de configuración en la sección "Parameter Configuration".
5. Personaliza la plantilla Email utilizando el editor JSON.
6. Prueba tu configuración enviando un código de verificación a tu Dirección de correo electrónico.

Configurar Conector de correo electrónico AWS SES​

Configura un servicio de correo en la consola de servicios de AWS​

Registra una cuenta de AWS​

Ve a AWS y registra una cuenta.

Crea una identidad​

• Ve a la consola de Amazon Simple Email Service
• Crea una identidad, elige una de las siguientes opciones
  • Crear un dominio
  • Crear una dirección de correo electrónico

Configuración del conector​

1. Haz clic en tu nombre de usuario en la esquina superior derecha de la consola de Amazon para entrar en Security Credentials. Si no tienes uno, crea un AccessKey y guárdalo cuidadosamente.
2. Completa la configuración del conector de Amazon Simple Email Service:
   • Usa el AccessKey ID y el AccessKey Secret obtenidos en el paso 1 para completar accessKeyId y accessKeySecret respectivamente.
   • region: Completa el campo region con la región de la identidad que usas para enviar correos.
   • emailAddress: La dirección de correo electrónico que usas para enviar correos, en el formato de Logto\<noreply@logto.io> o \<noreply@logto.io>

los siguientes parámetros son opcionales; la descripción de los parámetros se puede encontrar en la documentación de la API de AWS SES.

• feedbackForwardingEmailAddress
• feedbackForwardingEmailAddressIdentityArn
• configurationSetName

Prueba el conector de Amazon SES​

Puedes escribir una dirección de correo electrónico y hacer clic en "Enviar" para ver si la configuración funciona antes de "Guardar y Listo".

Eso es todo. No olvides Habilitar el conector en la experiencia de inicio de sesión.

Configura tipos​

Guarda tu configuración​

Verifica que hayas completado los valores necesarios en el área de configuración del conector Logto. Haz clic en "Guardar y listo" (o "Guardar cambios") y el conector AWS SES debería estar disponible ahora.

Habilitar el conector AWS SES en la Experiencia de inicio de sesión​

Una vez que crees un conector con éxito, puedes habilitar el inicio de sesión y registro sin contraseña basado en número de teléfono.

1. Navega a Consola > Experiencia de inicio de sesión > Registro e inicio de sesión.
2. Configura los métodos de registro (Opcional):
   1. Selecciona "Dirección de correo electrónico" o "Correo electrónico o número de teléfono" como el identificador de registro.
   2. "Verificar al registrarse" se fuerza a estar habilitado. También puedes habilitar "Crear una contraseña" en el registro.
3. Configura los métodos de inicio de sesión:
   1. Selecciona Dirección de correo electrónico como uno de los identificadores de inicio de sesión. Puedes proporcionar múltiples identificadores disponibles (correo electrónico, número de teléfono y nombre de usuario).
   2. Selecciona "Código de verificación" y / o "Contraseña" como el factor de autenticación.
4. Haz clic en "Guardar cambios" y pruébalo en "Vista previa en vivo".

Además del registro e inicio de sesión a través de OTPs de , también puedes tener habilitada la recuperación de contraseña y la verificación de seguridad basada en , así como vincular Dirección de correo electrónico al perfil. Consulta Flujos de usuario final para más detalles.

Pruebas y Validación​

Regresa a tu aplicación Android (Kotlin / Java). Ahora deberías poder iniciar sesión con AWS SES. ¡Disfruta!

Lecturas adicionales​

Flujos de usuario final: Logto proporciona flujos de autenticación listos para usar, incluyendo MFA y SSO empresarial, junto con potentes APIs para la implementación flexible de configuraciones de cuenta, verificación de seguridad y experiencia multi-tenant.

Autorización (Authorization): La autorización define las acciones que un usuario puede realizar o los recursos a los que puede acceder después de ser autenticado. Explora cómo proteger tu API para aplicaciones nativas y de una sola página e implementar el Control de Acceso Basado en Roles (RBAC).

Organizaciones (Organizations): Particularmente efectivo en aplicaciones SaaS multi-tenant y B2B, la función de organización permite la creación de inquilinos, gestión de miembros, RBAC a nivel de organización y aprovisionamiento justo a tiempo.

Serie IAM del cliente: Nuestros artículos de blog en serie sobre la Gestión de Identidad y Acceso del Cliente (o Consumidor), desde los conceptos básicos hasta temas avanzados y más allá.

En este artículo, repasaremos los pasos para construir rápidamente la experiencia de inicio de sesión de Azure AD (autenticación de usuario) con Android (Kotlin / Java) y Logto.

Requisitos previos

• Una instancia de Logto en funcionamiento. Consulta la página de introducción para comenzar.
• Conocimientos básicos de Android (Kotlin / Java).
• Una cuenta de Azure AD utilizable.

Crear una aplicación en Logto​

Logto se basa en la autenticación OpenID Connect (OIDC) y la autorización OAuth 2.0. Admite la gestión de identidad federada a través de múltiples aplicaciones, comúnmente llamada inicio de sesión único (SSO).

Para crear tu aplicación Aplicación nativa, simplemente sigue estos pasos:

1. Abre la Consola de Logto. En la sección "Comenzar", haz clic en el enlace "Ver todo" para abrir la lista de marcos de aplicaciones. Alternativamente, puedes navegar a Consola de Logto > Aplicaciones, y hacer clic en el botón "Crear aplicación".
2. En el modal que se abre, haz clic en la sección "Aplicación nativa" o filtra todos los marcos "Aplicación nativa" disponibles usando las casillas de filtro rápido a la izquierda. Haz clic en la tarjeta del marco "Android" para comenzar a crear tu aplicación.
3. Ingresa el nombre de la aplicación, por ejemplo, "Librería", y haz clic en "Crear aplicación".

🎉 ¡Ta-da! Acabas de crear tu primera aplicación en Logto. Verás una página de felicitaciones que incluye una guía de integración detallada. Sigue la guía para ver cómo será la experiencia en tu aplicación.

Integrar el SDK de Android​

Instalación​

Antes de instalar Logto Android SDK, asegúrate de que mavenCentral() esté agregado a la configuración de tu repositorio en el archivo de construcción del proyecto Gradle:

dependencyResolutionManagement {
  repositories {
    mavenCentral()
  }
}

Añade Logto Android SDK a tus dependencias:

dependencies {
  implementation("io.logto.sdk:android:1.1.3")
}

dependencies {
  implementation 'io.logto.sdk:android:1.1.3'
}

Dado que el SDK necesita acceso a internet, debes añadir el siguiente permiso a tu archivo AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools">

  <!-- añadir permiso de internet -->
  <uses-permission android:name="android.permission.INTERNET" />

  <!-- otras configuraciones... -->
</manifest>

Inicializar LogtoClient​

Crea un LogtoViewModel.kt e inicializa LogtoClient en este modelo de vista:

//...con otras importaciones
import io.logto.sdk.android.LogtoClient
import io.logto.sdk.android.type.LogtoConfig

class LogtoViewModel(application: Application) : AndroidViewModel(application) {
    private val logtoConfig = LogtoConfig(
          endpoint = "<your-logto-endpoint>",
          appId = "<your-app-id>",
          scopes = null,
          resources = null,
          usingPersistStorage = true,
    )

    private val logtoClient = LogtoClient(logtoConfig, application)

    companion object {
        val Factory: ViewModelProvider.Factory = object : ViewModelProvider.Factory {
            @Suppress("UNCHECKED_CAST")
            override fun <T : ViewModel> create(
                modelClass: Class<T>,
                extras: CreationExtras
            ): T {
                // Obtén el objeto Application de extras
                val application = checkNotNull(extras[APPLICATION_KEY])
                return LogtoViewModel(application) as T
            }
        }
    }
}

luego, crea un LogtoViewModel para tu MainActivity.kt:

//...con otras importaciones
class MainActivity : AppCompatActivity() {
    private val logtoViewModel: LogtoViewModel by viewModels { LogtoViewModel.Factory }
    //...otros códigos
}

Configurar URI de redirección​

Vamos a cambiar a la página de detalles de la aplicación en Logto Console. Añade un URI de redirección io.logto.android://io.logto.sample/callback y haz clic en "Guardar cambios".

Implementar inicio y cierre de sesión​

Puedes usar logtoClient.signIn para iniciar sesión del usuario y logtoClient.signOut para cerrar sesión del usuario.

Por ejemplo, en una aplicación Android:

//...con otras importaciones
class LogtoViewModel(application: Application) : AndroidViewModel(application) {
    // ...otros códigos

    // Añadir un live data para observar el estado de autenticación
    private val _authenticated = MutableLiveData(logtoClient.isAuthenticated)
    val authenticated: LiveData<Boolean>
        get() = _authenticated

    fun signIn(context: Activity) {
        logtoClient.signIn(context, "io.logto.android://io.logto.sample/callback") { logtoException ->
            logtoException?.let { println(it) }
            // Actualizar el live data
            _authenticated.postValue(logtoClient.isAuthenticated)
        }
    }

    fun signOut() {
        logtoClient.signOut { logtoException ->
            logtoException?.let { println(it) }
            // Actualizar el live data
            _authenticated.postValue(logtoClient.isAuthenticated)
        }
    }
}

Luego llama a los métodos signIn y signOut en tu actividad:

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        //...otros códigos

        // Supón que tienes un botón con id "sign_in_button" en tu diseño
        val signInButton = findViewById<Button>(R.id.sign_in_button)
        signInButton.setOnClickListener {
            logtoViewModel.signIn(this)
        }

        // Supón que tienes un botón con id "sign_out_button" en tu diseño
        val signOutButton = findViewById<Button>(R.id.sign_out_button)
        signOutButton.setOnClickListener {
            if (logtoViewModel.authenticated) { // Verifica si el usuario está autenticado
                logtoViewModel.signOut()
            }
        }

        // Observa el estado de autenticación para actualizar la interfaz de usuario
        logtoViewModel.authenticated.observe(this) { authenticated ->
            if (authenticated) {
                // El usuario está autenticado
                signInButton.visibility = View.GONE
                signOutButton.visibility = View.VISIBLE
            } else {
                // El usuario no está autenticado
                signInButton.visibility = View.VISIBLE
                signOutButton.visibility = View.GONE
            }
        }

    }
}

Punto de control: Prueba tu aplicación​

Ahora, puedes probar tu aplicación:

1. Ejecuta tu aplicación, verás el botón de inicio de sesión.
2. Haz clic en el botón de inicio de sesión, el SDK iniciará el proceso de inicio de sesión y te redirigirá a la página de inicio de sesión de Logto.
3. Después de iniciar sesión, serás redirigido de vuelta a tu aplicación y verás el botón de cierre de sesión.
4. Haz clic en el botón de cierre de sesión para limpiar el almacenamiento de tokens y cerrar sesión.

Añadir el conector Azure AD​

Para habilitar un inicio de sesión rápido y mejorar la conversión de usuarios, conéctate con Android como un proveedor de identidad (IdP). El conector social de Logto te ayuda a establecer esta conexión en minutos permitiendo la entrada de varios parámetros.

Para añadir un conector social, simplemente sigue estos pasos:

1. Navega a Console > Connectors > Social Connectors.
2. Haz clic en "Add social connector" y selecciona "Azure AD".
3. Sigue la guía README y completa los campos requeridos y personaliza la configuración.

Configura Azure AD​

Configura Microsoft Azure AD en el Portal de Azure​

• Visita el Portal de Azure e inicia sesión con tu cuenta de Azure. Necesitas tener una suscripción activa para acceder a Microsoft Azure AD.
• Haz clic en Azure Active Directory de los servicios que ofrecen, y haz clic en App Registrations desde el menú de la izquierda.
• Haz clic en New Registration en la parte superior, ingresa una descripción, selecciona tu tipo de acceso y añade tu Redirect URI, que redirigirá al usuario a la aplicación después de iniciar sesión. En nuestro caso, esto será ${your_logto_endpoint}/callback/${connector_id}. Por ejemplo, https://foo.logto.app/callback/${connector_id}. El connector_id también se puede encontrar en la barra superior de la página de detalles del conector en la Consola de Administración de Logto. Puedes copiar el Callback URI en la sección de configuración.
• Selecciona Web como Plataforma.

Completa la configuración en Logto​

ID de Cliente​

Puedes encontrar el Application (client) ID en la sección Overview de tu nueva aplicación creada en el Portal de Azure.

Secreto de Cliente​

• En tu nueva aplicación creada, haz clic en Certificates & Secrets para obtener un secreto de cliente, y haz clic en New client secret desde la parte superior.
• Ingresa una descripción y una expiración.
• Esto solo mostrará tu secreto de cliente una vez. Completa el valor en la configuración del conector de Logto y guárdalo en un lugar seguro.

Instancia de Nube​

Usualmente, es https://login.microsoftonline.com/. Consulta puntos de conexión de autenticación de Azure AD para más información.

ID de Inquilino​

Logto usará este campo para construir los puntos de conexión de autorización. Este valor depende del tipo de acceso que seleccionaste al crear la aplicación en el Portal de Azure.

• Si seleccionas Accounts in this organizational directory only para el tipo de acceso, entonces necesitas ingresar tu {TenantID}. Puedes encontrar el ID de inquilino en la sección Overview de tu Azure Active Directory.
• Si seleccionas Accounts in any organizational directory para el tipo de acceso, entonces necesitas ingresar organizations.
• Si seleccionas Accounts in any organizational directory or personal Microsoft accounts para el tipo de acceso, entonces necesitas ingresar common.
• Si seleccionas Personal Microsoft accounts only para el tipo de acceso, entonces necesitas ingresar consumers.

Guarda tu configuración​

Verifica que hayas completado los valores necesarios en el área de configuración del conector Logto. Haz clic en "Guardar y listo" (o "Guardar cambios") y el conector Azure AD debería estar disponible ahora.

Habilitar el conector Azure AD en la Experiencia de inicio de sesión​

Una vez que crees un conector social con éxito, puedes habilitarlo como un botón "Continuar con Azure AD" en la Experiencia de inicio de sesión.

1. Navega a Consola > Experiencia de inicio de sesión > Registro e inicio de sesión.
2. (Opcional) Elige "No aplicable" para el identificador de registro si solo necesitas inicio de sesión social.
3. Añade el conector Azure AD configurado a la sección "Inicio de sesión social".

Pruebas y Validación​

Regresa a tu aplicación Android (Kotlin / Java). Ahora deberías poder iniciar sesión con Azure AD. ¡Disfruta!

Lecturas adicionales​

Flujos de usuario final: Logto proporciona flujos de autenticación listos para usar, incluyendo MFA y SSO empresarial, junto con potentes APIs para la implementación flexible de configuraciones de cuenta, verificación de seguridad y experiencia multi-tenant.

Autorización (Authorization): La autorización define las acciones que un usuario puede realizar o los recursos a los que puede acceder después de ser autenticado. Explora cómo proteger tu API para aplicaciones nativas y de una sola página e implementar el Control de Acceso Basado en Roles (RBAC).

Organizaciones (Organizations): Particularmente efectivo en aplicaciones SaaS multi-tenant y B2B, la función de organización permite la creación de inquilinos, gestión de miembros, RBAC a nivel de organización y aprovisionamiento justo a tiempo.

Serie IAM del cliente: Nuestros artículos de blog en serie sobre la Gestión de Identidad y Acceso del Cliente (o Consumidor), desde los conceptos básicos hasta temas avanzados y más allá.

En este artículo, repasaremos los pasos para construir rápidamente la experiencia de inicio de sesión de DingTalk (autenticación de usuario) con Android (Kotlin / Java) y Logto.

Requisitos previos

• Una instancia de Logto en funcionamiento. Consulta la página de introducción para comenzar.
• Conocimientos básicos de Android (Kotlin / Java).
• Una cuenta de DingTalk utilizable.

Crear una aplicación en Logto​

Logto se basa en la autenticación OpenID Connect (OIDC) y la autorización OAuth 2.0. Admite la gestión de identidad federada a través de múltiples aplicaciones, comúnmente llamada inicio de sesión único (SSO).

Para crear tu aplicación Aplicación nativa, simplemente sigue estos pasos:

1. Abre la Consola de Logto. En la sección "Comenzar", haz clic en el enlace "Ver todo" para abrir la lista de marcos de aplicaciones. Alternativamente, puedes navegar a Consola de Logto > Aplicaciones, y hacer clic en el botón "Crear aplicación".
2. En el modal que se abre, haz clic en la sección "Aplicación nativa" o filtra todos los marcos "Aplicación nativa" disponibles usando las casillas de filtro rápido a la izquierda. Haz clic en la tarjeta del marco "Android" para comenzar a crear tu aplicación.
3. Ingresa el nombre de la aplicación, por ejemplo, "Librería", y haz clic en "Crear aplicación".

🎉 ¡Ta-da! Acabas de crear tu primera aplicación en Logto. Verás una página de felicitaciones que incluye una guía de integración detallada. Sigue la guía para ver cómo será la experiencia en tu aplicación.

Integrar el SDK de Android​

Instalación​

Antes de instalar Logto Android SDK, asegúrate de que mavenCentral() esté agregado a la configuración de tu repositorio en el archivo de construcción del proyecto Gradle:

dependencyResolutionManagement {
  repositories {
    mavenCentral()
  }
}

Añade Logto Android SDK a tus dependencias:

dependencies {
  implementation("io.logto.sdk:android:1.1.3")
}

dependencies {
  implementation 'io.logto.sdk:android:1.1.3'
}

Dado que el SDK necesita acceso a internet, debes añadir el siguiente permiso a tu archivo AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools">

  <!-- añadir permiso de internet -->
  <uses-permission android:name="android.permission.INTERNET" />

  <!-- otras configuraciones... -->
</manifest>

Inicializar LogtoClient​

Crea un LogtoViewModel.kt e inicializa LogtoClient en este modelo de vista:

//...con otras importaciones
import io.logto.sdk.android.LogtoClient
import io.logto.sdk.android.type.LogtoConfig

class LogtoViewModel(application: Application) : AndroidViewModel(application) {
    private val logtoConfig = LogtoConfig(
          endpoint = "<your-logto-endpoint>",
          appId = "<your-app-id>",
          scopes = null,
          resources = null,
          usingPersistStorage = true,
    )

    private val logtoClient = LogtoClient(logtoConfig, application)

    companion object {
        val Factory: ViewModelProvider.Factory = object : ViewModelProvider.Factory {
            @Suppress("UNCHECKED_CAST")
            override fun <T : ViewModel> create(
                modelClass: Class<T>,
                extras: CreationExtras
            ): T {
                // Obtén el objeto Application de extras
                val application = checkNotNull(extras[APPLICATION_KEY])
                return LogtoViewModel(application) as T
            }
        }
    }
}

luego, crea un LogtoViewModel para tu MainActivity.kt:

//...con otras importaciones
class MainActivity : AppCompatActivity() {
    private val logtoViewModel: LogtoViewModel by viewModels { LogtoViewModel.Factory }
    //...otros códigos
}

Configurar URI de redirección​

Vamos a cambiar a la página de detalles de la aplicación en Logto Console. Añade un URI de redirección io.logto.android://io.logto.sample/callback y haz clic en "Guardar cambios".

Implementar inicio y cierre de sesión​

Puedes usar logtoClient.signIn para iniciar sesión del usuario y logtoClient.signOut para cerrar sesión del usuario.

Por ejemplo, en una aplicación Android:

//...con otras importaciones
class LogtoViewModel(application: Application) : AndroidViewModel(application) {
    // ...otros códigos

    // Añadir un live data para observar el estado de autenticación
    private val _authenticated = MutableLiveData(logtoClient.isAuthenticated)
    val authenticated: LiveData<Boolean>
        get() = _authenticated

    fun signIn(context: Activity) {
        logtoClient.signIn(context, "io.logto.android://io.logto.sample/callback") { logtoException ->
            logtoException?.let { println(it) }
            // Actualizar el live data
            _authenticated.postValue(logtoClient.isAuthenticated)
        }
    }

    fun signOut() {
        logtoClient.signOut { logtoException ->
            logtoException?.let { println(it) }
            // Actualizar el live data
            _authenticated.postValue(logtoClient.isAuthenticated)
        }
    }
}

Luego llama a los métodos signIn y signOut en tu actividad:

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        //...otros códigos

        // Supón que tienes un botón con id "sign_in_button" en tu diseño
        val signInButton = findViewById<Button>(R.id.sign_in_button)
        signInButton.setOnClickListener {
            logtoViewModel.signIn(this)
        }

        // Supón que tienes un botón con id "sign_out_button" en tu diseño
        val signOutButton = findViewById<Button>(R.id.sign_out_button)
        signOutButton.setOnClickListener {
            if (logtoViewModel.authenticated) { // Verifica si el usuario está autenticado
                logtoViewModel.signOut()
            }
        }

        // Observa el estado de autenticación para actualizar la interfaz de usuario
        logtoViewModel.authenticated.observe(this) { authenticated ->
            if (authenticated) {
                // El usuario está autenticado
                signInButton.visibility = View.GONE
                signOutButton.visibility = View.VISIBLE
            } else {
                // El usuario no está autenticado
                signInButton.visibility = View.VISIBLE
                signOutButton.visibility = View.GONE
            }
        }

    }
}

Punto de control: Prueba tu aplicación​

Ahora, puedes probar tu aplicación:

1. Ejecuta tu aplicación, verás el botón de inicio de sesión.
2. Haz clic en el botón de inicio de sesión, el SDK iniciará el proceso de inicio de sesión y te redirigirá a la página de inicio de sesión de Logto.
3. Después de iniciar sesión, serás redirigido de vuelta a tu aplicación y verás el botón de cierre de sesión.
4. Haz clic en el botón de cierre de sesión para limpiar el almacenamiento de tokens y cerrar sesión.

Añadir el conector DingTalk​

Para habilitar un inicio de sesión rápido y mejorar la conversión de usuarios, conéctate con Android como un proveedor de identidad (IdP). El conector social de Logto te ayuda a establecer esta conexión en minutos permitiendo la entrada de varios parámetros.

Para añadir un conector social, simplemente sigue estos pasos:

1. Navega a Console > Connectors > Social Connectors.
2. Haz clic en "Add social connector" y selecciona "DingTalk".
3. Sigue la guía README y completa los campos requeridos y personaliza la configuración.

Configura DingTalk OAuth app​

Crea una aplicación web en la Plataforma Abierta de DingTalk​

Consejo: Puedes omitir algunas secciones si ya las has completado.

Registra una cuenta de desarrollador de DingTalk​

Si no tienes una cuenta de desarrollador de DingTalk, por favor regístrate en la Plataforma Abierta de DingTalk.

Crea una aplicación​

1. En la Plataforma Abierta de DingTalk, ve a "Desarrollo de aplicaciones" > "Aplicación empresarial interna" > "Aplicación DingTalk", haz clic en "Crear aplicación"
2. Rellena el nombre de la aplicación y la descripción, y haz clic en "Guardar"
3. En la barra de navegación izquierda, selecciona "Configuración de desarrollo" > "Configuración de seguridad", busca y configura la "URL de redirección" ${your_logto_origin}/callback/${connector_id}. Puedes encontrar el connector_id en la página de detalles del conector después de añadir el conector correspondiente en la consola de administración
4. En la barra de navegación izquierda, selecciona "Información básica" > "Credenciales e información básica" para obtener el Client ID y el Client Secret

Configura los permisos​

En "Configuración de desarrollo" > "Gestión de permisos", selecciona los permisos Contact.User.Read y Contact.User.mobile y autorízalos

Publica la aplicación​

En la barra de navegación izquierda, selecciona "Publicación de la aplicación" > "Gestión y publicación de versiones", crea y publica la primera versión para activar el Client ID y el Client Secret

Configura tu conector​

Rellena los campos clientId y clientSecret con el Client ID (anteriormente AppKey y SuiteKey) y el Client Secret (anteriormente AppKey y SuiteKey) que obtuviste de las páginas de detalles de la aplicación OAuth mencionadas en la sección anterior.

El scope actualmente admite dos valores: openid y openid corpid. openid permite obtener el userid del usuario después de la autorización, mientras que openid corpid permite obtener tanto el id del usuario como el id de la organización seleccionada durante el proceso de inicio de sesión. Los valores deben estar separados por espacios. Nota: Se requiere codificación URL.

Tipos de configuración​

Prueba el conector de DingTalk​

Eso es todo. El conector de DingTalk debería estar disponible ahora. No olvides Habilitar el conector en la experiencia de inicio de sesión.

Una vez habilitado el conector web de DingTalk, puedes iniciar sesión en tu aplicación nuevamente para comprobar si funciona.

Soporte​

Si tienes alguna pregunta o necesitas más ayuda, por favor visita la Documentación para desarrolladores de DingTalk o contacta con el soporte técnico de DingTalk.

Guarda tu configuración​

Verifica que hayas completado los valores necesarios en el área de configuración del conector Logto. Haz clic en "Guardar y listo" (o "Guardar cambios") y el conector DingTalk debería estar disponible ahora.

Habilitar el conector DingTalk en la Experiencia de inicio de sesión​

Una vez que crees un conector social con éxito, puedes habilitarlo como un botón "Continuar con DingTalk" en la Experiencia de inicio de sesión.

1. Navega a Consola > Experiencia de inicio de sesión > Registro e inicio de sesión.
2. (Opcional) Elige "No aplicable" para el identificador de registro si solo necesitas inicio de sesión social.
3. Añade el conector DingTalk configurado a la sección "Inicio de sesión social".

Pruebas y Validación​

Regresa a tu aplicación Android (Kotlin / Java). Ahora deberías poder iniciar sesión con DingTalk. ¡Disfruta!

Lecturas adicionales​

Flujos de usuario final: Logto proporciona flujos de autenticación listos para usar, incluyendo MFA y SSO empresarial, junto con potentes APIs para la implementación flexible de configuraciones de cuenta, verificación de seguridad y experiencia multi-tenant.

Autorización (Authorization): La autorización define las acciones que un usuario puede realizar o los recursos a los que puede acceder después de ser autenticado. Explora cómo proteger tu API para aplicaciones nativas y de una sola página e implementar el Control de Acceso Basado en Roles (RBAC).

Organizaciones (Organizations): Particularmente efectivo en aplicaciones SaaS multi-tenant y B2B, la función de organización permite la creación de inquilinos, gestión de miembros, RBAC a nivel de organización y aprovisionamiento justo a tiempo.

Serie IAM del cliente: Nuestros artículos de blog en serie sobre la Gestión de Identidad y Acceso del Cliente (o Consumidor), desde los conceptos básicos hasta temas avanzados y más allá.

En este artículo, repasaremos los pasos para construir rápidamente la experiencia de inicio de sesión de Discord (autenticación de usuario) con Android (Kotlin / Java) y Logto.

Requisitos previos

• Una instancia de Logto en funcionamiento. Consulta la página de introducción para comenzar.
• Conocimientos básicos de Android (Kotlin / Java).
• Una cuenta de Discord utilizable.

Crear una aplicación en Logto​

Logto se basa en la autenticación OpenID Connect (OIDC) y la autorización OAuth 2.0. Admite la gestión de identidad federada a través de múltiples aplicaciones, comúnmente llamada inicio de sesión único (SSO).

Para crear tu aplicación Aplicación nativa, simplemente sigue estos pasos:

1. Abre la Consola de Logto. En la sección "Comenzar", haz clic en el enlace "Ver todo" para abrir la lista de marcos de aplicaciones. Alternativamente, puedes navegar a Consola de Logto > Aplicaciones, y hacer clic en el botón "Crear aplicación".
2. En el modal que se abre, haz clic en la sección "Aplicación nativa" o filtra todos los marcos "Aplicación nativa" disponibles usando las casillas de filtro rápido a la izquierda. Haz clic en la tarjeta del marco "Android" para comenzar a crear tu aplicación.
3. Ingresa el nombre de la aplicación, por ejemplo, "Librería", y haz clic en "Crear aplicación".

🎉 ¡Ta-da! Acabas de crear tu primera aplicación en Logto. Verás una página de felicitaciones que incluye una guía de integración detallada. Sigue la guía para ver cómo será la experiencia en tu aplicación.

Integrar el SDK de Android​

Instalación​

Antes de instalar Logto Android SDK, asegúrate de que mavenCentral() esté agregado a la configuración de tu repositorio en el archivo de construcción del proyecto Gradle:

dependencyResolutionManagement {
  repositories {
    mavenCentral()
  }
}

Añade Logto Android SDK a tus dependencias:

dependencies {
  implementation("io.logto.sdk:android:1.1.3")
}

dependencies {
  implementation 'io.logto.sdk:android:1.1.3'
}

Dado que el SDK necesita acceso a internet, debes añadir el siguiente permiso a tu archivo AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools">

  <!-- añadir permiso de internet -->
  <uses-permission android:name="android.permission.INTERNET" />

  <!-- otras configuraciones... -->
</manifest>

Inicializar LogtoClient​

Crea un LogtoViewModel.kt e inicializa LogtoClient en este modelo de vista:

//...con otras importaciones
import io.logto.sdk.android.LogtoClient
import io.logto.sdk.android.type.LogtoConfig

class LogtoViewModel(application: Application) : AndroidViewModel(application) {
    private val logtoConfig = LogtoConfig(
          endpoint = "<your-logto-endpoint>",
          appId = "<your-app-id>",
          scopes = null,
          resources = null,
          usingPersistStorage = true,
    )

    private val logtoClient = LogtoClient(logtoConfig, application)

    companion object {
        val Factory: ViewModelProvider.Factory = object : ViewModelProvider.Factory {
            @Suppress("UNCHECKED_CAST")
            override fun <T : ViewModel> create(
                modelClass: Class<T>,
                extras: CreationExtras
            ): T {
                // Obtén el objeto Application de extras
                val application = checkNotNull(extras[APPLICATION_KEY])
                return LogtoViewModel(application) as T
            }
        }
    }
}

luego, crea un LogtoViewModel para tu MainActivity.kt:

//...con otras importaciones
class MainActivity : AppCompatActivity() {
    private val logtoViewModel: LogtoViewModel by viewModels { LogtoViewModel.Factory }
    //...otros códigos
}

Configurar URI de redirección​

Vamos a cambiar a la página de detalles de la aplicación en Logto Console. Añade un URI de redirección io.logto.android://io.logto.sample/callback y haz clic en "Guardar cambios".

Implementar inicio y cierre de sesión​

Puedes usar logtoClient.signIn para iniciar sesión del usuario y logtoClient.signOut para cerrar sesión del usuario.

Por ejemplo, en una aplicación Android:

//...con otras importaciones
class LogtoViewModel(application: Application) : AndroidViewModel(application) {
    // ...otros códigos

    // Añadir un live data para observar el estado de autenticación
    private val _authenticated = MutableLiveData(logtoClient.isAuthenticated)
    val authenticated: LiveData<Boolean>
        get() = _authenticated

    fun signIn(context: Activity) {
        logtoClient.signIn(context, "io.logto.android://io.logto.sample/callback") { logtoException ->
            logtoException?.let { println(it) }
            // Actualizar el live data
            _authenticated.postValue(logtoClient.isAuthenticated)
        }
    }

    fun signOut() {
        logtoClient.signOut { logtoException ->
            logtoException?.let { println(it) }
            // Actualizar el live data
            _authenticated.postValue(logtoClient.isAuthenticated)
        }
    }
}

Luego llama a los métodos signIn y signOut en tu actividad:

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        //...otros códigos

        // Supón que tienes un botón con id "sign_in_button" en tu diseño
        val signInButton = findViewById<Button>(R.id.sign_in_button)
        signInButton.setOnClickListener {
            logtoViewModel.signIn(this)
        }

        // Supón que tienes un botón con id "sign_out_button" en tu diseño
        val signOutButton = findViewById<Button>(R.id.sign_out_button)
        signOutButton.setOnClickListener {
            if (logtoViewModel.authenticated) { // Verifica si el usuario está autenticado
                logtoViewModel.signOut()
            }
        }

        // Observa el estado de autenticación para actualizar la interfaz de usuario
        logtoViewModel.authenticated.observe(this) { authenticated ->
            if (authenticated) {
                // El usuario está autenticado
                signInButton.visibility = View.GONE
                signOutButton.visibility = View.VISIBLE
            } else {
                // El usuario no está autenticado
                signInButton.visibility = View.VISIBLE
                signOutButton.visibility = View.GONE
            }
        }

    }
}

Punto de control: Prueba tu aplicación​

Ahora, puedes probar tu aplicación:

1. Ejecuta tu aplicación, verás el botón de inicio de sesión.
2. Haz clic en el botón de inicio de sesión, el SDK iniciará el proceso de inicio de sesión y te redirigirá a la página de inicio de sesión de Logto.
3. Después de iniciar sesión, serás redirigido de vuelta a tu aplicación y verás el botón de cierre de sesión.
4. Haz clic en el botón de cierre de sesión para limpiar el almacenamiento de tokens y cerrar sesión.

Añadir el conector Discord​

Para habilitar un inicio de sesión rápido y mejorar la conversión de usuarios, conéctate con Android como un proveedor de identidad (IdP). El conector social de Logto te ayuda a establecer esta conexión en minutos permitiendo la entrada de varios parámetros.

Para añadir un conector social, simplemente sigue estos pasos:

1. Navega a Console > Connectors > Social Connectors.
2. Haz clic en "Add social connector" y selecciona "Discord".
3. Sigue la guía README y completa los campos requeridos y personaliza la configuración.

Configura Discord OAuth app​

Registra una aplicación de desarrollador​

• Visita el Portal de Desarrolladores de Discord e inicia sesión con tu cuenta de Discord.
• Haz clic en el botón New Application para crear una aplicación, elige un nombre para ella (Ej: LogtoAuth), marca la casilla y haz clic en Create.
• Ve a la página de OAuth2 y haz clic en Reset Secret.
• Toma nota de los campos CLIENT ID y CLIENT SECRET.
• Añade los redireccionamientos válidos (Ej: http://auth.mycompany.io/callback/${connector_id}). El connector_id se puede encontrar en la barra superior de la página de detalles del conector en la Consola de Administración de Logto.

Configura Logto​

Tipos de configuración​

clientId​

clientId es el campo CLIENT ID que guardamos anteriormente. (Puedes encontrarlo en la página de OAuth2 en el Portal de Desarrolladores de Discord.)

clientSecret​

clientSecret es el CLIENT SECRET que guardamos anteriormente. (Si lo has perdido, necesitas hacer clic en Reset Secret.)

scope​

scope son los permisos otorgados por la autorización del usuario. El valor predeterminado es identify email. Puedes ver la lista completa de alcances aquí.

Guarda tu configuración​

Verifica que hayas completado los valores necesarios en el área de configuración del conector Logto. Haz clic en "Guardar y listo" (o "Guardar cambios") y el conector Discord debería estar disponible ahora.

Habilitar el conector Discord en la Experiencia de inicio de sesión​

Una vez que crees un conector social con éxito, puedes habilitarlo como un botón "Continuar con Discord" en la Experiencia de inicio de sesión.

1. Navega a Consola > Experiencia de inicio de sesión > Registro e inicio de sesión.
2. (Opcional) Elige "No aplicable" para el identificador de registro si solo necesitas inicio de sesión social.
3. Añade el conector Discord configurado a la sección "Inicio de sesión social".

Pruebas y Validación​

Regresa a tu aplicación Android (Kotlin / Java). Ahora deberías poder iniciar sesión con Discord. ¡Disfruta!

Lecturas adicionales​

Flujos de usuario final: Logto proporciona flujos de autenticación listos para usar, incluyendo MFA y SSO empresarial, junto con potentes APIs para la implementación flexible de configuraciones de cuenta, verificación de seguridad y experiencia multi-tenant.

Autorización (Authorization): La autorización define las acciones que un usuario puede realizar o los recursos a los que puede acceder después de ser autenticado. Explora cómo proteger tu API para aplicaciones nativas y de una sola página e implementar el Control de Acceso Basado en Roles (RBAC).

Organizaciones (Organizations): Particularmente efectivo en aplicaciones SaaS multi-tenant y B2B, la función de organización permite la creación de inquilinos, gestión de miembros, RBAC a nivel de organización y aprovisionamiento justo a tiempo.

Serie IAM del cliente: Nuestros artículos de blog en serie sobre la Gestión de Identidad y Acceso del Cliente (o Consumidor), desde los conceptos básicos hasta temas avanzados y más allá.

En este artículo, repasaremos los pasos para construir rápidamente la experiencia de inicio de sesión de Facebook (autenticación de usuario) con Android (Kotlin / Java) y Logto.

Requisitos previos

• Una instancia de Logto en funcionamiento. Consulta la página de introducción para comenzar.
• Conocimientos básicos de Android (Kotlin / Java).
• Una cuenta de Facebook utilizable.

Crear una aplicación en Logto​

Logto se basa en la autenticación OpenID Connect (OIDC) y la autorización OAuth 2.0. Admite la gestión de identidad federada a través de múltiples aplicaciones, comúnmente llamada inicio de sesión único (SSO).

Para crear tu aplicación Aplicación nativa, simplemente sigue estos pasos:

1. Abre la Consola de Logto. En la sección "Comenzar", haz clic en el enlace "Ver todo" para abrir la lista de marcos de aplicaciones. Alternativamente, puedes navegar a Consola de Logto > Aplicaciones, y hacer clic en el botón "Crear aplicación".
2. En el modal que se abre, haz clic en la sección "Aplicación nativa" o filtra todos los marcos "Aplicación nativa" disponibles usando las casillas de filtro rápido a la izquierda. Haz clic en la tarjeta del marco "Android" para comenzar a crear tu aplicación.
3. Ingresa el nombre de la aplicación, por ejemplo, "Librería", y haz clic en "Crear aplicación".

🎉 ¡Ta-da! Acabas de crear tu primera aplicación en Logto. Verás una página de felicitaciones que incluye una guía de integración detallada. Sigue la guía para ver cómo será la experiencia en tu aplicación.

Integrar el SDK de Android​

Instalación​

Antes de instalar Logto Android SDK, asegúrate de que mavenCentral() esté agregado a la configuración de tu repositorio en el archivo de construcción del proyecto Gradle:

dependencyResolutionManagement {
  repositories {
    mavenCentral()
  }
}

Añade Logto Android SDK a tus dependencias:

dependencies {
  implementation("io.logto.sdk:android:1.1.3")
}

dependencies {
  implementation 'io.logto.sdk:android:1.1.3'
}

Dado que el SDK necesita acceso a internet, debes añadir el siguiente permiso a tu archivo AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools">

  <!-- añadir permiso de internet -->
  <uses-permission android:name="android.permission.INTERNET" />

  <!-- otras configuraciones... -->
</manifest>

Inicializar LogtoClient​

Crea un LogtoViewModel.kt e inicializa LogtoClient en este modelo de vista:

//...con otras importaciones
import io.logto.sdk.android.LogtoClient
import io.logto.sdk.android.type.LogtoConfig

class LogtoViewModel(application: Application) : AndroidViewModel(application) {
    private val logtoConfig = LogtoConfig(
          endpoint = "<your-logto-endpoint>",
          appId = "<your-app-id>",
          scopes = null,
          resources = null,
          usingPersistStorage = true,
    )

    private val logtoClient = LogtoClient(logtoConfig, application)

    companion object {
        val Factory: ViewModelProvider.Factory = object : ViewModelProvider.Factory {
            @Suppress("UNCHECKED_CAST")
            override fun <T : ViewModel> create(
                modelClass: Class<T>,
                extras: CreationExtras
            ): T {
                // Obtén el objeto Application de extras
                val application = checkNotNull(extras[APPLICATION_KEY])
                return LogtoViewModel(application) as T
            }
        }
    }
}