Esegui l'autenticazione con Firebase in modo anonimo su Android

Puoi utilizzare Firebase Authentication per creare e utilizzare account temporanei anonimi per autenticarti con Firebase. Questi account anonimi temporanei possono essere utilizzati per consentire agli utenti che non hanno ancora eseguito la registrazione 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 già fatto, aggiungi Firebase al tuo progetto Android.
  2. Nel file Gradle del modulo (a livello di app) (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 la gestione delle versioni delle librerie.
    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:33.7.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")
    }

    Con Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase per Android.

    (Alternativa)  Aggiungi le dipendenze delle librerie Firebase senza utilizzare il file BoM

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

    Tieni presente che se nella tua app utilizzi più librerie Firebase, ti consigliamo vivamente di utilizzare 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:23.1.0")
    }
    Cerchi un modulo della libreria specifico per Kotlin? A partire da ottobre 2023 (Firebase BoM 32.5.0), sia gli sviluppatori Kotlin che Java possono fare affidamento sul modulo della libreria principale (per maggiori dettagli, consulta le Domande frequenti su questa iniziativa).
  3. Se non hai ancora collegato l'app al progetto Firebase, fallo dalla console Firebase.
  4. Attiva l'autenticazione anonima:
    1. Nella console Firebase, 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 attivo questa impostazione, gli account anonimi che risalgono a oltre 30 giorni fa verranno eliminati automaticamente. Nei progetti in cui è attiva la pulizia automatica, l'autenticazione anonima non verrà più conteggiata ai fini dei limiti di utilizzo o delle quote di fatturazione. Consulta Pulizia automatica.

Eseguire l'autenticazione con Firebase in forma anonima

Quando un utente che non ha eseguito l'accesso utilizza una funzionalità dell'app che richiede l'autenticazione con Firebase, fai in modo che acceda in modo anonimo completando i seguenti passaggi:

  1. Nel metodo onCreate dell'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 inizializzazione 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 recuperare i dati dell'account dell'utente.

Convertire un account anonimo in un account permanente

Quando un utente anonimo si registra alla tua app, potresti volergli consentire di continuare a lavorare con il suo nuovo account. Ad esempio, potresti rendere disponibili nel carrello del nuovo account gli articoli che l'utente ha aggiunto al carrello prima di registrarsi. Per farlo, segui questa procedura:

  1. Quando l'utente si registra, completa la procedura di accesso per il fornitore di servizi di autenticazione dell'utente fino alla chiamata di uno dei metodi FirebaseAuth.signInWith, esclusa questa operazione. Ad esempio, puoi ottenere il token ID di Google, il token di accesso di Facebook o l'indirizzo email e la password dell'utente.
  2. Ricevi 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 di 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. Se attivi questa funzionalità, consenti a Firebase di eliminare automaticamente gli account anonimi che risalgono a oltre 30 giorni fa. Nei progetti in cui è attivata la pulizia automatica, l'autenticazione anonima non viene conteggiata ai fini dei limiti di utilizzo o delle quote di fatturazione.

  • Tutti 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 per l'eliminazione automatica 30 giorni dopo l'attivazione della pulizia automatica.
  • Se disattivi la pulizia automatica, gli account anonimi la cui eliminazione è pianificata rimarranno soggetti a eliminazione.
  • Se esegui l'upgrade di un account anonimo collegandolo a qualsiasi metodo di accesso, l'account non verrà eliminato automaticamente.

Se vuoi sapere quanti utenti saranno interessati prima di attivare questa funzionalità e hai eseguito l'upgrade del progetto a Firebase Authentication with Identity Platform, puoi filtrare in base a 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 Firebase.