REST के अनुरोधों की पुष्टि करें

Firebase SDK टूल, आपकी ओर से Firebase Realtime Database के साथ सभी तरह की पुष्टि और कम्यूनिकेशन को मैनेज करते हैं. हालांकि, जब आप ऐसे माहौल में हों जहां क्लाइंट एसडीके मौजूद न हो या आपको डेटाबेस के स्थायी कनेक्शन के ओवरहेड से बचना हो, तो डेटा को पढ़ने और लिखने के लिए, Realtime Database REST API का इस्तेमाल किया जा सकता है.

उपयोगकर्ताओं की पुष्टि करने के लिए, इनमें से कोई एक तरीका अपनाएं:

  1. Google OAuth2 ऐक्सेस टोकन - आम तौर पर, Realtime Database में डेटा को पढ़ने और लिखने की सुविधा, Realtime Database के नियमों से नियंत्रित होती है. हालांकि, आपके पास किसी सर्वर से अपना डेटा ऐक्सेस करने का विकल्प होता है. साथ ही, सेवा खाते से जनरेट किए गए Google OAuth2 ऐक्सेस टोकन की मदद से, उस सर्वर को अपने डेटा को पढ़ने और उसमें बदलाव करने का पूरा ऐक्सेस दिया जा सकता है.

  2. Firebase आईडी टोकन - हो सकता है कि आप किसी उपयोगकर्ता के तौर पर पुष्टि किए गए अनुरोध भी भेजना चाहें. जैसे, क्लाइंट SDK टूल पर Realtime Database नियमों की मदद से ऐक्सेस को सीमित करना. REST API, क्लाइंट SDK टूल से इस्तेमाल किए जाने वाले Firebase आईडी टोकन स्वीकार करता है.

Google OAuth2 ऐक्सेस टोकन

आपके Realtime Database नियमों के मुताबिक, सार्वजनिक तौर पर पढ़ा या लिखा जा सकने वाला कोई भी डेटा, बिना किसी पुष्टि के REST API की मदद से भी पढ़ा और लिखा जा सकता है. हालांकि, अगर आपको अपने सर्वर से Realtime Database के नियमों को बायपास करना है, तो आपको डेटा को पढ़ने और उसमें बदलाव करने के अनुरोधों की पुष्टि करनी होगी. Google OAuth2 के ज़रिए पुष्टि करने के लिए, यह तरीका अपनाना होगा:

  1. ऐक्सेस टोकन जनरेट करें.
  2. उस ऐक्सेस टोकन से पुष्टि करें.

ऐक्सेस टोकन जनरेट करना

Realtime Database REST API, स्टैंडर्ड Google OAuth2 ऐक्सेस टोकन स्वीकार करता है. ऐक्सेस टोकन जनरेट करने के लिए, ऐसे सेवा खाते का इस्तेमाल किया जा सकता है जिसके पास आपके Realtime Database की ज़रूरी अनुमतियां हों. Firebase कंसोल के सेवा खाते सेक्शन में सबसे नीचे मौजूद, नया निजी पासकोड जनरेट करें बटन पर क्लिक करके, सेवा खाते की नई कुंजी फ़ाइल आसानी से जनरेट की जा सकती है. हालांकि, ऐसा तब ही किया जा सकता है, जब आपके पास पहले से कोई कुंजी फ़ाइल न हो.

सेवा खाते की कुंजी वाली फ़ाइल मिलने के बाद, Google API क्लाइंट लाइब्रेरी में से किसी एक का इस्तेमाल करके, Google OAuth2 ऐक्सेस टोकन जनरेट किया जा सकता है. इसके लिए, यहां दिए गए ज़रूरी स्कोप का इस्तेमाल करें:

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

यहां कुछ उदाहरण दिए गए हैं. इनसे पता चलता है कि अलग-अलग भाषाओं में Realtime Database REST API की पुष्टि करने के लिए, Google OAuth2 ऐक्सेस टोकन कैसे बनाए जाते हैं:

Node.js

Node.js के लिए Google API क्लाइंट लाइब्रेरी का इस्तेमाल करना:

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

