Esegui l'autenticazione con Firebase in modo anonimo su Android

Puoi utilizzare Firebase Authentication 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 i dati protetti dalle 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 ancora fatto, aggiungi Firebase al tuo progetto Android.
  2. Nel file Gradle (a livello di app) del modulo (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi la dipendenza per la libreria Firebase Authentication per Android. Ti consigliamo di utilizzare Firebase Android BoM per controllare il controllo delle versioni della libreria.
    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:34.0.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 Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.

    (Alternativa)  Aggiungi le dipendenze della libreria Firebase senza utilizzare BoM

    Se scegli di non utilizzare la Firebase BoM, devi specificare ogni versione della libreria Firebase nella riga della dipendenza.

    Tieni presente che se utilizzi più librerie Firebase nella tua app, ti consigliamo vivamente di utilizzare la BoM per gestire le versioni delle librerie, in modo da garantire la compatibilità di tutte le versioni.

    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:24.0.0")
    }
  3. Se non hai ancora connesso la tua app al progetto Firebase, fallo dalla console Firebase.
  4. Attiva l'autenticazione anonima:
    1. Nella Firebaseconsole, apri la sezione Auth.
    2. Nella pagina Metodi di accesso, attiva il metodo di accesso Anonimo.
    3. Facoltativo: se hai eseguito l'upgrade del progetto a Firebase Authentication with Identity Platform, puoi attivare la pulizia automatica. Se attivi questa impostazione, gli account anonimi che risalgono a oltre 30 giorni fa verranno eliminati automaticamente. Nei progetti con la pulizia automatica attivata, l'autenticazione anonima non rientrerà più nel conteggio dei limiti di utilizzo o delle quote di fatturazione. Vedi Pulizia automatica.

Eseguire l'autenticazione 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à, recupera l'istanza condivisa dell'oggetto FirebaseAuth:

    Kotlin

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

    Java

    private FirebaseAuth mAuth;
    // ...
    // Initialize Firebase Auth
    mAuth = FirebaseAuth.getInstance();
  2. Quando inizializzi l'attività, controlla se l'utente ha eseguito l'accesso:

    Kotlin

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

    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);
    }
  3. Infine, chiama signInAnonymously per accedere come utente anonimo:

    Kotlin

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

    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);
                    }
                }
            });
    Se l'accesso va a buon fine, puoi utilizzare il metodo getCurrentUser per ottenere i dati dell'account dell'utente.

Convertire un account anonimo in un account permanente

Quando un utente anonimo si registra alla tua app, potresti voler consentirgli di continuare il suo lavoro con il nuovo account. Ad esempio, potresti voler rendere disponibili nel carrello del nuovo account gli articoli che l'utente ha aggiunto al carrello prima della registrazione. Per farlo, segui questi passaggi:

  1. Quando l'utente si registra, completa il flusso di accesso per il provider di autenticazione dell'utente fino a, ma non incluso, la chiamata a uno dei metodi FirebaseAuth.signInWith. Ad esempio, ottieni il token ID Google dell'utente, il token di accesso a Facebook o l'indirizzo email e la password.
  2. Ottieni un AuthCredential per il nuovo provider di autenticazione:

    Accedi con Google

    Kotlin

    val credential = GoogleAuthProvider.getCredential(googleIdToken, null)

    Java

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

    Kotlin

    val credential = FacebookAuthProvider.getCredential(token.token)

    Java

    AuthCredential credential = FacebookAuthProvider.getCredential(token.getToken());
    Accesso con email e password

    Kotlin

    val credential = EmailAuthProvider.getCredential(email, password)

    Java

    AuthCredential credential = EmailAuthProvider.getCredential(email, password);
  3. Passa l'oggetto AuthCredential al metodo linkWithCredential dell'utente che ha eseguito l'accesso:

    Kotlin

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

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

Se la chiamata a linkWithCredential va a buon fine, il nuovo account dell'utente può accedere ai dati Firebase dell'account anonimo.

Pulizia automatica

Se hai eseguito l'upgrade del progetto a Firebase Authentication with Identity Platform, puoi attivare la pulizia automatica nella console Firebase. Quando attivi questa funzionalità, consenti a Firebase di eliminare automaticamente gli account anonimi più vecchi di 30 giorni. Nei progetti con pulizia automatica abilitata, l'autenticazione anonima non verrà conteggiata ai fini dei limiti di utilizzo o delle quote di fatturazione.

  • Gli account anonimi creati dopo l'attivazione della pulizia automatica potrebbero essere eliminati automaticamente in qualsiasi momento dopo 30 giorni dalla creazione.
  • Gli account anonimi esistenti saranno idonei all'eliminazione automatica 30 giorni dopo l'attivazione della pulizia automatica.
  • Se disattivi la pulizia automatica, gli account anonimi la cui eliminazione è pianificata rimarranno pianificati per l'eliminazione.
  • Se esegui l'upgrade di un account anonimo collegandolo a un metodo di accesso, l'account non verrà eliminato automaticamente.

Se vuoi vedere quanti utenti saranno interessati prima di attivare questa funzionalità e hai eseguito l'upgrade del progetto a Firebase Authentication with Identity Platform, puoi filtrare per is_anon in Cloud Logging.

Passaggi successivi

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