Questa pagina è stata tradotta dall'API Cloud Translation.

Eseguire l'autenticazione con Firebase utilizzando account basati su password in C++

Puoi utilizzare Firebase Authentication per consentire agli utenti di eseguire l'autenticazione con a Firebase utilizzando i suoi indirizzi email e password e per gestire basati su password.

Prima di iniziare

Aggiungi Firebase al tuo progetto C++.
Se non hai ancora collegato la tua app al progetto Firebase, puoi farlo da la console Firebase.
Attiva l'accesso con email/password:
1. Nella console Firebase, apri la sezione Auth.
2. Nella scheda Metodo di accesso, attiva l'accesso con Email/password. e fai clic su Salva.

Accedi al corso `firebase::auth::Auth`

La classe Auth è il gateway per tutte le chiamate API.

Aggiungi i file di autenticazione e di intestazione dell'app:
```
#include "firebase/app.h"
#include "firebase/auth.h"
```

Nel codice di inizializzazione, crea una classe firebase::App.

#if defined(__ANDROID__)
  firebase::App* app =
      firebase::App::Create(firebase::AppOptions(), my_jni_env, my_activity);
#else
  firebase::App* app = firebase::App::Create(firebase::AppOptions());
#endif  // defined(__ANDROID__)

Acquista il corso firebase::auth::Auth per firebase::App. Esiste una mappatura uno a uno tra App e Auth.
```
firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);
```

Creare un account basato su password

Per creare un nuovo account utente con una password, completa i seguenti passaggi in codice di accesso dell'app:

Quando un nuovo utente si registra utilizzando il modulo di registrazione della tua app, compila qualsiasi nuovo i passaggi di convalida dell'account richiesti dalla tua app, ad esempio la verifica della la password del nuovo account è stata digitata correttamente e soddisfa le tue esigenze di complessità i tuoi requisiti.
Crea un nuovo account passando l'indirizzo email e la password del nuovo utente a Auth::CreateUserWithEmailAndPassword:
```
firebase::Future<firebase::auth::AuthResult> result =
    auth->CreateUserWithEmailAndPassword(email, password);
```

Se il tuo programma ha un ciclo di aggiornamento che viene eseguito regolarmente (ad esempio, 30 o 60 volte al secondo), puoi controllare i risultati una volta per aggiornamento con Auth::CreateUserWithEmailAndPasswordLastResult:

firebase::Future<firebase::auth::AuthResult> result =
    auth->CreateUserWithEmailAndPasswordLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  if (result.error() == firebase::auth::kAuthErrorNone) {
    const firebase::auth::AuthResult auth_result = *result.result();
    printf("Create user succeeded for email %s\n",
           auth_result.user.email().c_str());
  } else {
    printf("Created user failed with error '%s'\n", result.error_message());
  }
}

Oppure, se il tuo programma è basato su eventi, potresti preferire registra un callback sul Futuro.

di Gemini Advanced.

Eseguire l'accesso di un utente con indirizzo email e password

La procedura per accedere a un utente con una password è simile a quella per creando un nuovo account. Nella funzione di accesso dell'app, svolgi i seguenti passaggi:

Quando un utente accede alla tua app, trasmetti l'indirizzo email e password per firebase::auth::Auth::SignInWithEmailAndPassword:
```
firebase::Future<firebase::auth::AuthResult> result =
    auth->SignInWithEmailAndPassword(email, password);
```

firebase::Future<firebase::auth::AuthResult> result =
    auth->SignInWithEmailAndPasswordLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  if (result.error() == firebase::auth::kAuthErrorNone) {
    const firebase::auth::AuthResult auth_result = *result.result();
    printf("Sign in succeeded for email %s\n",
           auth_result.user.email().c_str());
  } else {
    printf("Sign in failed with error '%s'\n", result.error_message());
  }
}

Oppure, se il tuo programma è basato su eventi, potresti preferire registra un callback sul Futuro.

Registrare una richiamata per Future

Alcuni programmi hanno funzioni Update che vengono chiamate 30 o 60 volte al secondo. Ad esempio, molti giochi seguono questo modello. Questi programmi possono chiamare LastResult per eseguire il polling delle chiamate asincrone. Tuttavia, se il tuo programma è basato su eventi, potresti preferire registrare le funzioni di callback. Una funzione di callback viene chiamata al completamento del Futuro.

