了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

Bật thực thi Kiểm tra ứng dụng cho các chức năng đám mây

Khi bạn hiểu cách Kiểm tra ứng dụng sẽ ảnh hưởng đến người dùng của mình và bạn đã sẵn sàng tiếp tục, bạn có thể bật thực thi Kiểm tra ứng dụng.

Kích hoạt thực thi

Để bắt đầu thực thi các yêu cầu về mã thông báo Kiểm tra ứng dụng trong Chức năng đám mây có thể gọi của bạn, hãy sửa đổi các chức năng của bạn để kiểm tra mã thông báo Kiểm tra ứng dụng hợp lệ, như minh họa bên dưới. Khi bạn kích hoạt thực thi, tất cả các yêu cầu chưa được xác minh sẽ bị từ chối.

  1. Cài đặt SDK chức năng đám mây.

    Node.js (thế hệ thứ nhất)

    Cập nhật phần phụ thuộc firebase-functions của dự án lên phiên bản 4.0.0 trở lên:

    npm install firebase-functions@">=4.0.0"
    

    Node.js (thế hệ thứ 2)

    Cập nhật phần phụ thuộc firebase-functions của dự án lên phiên bản 4.0.0 trở lên:

    npm install firebase-functions@">=4.0.0"
    

    Python (xem trước)

    Thêm firebase-functions vào functions/requirements.txt :

    firebase-functions >= 0.1.0
    

    Sau đó, cập nhật các phụ thuộc trong môi trường ảo của dự án của bạn:

    ./venv/bin/pip install -r requirements.txt
    
  2. Bật tùy chọn thời gian chạy thực thi Kiểm tra ứng dụng cho chức năng của bạn:

    Node.js (thế hệ thứ nhất)

    const functions = require("firebase-functions/v1");
    
    exports.yourV1CallableFunction = functions
      .runWith({
          enforceAppCheck: true, // Reject requests with missing or invalid App Check tokens.
      })
      .https.onCall((data, context) => {
            // context.app contains data from App Check, including the app ID.
            // Your function logic follows.
            ...
      });
    

    Node.js (thế hệ thứ 2)

    const { onCall } = require("firebase-functions/v2/https");
    
    exports.yourV2CallableFunction = onCall(
      {
        enforceAppCheck: true, // Reject requests with missing or invalid App Check tokens.
      },
      (request) => {
        // request.app contains data from App Check, including the app ID.
        // Your function logic follows.
        ...
      }
    );
    

    Python (xem trước)

    from firebase_functions import https_fn
    
    @https_fn.on_call(
        enforce_app_check=True  # Reject requests with missing or invalid App Check tokens.
    )
    def your_callable_function(req: https_fn.CallableRequest) -> https_fn.Response:
        # req.app contains data from App Check, including the app ID.
        # Your function logic follows.
        ...
    
  3. Triển khai lại các chức năng của bạn:

    firebase deploy --only functions
    

Khi những thay đổi này được triển khai, Chức năng đám mây có thể gọi của bạn sẽ yêu cầu mã thông báo Kiểm tra ứng dụng hợp lệ. SDK ứng dụng khách của Cloud Function tự động đính kèm mã thông báo Kiểm tra ứng dụng khi bạn gọi một hàm có thể gọi.

Bảo vệ phát lại (beta)

Để bảo vệ chức năng có thể gọi khỏi các cuộc tấn công phát lại, bạn có thể sử dụng mã thông báo Kiểm tra ứng dụng sau khi xác minh. Khi mã thông báo được sử dụng, nó không thể được sử dụng lại.

Lưu ý rằng việc sử dụng tính năng bảo vệ phát lại sẽ thêm một chuyến đi vòng quanh mạng để xác minh mã thông báo và do đó, thêm độ trễ cho lệnh gọi chức năng đám mây. Vì lý do này, hầu hết các ứng dụng thường chỉ kích hoạt tính năng bảo vệ phát lại trên các điểm cuối đặc biệt nhạy cảm.

Để sử dụng mã thông báo, hãy đặt consumeAppCheckToken thành true trong định nghĩa chức năng của bạn:

Node.js (thế hệ thứ nhất)

const functions = require("firebase-functions/v1");

exports.yourV1CallableFunction = functions
  .runWith({
      enforceAppCheck: true, // Reject requests with missing or invalid App Check tokens.
      consumeAppCheckToken: true  // Consume the token after verification.
  })
  .https.onCall((data, context) => {
      // context.app contains data from App Check, including the app ID.
      // Your function logic follows.
      ...
  });

Node.js (thế hệ thứ 2)

const { onCall } = require("firebase-functions/v2/https");

exports.yourV2CallableFunction = onCall(
  {
    enforceAppCheck: true, // Reject requests with missing or invalid App Check tokens.
    consumeAppCheckToken: true  // Consume the token after verification.
  },
  (request) => {
    // request.app contains data from App Check, including the app ID.
    // Your function logic follows.
    ...
  }
);

Khi bật tính năng này cho một Chức năng đám mây cụ thể, bạn cũng phải cập nhật mã máy khách của ứng dụng để nhận mã thông báo sử dụng có giới hạn tiêu hao khi bạn gọi chức năng:

Nhanh

let options = HTTPSCallableOptions(requireLimitedUseAppCheckTokens: true)
let yourCallableFunction =
    Functions.functions().httpsCallable("yourCallableFunction", options: options)
do {
    let result = try await yourCallableFunction.call()
} catch {
    // ...
}

Web version 9

import { getFunctions, httpsCallable } from "firebase/functions";

const yourCallableFunction = httpsCallable(
  getFunctions(),
  "yourCallableFunction",
  { limitedUseAppCheckTokens: true },
);
await yourCallableFunction();

Kotlin+KTX

val yourCallableFunction = Firebase.functions.getHttpsCallable("yourCallableFunction") {
    limitedUseAppCheckTokens = true
}
val result = yourCallableFunction.call().await()

Java

HttpsCallableReference yourCallableFunction = FirebaseFunctions.getInstance().getHttpsCallable(
        "yourCallableFunction",
        new HttpsCallableOptions.Builder()
                .setLimitedUseAppCheckTokens(true)
                .build()
);
Task<HttpsCallableResult> result = yourCallableFunction.call();