Autenticazione anonima con Firebase su Android

Puoi utilizzare l'autenticazione Firebase per creare e utilizzare account anonimi temporanei per l'autenticazione con Firebase. Questi account anonimi temporanei possono essere utilizzati per consentire agli utenti che non si sono ancora registrati alla tua app di lavorare con dati protetti da regole di sicurezza. Se un utente anonimo decide di registrarsi alla tua app, puoi collegare le sue credenziali di accesso all'account anonimo in modo che possa continuare a lavorare con i suoi dati protetti nelle sessioni future.

Prima di iniziare

  1. Se non l'hai già fatto, aggiungi Firebase al tuo progetto Android .
  2. Nel file Gradle del tuo modulo (a livello di app) (solitamente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle ), aggiungi la dipendenza per l'autenticazione Firebase libreria per Android. Ti consigliamo di utilizzare la distinta base Android Firebase per controllare il controllo delle versioni della libreria.
    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.6.0"))

    // Add the dependency for the Firebase Authentication library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-auth")
}

    Utilizzando la distinta base Firebase per Android , la tua app utilizzerà sempre le versioni compatibili delle librerie Firebase Android.

    (Alternativa) Aggiungi le dipendenze della libreria Firebase senza utilizzare la distinta base

    Se scegli di non utilizzare la distinta base Firebase, devi specificare ciascuna versione della libreria Firebase nella relativa riga di dipendenza.

    Tieni presente che se utilizzi più librerie Firebase nella tua app, ti consigliamo vivamente di utilizzare la distinta base per gestire le versioni della libreria, il che garantisce che tutte le versioni siano compatibili.

    dependencies {
    // Add the dependency for the Firebase Authentication library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-auth:22.3.0")
}
    Cerchi un modulo di libreria specifico per Kotlin? A partire da ottobre 2023 (Firebase BoM 32.5.0) , sia gli sviluppatori Kotlin che quelli Java potranno dipendere dal modulo della libreria principale (per i dettagli, vedere le FAQ su questa iniziativa ).
  3. Se non hai ancora collegato la tua app al tuo progetto Firebase, fallo dalla console Firebase .
  4. Abilita l'autenticazione anonima:
    1. Nella console Firebase , apri la sezione Autenticazione .
    2. Nella pagina Metodi di accesso , abilita il metodo di accesso anonimo .
    3. Facoltativo : se hai aggiornato il tuo progetto all'autenticazione Firebase con Identity Platform , puoi abilitare la pulizia automatica. Quando abiliti questa impostazione, gli account anonimi più vecchi di 30 giorni verranno automaticamente eliminati. Nei progetti con la pulizia automatica abilitata, l'autenticazione anonima non verrà più conteggiata ai fini dei limiti di utilizzo o delle quote di fatturazione. Vedere Pulizia automatica .

Autenticati con Firebase in modo anonimo

Quando un utente disconnesso utilizza una funzionalità dell'app che richiede l'autenticazione con Firebase, accedi all'utente in modo anonimo completando i seguenti passaggi:

  1. Nel metodo onCreate della tua attività, ottieni l'istanza condivisa dell'oggetto FirebaseAuth :

    Kotlin+KTX

    private lateinit var auth: FirebaseAuth
// ...
// Initialize Firebase Auth
auth = Firebase.auth
    AnonymousAuthActivity.kt

    Java

    private FirebaseAuth mAuth;
// ...
// Initialize Firebase Auth
mAuth = FirebaseAuth.getInstance();
    AnonymousAuthActivity.java
  2. Quando inizializzi la tua attività, controlla se l'utente ha attualmente effettuato l'accesso:

    Kotlin+KTX

    public override fun onStart() {
    super.onStart()
    // Check if user is signed in (non-null) and update UI accordingly.
    val currentUser = auth.currentUser
    updateUI(currentUser)
}
    AnonymousAuthActivity.kt

    Java

    @Override
public void onStart() {
    super.onStart();
    // Check if user is signed in (non-null) and update UI accordingly.
    FirebaseUser currentUser = mAuth.getCurrentUser();
    updateUI(currentUser);
}
    AnonymousAuthActivity.java
  3. Infine, chiama signInAnonymously per accedere come utente anonimo:

    Kotlin+KTX

    auth.signInAnonymously()
    .addOnCompleteListener(this) { task ->
        if (task.isSuccessful) {
            // Sign in success, update UI with the signed-in user's information
            Log.d(TAG, "signInAnonymously:success")
            val user = auth.currentUser
            updateUI(user)
        } else {
            // If sign in fails, display a message to the user.
            Log.w(TAG, "signInAnonymously:failure", task.exception)
            Toast.makeText(
                baseContext,
                "Authentication failed.",
                Toast.LENGTH_SHORT,
            ).show()
            updateUI(null)
        }
    }
    AnonymousAuthActivity.kt

    Java

    mAuth.signInAnonymously()
        .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
            @Override
            public void onComplete(@NonNull Task<AuthResult> task) {
                if (task.isSuccessful()) {
                    // Sign in success, update UI with the signed-in user's information
                    Log.d(TAG, "signInAnonymously:success");
                    FirebaseUser user = mAuth.getCurrentUser();
                    updateUI(user);
                } else {
                    // If sign in fails, display a message to the user.
                    Log.w(TAG, "signInAnonymously:failure", task.getException());
                    Toast.makeText(AnonymousAuthActivity.this, "Authentication failed.",
                            Toast.LENGTH_SHORT).show();
                    updateUI(null);
                }
            }
        });
    AnonymousAuthActivity.java
    Se l'accesso ha esito positivo, puoi utilizzare il metodo getCurrentUser per ottenere i dati dell'account dell'utente.