Java

Java के लिए Google 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.

Python

google-auth लाइब्रेरी का इस्तेमाल करना:

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

ऐक्सेस टोकन की मदद से पुष्टि करना

Realtime Database REST API को पुष्टि किए गए अनुरोध भेजने के लिए, ऊपर जनरेट किए गए Google OAuth2 ऐक्सेस टोकन को Authorization: Bearer <ACCESS_TOKEN> हेडर या access_token=<ACCESS_TOKEN> क्वेरी स्ट्रिंग पैरामीटर के तौर पर पास करें. यहां Ada का नाम पढ़ने के लिए, curl अनुरोध का एक उदाहरण दिया गया है:

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

<DATABASE_NAME> को अपने Realtime Database के नाम से और <ACCESS_TOKEN> को Google OAuth2 ऐक्सेस टोकन से बदलना न भूलें.

अनुरोध पूरा होने पर, 200 OK एचटीटीपी स्टेटस कोड दिखेगा. रिस्पॉन्स में, वापस पाया जा रहा डेटा शामिल होता है:

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

Firebase आईडी टोकन

जब कोई उपयोगकर्ता या डिवाइस Firebase Authentication का इस्तेमाल करके साइन इन करता है, तो Firebase एक आईडी टोकन बनाता है. यह टोकन, उपयोगकर्ता या डिवाइस की पहचान करता है और उसे कई संसाधनों का ऐक्सेस देता है. जैसे, Realtime Database और Cloud Storage. Realtime Database REST API की पुष्टि करने और उस उपयोगकर्ता की ओर से अनुरोध करने के लिए, उस आईडी टोकन का फिर से इस्तेमाल किया जा सकता है.

आईडी टोकन जनरेट करना

क्लाइंट से Firebase आईडी टोकन पाने के लिए, क्लाइंट पर आईडी टोकन वापस पाना में दिया गया तरीका अपनाएं.

ध्यान दें कि आईडी टोकन कुछ समय बाद खत्म हो जाते हैं. इसलिए, उन्हें वापस पाने के बाद, जल्द से जल्द इस्तेमाल किया जाना चाहिए.

आईडी टोकन की मदद से पुष्टि करना

Realtime Database REST API को पुष्टि किए गए अनुरोध भेजने के लिए, ऊपर जनरेट किए गए आईडी टोकन को auth=<ID_TOKEN> क्वेरी स्ट्रिंग पैरामीटर के तौर पर पास करें. यहां Ada का नाम पढ़ने के लिए, curl अनुरोध का एक उदाहरण दिया गया है:

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

<DATABASE_NAME> को अपने Realtime Database के नाम से और <ID_TOKEN> को Firebase आईडी टोकन से बदलना न भूलें.

अनुरोध पूरा होने पर, 200 OK एचटीटीपी स्टेटस कोड दिखेगा. रिस्पॉन्स में, वापस पाया जा रहा डेटा शामिल होता है:

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

लेगसी टोकन

अगर अब भी Firebase से पुष्टि करने के लेगसी टोकन इस्तेमाल किए जा रहे हैं, तो हमारा सुझाव है कि आप REST से पुष्टि करने के तरीके को अपडेट करें. इसके लिए, ऊपर बताए गए पुष्टि करने के तरीकों में से कोई एक तरीका चुनें.

Realtime Database REST API में अब भी, पुष्टि करने के लिए लेगसी टोकन का इस्तेमाल किया जा सकता है. इनमें सीक्रेट भी शामिल हैं. Realtime Database के सीक्रेट, Firebase कंसोल के सेवा खाते सेक्शन में देखे जा सकते हैं.

सीक्रेट, लंबे समय तक इस्तेमाल किए जाने वाले क्रेडेंशियल होते हैं. हमारा सुझाव है कि किसी प्रोजेक्ट से सीक्रेट ऐक्सेस वाले उपयोगकर्ताओं (जैसे, मालिक) को हटाते समय, नया सीक्रेट जनरेट करें और मौजूदा सीक्रेट को रद्द करें.