void OnCreateCallback(const firebase::Future<firebase::auth::User*>& result,
                      void* user_data) {
  // The callback is called when the Future enters the `complete` state.
  assert(result.status() == firebase::kFutureStatusComplete);

  // Use `user_data` to pass-in program context, if you like.
  MyProgramContext* program_context = static_cast<MyProgramContext*>(user_data);

  // Important to handle both success and failure situations.
  if (result.error() == firebase::auth::kAuthErrorNone) {
    firebase::auth::User* user = *result.result();
    printf("Create user succeeded for email %s\n", user->email().c_str());

    // Perform other actions on User, if you like.
    firebase::auth::User::UserProfile profile;
    profile.display_name = program_context->display_name;
    user->UpdateUserProfile(profile);

  } else {
    printf("Created user failed with error '%s'\n", result.error_message());
  }
}

void CreateUser(firebase::auth::Auth* auth) {
  // Callbacks work the same for any firebase::Future.
  firebase::Future<firebase::auth::AuthResult> result =
      auth->CreateUserWithEmailAndPasswordLastResult();

  // `&my_program_context` is passed verbatim to OnCreateCallback().
  result.OnCompletion(OnCreateCallback, &my_program_context);
}

Se preferisci, la funzione di callback può essere anche una funzione lambda.

void CreateUserUsingLambda(firebase::auth::Auth* auth) {
  // Callbacks work the same for any firebase::Future.
  firebase::Future<firebase::auth::AuthResult> result =
      auth->CreateUserWithEmailAndPasswordLastResult();

  // The lambda has the same signature as the callback function.
  result.OnCompletion(
      [](const firebase::Future<firebase::auth::User*>& result,
         void* user_data) {
        // `user_data` is the same as &my_program_context, below.
        // Note that we can't capture this value in the [] because std::function
        // is not supported by our minimum compiler spec (which is pre C++11).
        MyProgramContext* program_context =
            static_cast<MyProgramContext*>(user_data);

        // Process create user result...
        (void)program_context;
      },
      &my_program_context);
}

Opzione consigliata: abilita la protezione dall'enumerazione delle email

Alcuni metodi Firebase Authentication che prendono gli indirizzi email come parametri errori specifici se l'indirizzo email non viene registrato quando deve essere registrato (ad esempio, quando accedi con un indirizzo email e una password) o registrati quando deve essere inutilizzato (ad esempio, quando si cambia l'indirizzo email di un utente). Sebbene questa opzione possa essere utile per suggerire rimedi specifici agli utenti, può anche essere utilizzata da malintenzionati per scoprire gli indirizzi email registrati dai tuoi utenti.

Per ridurre questo rischio, ti consigliamo di attivare la protezione dall'enumerazione delle email per il tuo progetto usando lo strumento gcloud di Google Cloud. Tieni presente che l'attivazione di questa questa funzionalità cambia il comportamento di segnalazione degli errori di Firebase Authentication: assicurati che la tua app non si basa sugli errori più specifici.

Passaggi successivi

Dopo che un utente ha eseguito l'accesso per la prima volta, viene creato un nuovo account utente e collegati alle credenziali, ovvero nome utente, password, numero o informazioni del provider di autenticazione, ovvero l'utente con cui ha eseguito l'accesso. Questo nuovo viene archiviato come parte del progetto Firebase e può essere utilizzato per identificare a un utente in ogni app del progetto, a prescindere da come esegue l'accesso.

Nelle tue app puoi ottenere le informazioni di base del profilo dell'utente dal Oggetto firebase::auth::User:

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  std::string name = user.display_name();
  std::string email = user.email();
  std::string photo_url = user.photo_url();
  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use firebase::auth::User::Token() instead.
  std::string uid = user.uid();
}

In Firebase Realtime Database e Cloud Storage Regole di sicurezza, puoi ottieni l'ID utente unico dell'utente che ha eseguito l'accesso dalla variabile auth, e usarli per controllare i dati a cui un utente può accedere.

Puoi consentire agli utenti di accedere alla tua app utilizzando più autenticazioni collegando le credenziali del provider di autenticazione a un a un account utente esistente.

Per disconnettere un utente, chiama SignOut():

auth->SignOut();