Autentica le richieste REST

Gli SDK Firebase gestiscono per tuo conto tutta l'autenticazione e la comunicazione con il Firebase Realtime Database Tuttavia, quando ti trovi in un ambiente che non dispone di un SDK client o vuoi evitare il sovraccarico di una connessione di database persistente, puoi utilizzare l' Realtime Database API REST per leggere e scrivere dati.

Autentica gli utenti utilizzando uno dei seguenti metodi:

1. Token di accesso Google OAuth2 : in genere, la possibilità di leggere e scrivere in Realtime Database è regolata dalle Realtime Database Rules. Tuttavia, puoi accedere ai tuoi dati da un server e concedere a quest'ultimo l'accesso completo in lettura e scrittura ai tuoi dati con un token di accesso Google OAuth2 generato da un account di servizio.

2. Token ID Firebase : potresti anche voler inviare richieste autenticate come singolo utente, ad esempio limitando l'accesso con le regole Realtime Database sugli SDK client. L'API REST accetta gli stessi token ID Firebase utilizzati dagli SDK client.

Token di accesso Google OAuth2

Tutti i dati leggibili o scrivibili pubblicamente in base alle tue Realtime Database regole sono anche leggibili e scrivibili tramite l'API REST senza autenticazione. Tuttavia, se vuoi che il tuo server ignori le regole di Realtime Database, devi autenticare le richieste di lettura e scrittura. L'autenticazione tramite Google OAuth2 richiede i seguenti passaggi:

1. Genera un token di accesso.
2. Autenticati con il token di accesso.

Genera un token di accesso

L'Realtime Database API REST accetta i token di accesso Google OAuth2standard. I token di accesso possono essere generati utilizzando un account di servizio con le autorizzazioni appropriate per Realtime Database. Se non ne hai già uno, puoi generare facilmente un nuovo file di chiavi dell'account di servizio facendo clic sul puls0}Genera nuova chiave privata nella parte inferiore della sezione Account di servizio della console Firebase.

Una volta che hai un file di chiavi dell'account di servizio, puoi utilizzare una delle librerie client delle API di Google per generare un token di accesso Google OAuth2 con i seguenti ambiti obbligatori:

• https://www.googleapis.com/auth/userinfo.email
• https://www.googleapis.com/auth/firebase.database

Di seguito sono riportate alcune implementazioni di esempio che mostrano come creare token di accesso Google OAuth2 per l'autenticazione all'API REST Realtime Database in una varietà di linguaggi:

var {google} = require("googleapis");

// Load the service account key JSON file.
var serviceAccount = require("path/to/serviceAccountKey.json");

// Define the required scopes.
var scopes = [
  "https://www.googleapis.com/auth/userinfo.email",
  "https://www.googleapis.com/auth/firebase.database"
];

// Authenticate a JWT client with the service account.
var jwtClient = new google.auth.JWT(
  serviceAccount.client_email,
  null,
  serviceAccount.private_key,
  scopes
);

// Use the JWT client to generate an access token.
jwtClient.authorize(function(error, tokens) {
  if (error) {
    console.log("Error making request to generate access token:", error);
  } else if (tokens.access_token === null) {
    console.log("Provided service account does not have permission to generate access tokens");
  } else {
    var accessToken = tokens.access_token;

    // See the "Using the access token" section below for information
    // on how to use the access token to send authenticated requests to
    // the Realtime Database REST API.
  }
});

// Load the service account key JSON file
FileInputStream serviceAccount = new FileInputStream("path/to/serviceAccountKey.json");

// Authenticate a Google credential with the service account
GoogleCredential googleCred = GoogleCredential.fromStream(serviceAccount);

// Add the required scopes to the Google credential
GoogleCredential scoped = googleCred.createScoped(
    Arrays.asList(
      "https://www.googleapis.com/auth/firebase.database",
      "https://www.googleapis.com/auth/userinfo.email"
    )
);

