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 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 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) (in genere <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 la 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.11.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 la Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.

    (Alternativa)  Aggiungere dipendenze della libreria Firebase senza utilizzare la BoM

    Se scegli di non utilizzare la Firebase BoM, devi specificare la versione di ogni libreria Firebase nella riga di 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 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:24.0.1")
    }
  3. Se non hai ancora collegato l'app al progetto Firebase, fallo da console.Firebase
  4. Attiva l'autenticazione anonima:
    1. Nella Firebase console, apri la sezione Autenticazione.
    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. Quando attivi questa impostazione, gli account anonimi che risalgono a oltre 30 giorni fa verranno eliminati automaticamente eliminati. Nei progetti con la pulizia automatica attivata, l'autenticazione anonima non rientrerà più nel conteggio dei limiti di utilizzo o delle quote di fatturazione. Consulta Pulizia automatica.

Eseguire l'autenticazione con Firebase in modo anonimo

Quando un utente che non ha eseguito l'accesso utilizza una funzionalità dell'app che richiede l'autenticazione con Firebase, esegui l'accesso dell'utente 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 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 utente:

    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 voler consentirgli di continuare a lavorare con il suo nuovo account. Ad esempio, potresti voler rendere disponibili nel carrello degli acquisti del nuovo account gli articoli che l'utente ha aggiunto al carrello degli acquisti prima di registrarsi. Per farlo, completa i seguenti passaggi:

  1. Quando l'utente si registra, completa il flusso di accesso per il provider di autenticazione dell'utente fino alla chiamata di uno dei metodi FirebaseAuth.signInWith, ma non includerla. Ad esempio, recupera il token ID Google dell'utente, token di accesso di Facebook o indirizzo email e password.
  2. Recupera 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 con 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 che risalgono a oltre 30 giorni fa. Nei progetti con la pulizia automatica attivata, l'autenticazione anonima non rientrerà nel conteggio 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 potranno essere eliminati automaticamente 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 in base a is_anon in Cloud Logging.

Passaggi successivi

Ora che gli utenti possono eseguire l'autenticazione con Firebase, puoi controllare il loro accesso ai dati nel database Firebase utilizzando le regole di Firebase.