Criar e autenticar usuários - Kotlin

Anônimo

A autenticação anônima permite que os usuários conectem-se ao seu aplicativo com contas de curto prazo que não armazenam informações pessoais persistentes. Isso pode ser usado para permitir que os usuários experimentem o aplicativo antes de criarem uma conta ou durante o desenvolvimento e o teste do aplicativo. Usuários anônimos não exigem log. Consulte Autenticação anônima na documentação do App Services para obter mais informações.

Para fazer login com autenticação anônima, crie uma credencial anônima chamando Credentials.anonymous(), e depois passe a credencial gerada para 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)
}

Por padrão, o Kotlin SDK reutiliza o mesmo usuário anônimo se esse usuário não tiver feito logout. Se você deseja criar mais de um usuário anônimo, configure o reuseExisting = false ao registrar com credenciais anônimas adicionais:

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

E-mail/senha

O provedor de autenticação por e-mail/senha permite que os usuários se conectem ao seu aplicativo com um nome de usuário e uma senha de e-mail. Consulte Autenticação por e-mail/senha na documentação do App Services para obter mais informações.

Para fazer login com a autenticação de e-mail/senha, crie uma credencial de e-mail/senha chamando Crereditals.emailPassword() com o e-mail e senha registrados do usuário e, em seguida, passar a credencial gerada para 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

O fornecedor de autenticação de token JSON web personalizado permite que os usuários façam login em seu aplicativo com um token web JSON personalizado ( JSON web token JSON web). O registro para autenticação de JSON web token é tratado pelo fornecedor de JSON web token. Consulte Autenticação de token da web JSON personalizado na documentação do Atlas App Services para obter mais informações.

Para fazer login com autenticação JWT, crie uma credencial JWT chamando Credentials.jwt() com o JWT do usuário e, em seguida, passe a credencial gerada para 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)
}

Chave API

O provedor de autenticação de chave API permite que usuários não anônimos autenticados façam login em seu aplicativo com uma chave API. Consulte Autenticação de Chave deAPI na documentação do Atlas App Services para obter mais informações.

Para fazer login com autenticação de chave API, crie uma credencial de chave API chamando Crereditals.apiKey() com a chave API do usuário e, em seguida, passar a credencial gerada para app.login():

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

As chaves API do usuário são geradas automaticamente e gerenciadas pelo Kotlin SDK. Aprenda a Manage User API Keys - Kotlin SDK.

Função personalizada

O fornecedor de autenticação de Função Personalizada permite aos utilizadores iniciarem sessão na sua aplicação utilizando lógica de autenticação personalizada gerida por uma Atlas Function. Consulte a Autenticação de função personalizada na documentação do Atlas App Services para obter mais informações.

Para fazer login com a autenticação de Função Personalizada, passe seus argumentos personalizados como uma carga para Credentials.customFunction(), e depois passe a credencial gerada para app.login():

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

Saiba como Chamar uma função do Atlas - Kotlin SDK.

Você pode serializar dados para uma credencial de Função Personalizada usando um codificador EJSON. Para mais informações, incluindo exemplos, consulte Codificação JSON para Atlas.

Google

O provedor de autenticação do Google permite que você autentique usuários por meio de sua Conta do Google existente usando um token OAuth 2.0 . Consulte Autenticação do Google na documentação do Atlas App Services para obter mais informações.

Antes de autenticar usuários com o Google, você deve configurar seu aplicativo para autenticação de usuário do Google:

1. No console do Google Cloud Platform, crie um OAuth 2.0 ID do cliente do tipo "aplicativo Web".

2. Configure seu aplicativo de backend para usar esse ID de cliente e o segredo de cliente associado.

3. Habilite o OpenID Connect no backend.

Use o login oficial do Google para Android para autenticar usuários do Google em seu aplicativo Android. O seguinte código implementa esse fluxo, começando com uma chamada de método para loginWithGoogle():

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);
    }
}

O Kotlin Multiplatform (KMP) suporta muitos ambientes, mas este exemplo mostra o login na plataforma Android. Para obter informações sobre como fazer login em uma conta do Google em plataformas Apple, consulte o Exemplo de Swift SDK.

Facebook

O provedor de autenticação do Facebook permite que você autentique usuários por meio de um aplicativo do Facebook usando sua conta existente do Facebook. Consulte Facebook Authentication na documentação dos App Services para obter mais informações.

Antes de autenticar usuários com o Facebook, você deve configurar o fluxo de autenticação para seu aplicativo seguindo o início rápido oficial do Facebook para Android.

No manipulador de conclusão de login, obtenha o token de acesso do usuário conectado a partir do Facebook LoginResult. Use o token de acesso para criar uma credencial do Facebook chamando Credentials.facebook() com o token de acesso do usuário e depois passar a credencial gerada para 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}")
        }
    })

O Kotlin Multiplatform (KMP) suporta muitos ambientes, mas este exemplo mostra o login na plataforma Android. Para obter informações sobre como entrar em uma conta do Facebook em plataformas da Apple, consulte o Exemplo de Swift SDK.

Apple

O acesso com o provedor de autenticação da Apple permite que os usuários se conectem em seu aplicativo com um token personalizado fornecido pela Apple. Consulte Autenticação do ID Apple na documentação do App Services para obter mais informações.

Para fazer login com a autenticação da Apple, crie uma credencial da Apple chamando Credentials.apple () com o token do usuário e, em seguida, passe a credencial gerada para 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)
}

O Kotlin Multiplatform (KMP) suporta muitos ambientes, mas este exemplo mostra o login na plataforma Android. Para obter informações sobre como fazer login com a Apple em plataformas Apple, consulte o Exemplo de Swift SDK.

Obtenha um token de acesso do usuário

Você pode obter o token de acesso atual para um usuário conectado com a propriedade user.accessToken:

val token = user.accessToken

Se você enviar solicitações fora do SDK, deverá incluir o token de acesso do usuário em cada solicitação e atualizar manualmente o token quando ele expirar. Os tokens de acesso expiram 30 minutos após o usuário fazer login.

Você pode obter o token de atualização atual para um usuário conectado com o user.refreshToken que você pode usar para solicitar um novo token de acesso:

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

Configurar expiração do token de atualização

A atualização dos tokens expira após um período de tempo definido. Quando o token de atualização expira, o token de acesso não pode mais ser atualizado e o usuário deve se conectar novamente.

Se o token de atualização expirar após a abertura do domínio, o dispositivo não poderá sincronizar até que o usuário faça login novamente. Seu manipulador de erros de sincronização deve implementar uma lógica que capture um erro de token expirado ao tentar sincronizar e, em seguida, redirecionar os usuários para um fluxo de login.

Para obter informações sobre como configurar a expiração do token de atualização, consulte Gerencie sessões de usuário na documentação do App Services.