// Use the Google credential to generate an access token
scoped.refreshToken();
String token = scoped.getAccessToken();

// See the "Using the access token" section below for information
// on how to use the access token to send authenticated requests to the
// Realtime Database REST API.

from google.oauth2 import service_account
from google.auth.transport.requests import AuthorizedSession

# Define the required scopes
scopes = [
  "https://www.googleapis.com/auth/userinfo.email",
  "https://www.googleapis.com/auth/firebase.database"
]

# Authenticate a credential with the service account
credentials = service_account.Credentials.from_service_account_file(
    "path/to/serviceAccountKey.json", scopes=scopes)

# Use the credentials object to authenticate a Requests session.
authed_session = AuthorizedSession(credentials)
response = authed_session.get(
    "https://<DATABASE_NAME>.firebaseio.com/users/ada/name.json")

# Or, use the token directly, as described in the "Authenticate with an
# access token" section below. (not recommended)
request = google.auth.transport.requests.Request()
credentials.refresh(request)
access_token = credentials.token

Autenticati con un token di accesso

Per inviare richieste autenticate all'API REST Realtime Database, trasmetti il token di accesso Google OAuth2 generato sopra come intestazione Authorization: Bearer <ACCESS_TOKEN> o come parametro della stringa di query access_token=<ACCESS_TOKEN>. Di seguito è riportata una richiesta curl di esempio per leggere il nome di Ada:

curl "https://<DATABASE_NAME>.firebaseio.com/users/ada/name.json?access_token=<ACCESS_TOKEN>"

Assicurati di sostituire <DATABASE_NAME> con il nome di Realtime Database e <ACCESS_TOKEN> con un token di accesso Google OAuth2.

Una richiesta riuscita sarà indicata da un codice di stato HTTP 200 OK. La risposta contiene i dati recuperati:

{"first":"Ada","last":"Lovelace"}

Token ID Firebase

Quando un utente o un dispositivo esegue l'accesso utilizzando Firebase Authentication, Firebase crea un token ID corrispondente che lo identifica in modo univoco e gli concede l'accesso a diverse risorse, come Realtime Database e Cloud Storage. Puoi riutilizzare questo token ID per autenticare l'API REST Realtime Databaseed effettuare richieste per conto dell'utente.

Genera un token ID

Per recuperare il token ID Firebase dal client, segui i passaggi descritti in Recuperare i token ID sui client.

Tieni presente che i token ID scadono dopo un breve periodo di tempo e devono essere utilizzati il prima possibile dopo il recupero.

Autenticati con un token ID

Per inviare richieste autenticate all'API REST Realtime Database, trasmetti il token ID generato sopra come parametro della stringa di query auth=<ID_TOKEN>. Di seguito è riportata una richiesta curl di esempio per leggere il nome di Ada:

curl "https://<DATABASE_NAME>.firebaseio.com/users/ada/name.json?auth=<ID_TOKEN>"

Assicurati di sostituire <DATABASE_NAME> con il nome di Realtime Database e <ID_TOKEN> con un token ID Firebase.

Una richiesta riuscita sarà indicata da un codice di stato HTTP 200 OK. La risposta contiene i dati recuperati:

{"first":"Ada","last":"Lovelace"}

Token precedenti

Se utilizzi ancora i token di autenticazione Firebase precedenti, ti consigliamo di aggiornare l'autenticazione REST a uno dei metodi di autenticazione descritti sopra.

L'API REST di Realtime Database supporta ancora l'autenticazione tramite i token di autenticazione precedenti, inclusi i dati segreti. I dati segreti di Realtime Database sono disponibili nella sezione Account di servizio della console Firebase.

I dati segreti sono credenziali a lunga durata. Ti consigliamo di generare un nuovo dato segreto e di revocare quello esistente quando rimuovi gli utenti con accesso segreto (ad esempio i proprietari) da un progetto.