Crear y autenticar usuarios - SDK de Kotlin

Anónimo

La autenticación anónima permite a los usuarios iniciar sesión en tu aplicación con cuentas temporales que no almacenan información personal persistente. Puedes usarla para que los usuarios prueben tu aplicación antes de crear una cuenta o durante el desarrollo y las pruebas. Los usuarios anónimos no necesitan registrarse. Consulta "Autenticación anónima" en la documentación de App Services para obtener más información.

Para iniciar sesión con autenticación anónima, crea una credencial anónima llamando a Credentials.anonymous(), y luego pasa la credencial generada a app.login():

val app: App = App.create(YOUR_APP_ID) // Replace this with your App ID
runBlocking {
    val anonymousCredentials = Credentials.anonymous()
    val user = app.login(anonymousCredentials)
}

De forma predeterminada, el SDK de Kotlin reutiliza el mismo usuario anónimo si no ha cerrado sesión. Si desea crear más de un usuario anónimo, configure reuseExisting = false al iniciar sesión con credenciales anónimas adicionales:

// Logs in with an anonymous user
val anonUser = app.login(Credentials.anonymous())
// Logs in with a new, different anonymous user
val otherAnonUser =
    app.login(Credentials.anonymous(reuseExisting = false))

Correo electrónico/Contraseña

El proveedor de autenticación de correo electrónico y contraseña permite a los usuarios iniciar sesión en su aplicación con un nombre de usuario y una contraseña.Consulte "Autenticación de correo electrónico y contraseña" en la documentación de App Services para obtener más información.

Para iniciar sesión con autenticación de correo electrónico/contraseña, cree una credencial de correo electrónico/contraseña llamando a Credentials.emailPassword() con el correo electrónico y la contraseña registrados del usuario, y luego pase la credencial generada a app.login():

val app: App = App.create(YOUR_APP_ID) // Replace this with your App ID
runBlocking {
    val emailPasswordCredentials = Credentials.emailPassword(email, password)
    val user = app.login(emailPasswordCredentials)
}

JWT personalizado

El proveedor de autenticación JWT personalizada permite a los usuarios iniciar sesión en su aplicación con un token web JSON (JWT) personalizado. El proveedor gestiona el registro para la autenticación JWT. Consulte "Autenticación JWT personalizada" en la documentación de App Services para obtener más información.

Para iniciar sesión con autenticación JWT, cree una credencial JWT llamando a Credentials.jwt() con el JWT del usuario y luego pase la credencial generada a app.login():

val app: App = App.create(YOUR_APP_ID) // Replace this with your App ID
runBlocking {
    // Registration is handled by the JWT provider
    val jwtCredentials = Credentials.jwt(jwtToken)
    val user = app.login(jwtCredentials)
}

Llave API

El proveedor de autenticación de clave API permite que usuarios no anónimos autenticados inicien sesión en su aplicación con una clave API. Consulte "Autenticación de clave API" en la documentación de App Services para obtener más información.

Para iniciar sesión con autenticación de clave API, cree una credencial de clave API llamando a Credentials.apiKey() con la clave API del usuario y luego pasando la credencial generada a app.login():

val app: App = App.create(YOUR_APP_ID) // Replace this with your App ID
runBlocking {
    val user = app.login(Credentials.apiKey(key))
}

Las claves API de usuario se generan automáticamente y las gestiona el SDK de Kotlin. Aprenda a gestionar las claves API de usuario - SDK de Kotlin.

Función personalizada

El proveedor de autenticación de funciones personalizadas permite a los usuarios iniciar sesión en su aplicación mediante una lógica de autenticación personalizada gestionada por una función de Atlas.Consulte "Autenticación de funciones personalizadas" en la documentación de App Services para obtener más información.

Para iniciar sesión con la autenticación de función personalizada, pase sus argumentos personalizados como una carga útil a Credentials.customFunction() y luego pase la credencial generada a app.login():

// Create custom arguments for your Atlas Function
val customCredentials = Credentials.customFunction(
    payload = mapOf("username" to "bob")
)
val user = app.login(customCredentials)

Aprenda a llamar a una función Atlas - SDK de Kotlin.

Puede serializar datos para una credencial de función personalizada mediante un codificador EJSON. Para obtener más información, incluidos ejemplos, consulte Codificación EJSON para Atlas.

Google

El proveedor de autenticación de Google permite autenticar a los usuarios a través de su cuenta de Google existente mediante un 2.0 token OAuth.Consulta "Autenticación de Google" en la documentación de App Services para obtener más información.

Antes de poder autenticar usuarios con Google, debe configurar su aplicación para la autenticación de usuarios de Google:

1. En la consola de Google Cloud Platform, cree 2 un0 ID de cliente OAuth. del tipo "Aplicación web".

2. Configure su aplicación backend para usar ese ID de cliente y el secreto de cliente asociado.

3. Habilitar OpenID Connect en el backend.

Usa el inicio de sesión oficial de Google para Android para autenticar a los usuarios de Google en tu aplicación Android. El siguiente código implementa este flujo, comenzando con una llamada al loginWithGoogle() método:

fun loginWithGoogle() {
    val gso = GoogleSignInOptions
        .Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
        .requestIdToken("YOUR WEB APPLICATION CLIENT ID FOR GOOGLE AUTH")
        .build()
    val googleSignInClient = GoogleSignIn.getClient(activity, gso)
    val signInIntent: Intent = googleSignInClient.signInIntent
    val resultLauncher: ActivityResultLauncher<Intent> =
        // Note: this activity MUST inherit from ComponentActivity or AppCompatActivity to use this API
        registerForActivityResult(ActivityResultContracts.StartActivityForResult())
        { result ->
            val task: Task<GoogleSignInAccount> =
                GoogleSignIn.getSignedInAccountFromIntent(result.data)
            handleSignInResult(task)
        }
    resultLauncher.launch(signInIntent)
}
fun handleSignInResult(completedTask: Task<GoogleSignInAccount>) {
    try {
        if (completedTask.isSuccessful) {
            val account: GoogleSignInAccount? = completedTask.getResult(ApiException::class.java)
            val token: String = account?.idToken!!
            val app: App = App.create(YOUR_APP_ID) // Replace this with your App ID
            runBlocking {
                val user = app.login(Credentials.google(token, GoogleAuthType.ID_TOKEN))
            }
        } else {
            Log.e("AUTH", "Google Auth failed: ${completedTask.exception}")
        }
    } catch (e: ApiException) {
        Log.e("AUTH", "Failed to authenticate using Google OAuth: " + e.message);
    }
}

Kotlin Multiplatform (KMP) es compatible con muchos entornos, pero este ejemplo muestra el inicio de sesión en Android. Para obtener información sobre cómo iniciar sesión en una cuenta de Google en plataformas Apple, consulte el ejemplo del SDK de Swift.

Facebook

El proveedor de autenticación de Facebook permite autenticar a los usuarios a través de una aplicación de Facebook usando su cuenta de Facebook.Consulta "Autenticación de Facebook" en la documentación de Servicios de la aplicación para obtener más información.

Antes de poder autenticar usuarios con Facebook, debes configurar el flujo de autenticación para tu aplicación siguiendo la Guía de inicio rápido oficial de inicio de sesión de Facebook para Android.

En el controlador de finalización de inicio de sesión, obtenga el token de acceso del usuario conectado de Facebook LoginResult. Use el token de acceso para crear una credencial de Facebook llamando a Credentials.facebook() con el token de acceso del usuario y, a continuación, pase la credencial generada a app.login():

val app: App = App.create(YOUR_APP_ID) // Replace this with your App ID
FacebookSdk.setApplicationId(YOUR_FACEBOOK_SDK_APP_ID)
FacebookSdk.sdkInitialize(activity)
val callbackManager = CallbackManager.Factory.create()
LoginManager.getInstance().registerCallback(
    callbackManager,
    object : FacebookCallback<LoginResult> {
        override fun onSuccess(loginResult: LoginResult) {
            // Signed in successfully, forward credentials to MongoDB Realm.
            val accessToken = loginResult.accessToken
            runBlocking {
                val user = app.login(Credentials.facebook(accessToken.token))
            }
        }
        override fun onCancel() {
            Log.v("AUTH", "Cancelled Facebook login")
        }
        override fun onError(exception: FacebookException) {
            Log.e("AUTH", "Failed to authenticate with Facebook: ${exception.message}")
        }
    })

Kotlin Multiplatform (KMP) es compatible con muchos entornos, pero este ejemplo muestra el inicio de sesión en Android. Para obtener información sobre cómo iniciar sesión en una cuenta de Facebook en plataformas Apple, consulte el ejemplo del SDK de Swift.

Manzana

El proveedor de autenticación "Iniciar sesión con Apple" permite a los usuarios iniciar sesión en su aplicación con un token personalizado proporcionado por Apple.Consulte "Autenticación de Apple ID" en la documentación de App Services para obtener más información.

Para iniciar sesión con la autenticación de Apple, cree una credencial de Apple llamando a Credentials.apple() con el token del usuario y luego pase la credencial generada a app.login():

val app: App = App.create(YOUR_APP_ID) // Replace this with your App ID
runBlocking {
    // Registration is handled by Apple
    val appleCredentials = Credentials.apple(idToken)
    val user = app.login(appleCredentials)
}

Kotlin Multiplatform (KMP) es compatible con muchos entornos, pero este ejemplo muestra el inicio de sesión en Android. Para obtener información sobre cómo iniciar sesión con Apple en plataformas Apple, consulte el ejemplo del SDK de Swift.

Obtener un token de acceso de usuario

Puede obtener el token de acceso actual de un usuario que haya iniciado sesión con la propiedad user.accessToken:

val token = user.accessToken

Si envía solicitudes fuera del SDK, debe incluir el token de acceso del usuario en cada solicitud y actualizarlo manualmente cuando caduque. Los tokens de acceso caducan 30 minutos después de que el usuario inicie sesión.

Puede obtener el token de actualización actual de un usuario que haya iniciado sesión con la propiedad user.refreshToken, que puede usar para solicitar un nuevo token de acceso:

// Gets the current refresh token for the user
fun getRefreshToken(): String {
    return user.refreshToken
}

Configurar la expiración del token de actualización

Los tokens de actualización caducan tras un periodo determinado. Cuando caducan, el token de acceso ya no se puede actualizar y el usuario debe volver a iniciar sesión.

Si el token de actualización caduca después de abrir el dominio, el dispositivo no podrá sincronizarse hasta que el usuario vuelva a iniciar sesión. El controlador de errores de sincronización debe implementar una lógica que detecte un error de token caducado al intentar sincronizar y luego redirija a los usuarios a un flujo de inicio de sesión.

Para obtener información sobre cómo configurar la expiración del token de actualización, consulte Administrar sesiones de usuario en la documentación de App Services.