Converti un account anonimo in un account permanente

Quando un utente anonimo si iscrive alla tua app, potresti consentirgli di continuare a lavorare con il suo nuovo account; ad esempio, potresti voler rendere disponibili nel nuovo account gli articoli che l'utente ha aggiunto al carrello prima di registrarsi. carrello degli acquisti dell'account. Per fare ciò, completare i seguenti passaggi:

  1. Quando l'utente si registra, completa il flusso di accesso per il provider di autenticazione dell'utente fino alla chiamata, ma esclusa, di uno dei metodi FirebaseAuth.signInWith . Ad esempio, ottieni il token ID Google dell'utente, il token di accesso di Facebook o l'indirizzo e-mail e la password.

  2. Ottieni un AuthCredential per il nuovo provider di autenticazione:

    Accesso a Google

    Kotlin+KTX

    val credential = GoogleAuthProvider.getCredential(googleIdToken, null)
    MainActivity.kt

    Java

    AuthCredential credential = GoogleAuthProvider.getCredential(googleIdToken, null);
    MainActivity.java
    Accesso a Facebook

    Kotlin+KTX

    val credential = FacebookAuthProvider.getCredential(token.token)
    MainActivity.kt

    Java

    AuthCredential credential = FacebookAuthProvider.getCredential(token.getToken());
    MainActivity.java
    Accesso tramite e-mail e password

    Kotlin+KTX

    val credential = EmailAuthProvider.getCredential(email, password)
    MainActivity.kt

    Java

    AuthCredential credential = EmailAuthProvider.getCredential(email, password);
    MainActivity.java

  3. Passa l'oggetto AuthCredential al metodo linkWithCredential dell'utente che effettua l'accesso:

    Kotlin+KTX

    auth.currentUser!!.linkWithCredential(credential)
    .addOnCompleteListener(this) { task ->
        if (task.isSuccessful) {
            Log.d(TAG, "linkWithCredential:success")
            val user = task.result?.user
            updateUI(user)
        } else {
            Log.w(TAG, "linkWithCredential:failure", task.exception)
            Toast.makeText(
                baseContext,
                "Authentication failed.",
                Toast.LENGTH_SHORT,
            ).show()
            updateUI(null)
        }
    }
    AnonymousAuthActivity.kt

    Java

    mAuth.getCurrentUser().linkWithCredential(credential)
        .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
            @Override
            public void onComplete(@NonNull Task<AuthResult> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "linkWithCredential:success");
                    FirebaseUser user = task.getResult().getUser();
                    updateUI(user);
                } else {
                    Log.w(TAG, "linkWithCredential:failure", task.getException());
                    Toast.makeText(AnonymousAuthActivity.this, "Authentication failed.",
                            Toast.LENGTH_SHORT).show();
                    updateUI(null);
                }
            }
        });
    AnonymousAuthActivity.java

Se la chiamata a linkWithCredential ha esito positivo, il nuovo account dell'utente può accedere ai dati Firebase dell'account anonimo.

Pulizia automatica

Se hai aggiornato il tuo progetto all'autenticazione Firebase con Identity Platform , puoi abilitare la pulizia automatica nella console Firebase. Quando abiliti questa funzione consenti a Firebase di eliminare automaticamente gli account anonimi più vecchi di 30 giorni. Nei progetti con la pulizia automatica abilitata, l'autenticazione anonima non verrà conteggiata ai fini dei limiti di utilizzo o delle quote di fatturazione.

  • Tutti gli account anonimi creati dopo aver abilitato la pulizia automatica potrebbero essere eliminati automaticamente in qualsiasi momento dopo 30 giorni dalla creazione.
  • Gli account anonimi creati prima dell'attivazione della pulizia automatica potranno essere eliminati automaticamente a partire da 30 giorni dopo l'attivazione della pulizia automatica.
  • Se disattivi la pulizia automatica, tutti gli account anonimi programmati per l'eliminazione rimarranno programmati per l'eliminazione. Questi account non vengono conteggiati ai fini dei limiti di utilizzo o delle quote di fatturazione.
  • Se "aggiorni" un account anonimo collegandolo a qualsiasi metodo di accesso, l'account non verrà eliminato automaticamente.

Se vuoi vedere quanti utenti saranno interessati prima di abilitare questa funzione e hai aggiornato il tuo progetto a Firebase Authentication with Identity Platform , puoi filtrare per is_anon in Cloud Logging .

Prossimi passi

Ora che gli utenti possono autenticarsi con Firebase, puoi controllare il loro accesso ai dati nel tuo database Firebase utilizzando le regole Firebase .