Starting November 2, 2026, Firebase App Check enforcement will be required to use Firebase AI Logic. Learn more.

Model updates:

The latest Gemini models, like Gemini 3.8 Flash, are available to use with Firebase AI Logic! Learn more.
Gemini 2.5 models are limited to projects that actively used them in the past. For the Agent Platform Gemini API, these models will shut down for all projects in October 2026. To avoid service disruptions, update to a newer model (like gemini-3.8-flash or gemini-3.1-flash-image). Any stable Gemini Live API 2.5 models are not impacted. Learn more.

Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

ป้องกันการละเมิด Gemini API ด้วย Firebase App Check

เมื่อคุณเรียกใช้ API จากแอปบนอุปกรณ์เคลื่อนที่หรือเว็บแอปโดยตรง API จะเสี่ยงต่อการ ถูกไคลเอ็นต์ที่ไม่ได้รับอนุญาตละเมิด หากต้องการโทรหา Gemini API โดยตรง จากแอปบนอุปกรณ์เคลื่อนที่หรือเว็บแอป คุณต้องช่วยปกป้องแอปจากการละเมิดโดยใช้ Firebase AI Logic และ บังคับใช้ Firebase App Check เมื่อบังคับใช้ App Check ระบบจะอนุญาตเฉพาะคำขอขาเข้าที่ได้รับการยืนยันว่ามาจาก แอปจริงของคุณและ/หรืออุปกรณ์ที่ไม่มีการดัดแปลง

ไปที่วิธีการตั้งค่า

Firebase AI Logic มีพร็อกซีเกตเวย์ที่ช่วยให้คุณผสานรวมกับ Firebase App Check และปกป้อง Gemini API เมื่อแอปบนอุปกรณ์เคลื่อนที่และเว็บแอปเรียกใช้โดยตรง เมื่อบังคับใช้ App Check กับ Firebase AI Logic จะช่วยปกป้องทั้ง Gemini Developer API และ Agent Platform Gemini API (formerly Vertex AI)

App Check ยังรองรับFirebase AI Logic การป้องกันการเล่นซ้ำ ซึ่งหมายความว่าใช้โทเค็น App Check ได้เพียงครั้งเดียว

สำคัญอย่างยิ่งที่ต้องบังคับใช้ App Check โดยเร็วที่สุด โดยเฉพาะอย่างยิ่งก่อนที่คุณจะส่งแอปไปยังระบบควบคุมซอร์สโค้ดที่พร้อมใช้งานแบบสาธารณะ แชร์แอป หรือทำให้แอปพร้อมใช้งานแบบสาธารณะ

ตั้งแต่ต้นเดือนกรกฎาคม 2026 เป็นต้นไป ในระหว่างเวิร์กโฟลว์การตั้งค่าใน Firebase คอนโซล Firebase จะบังคับใช้ App Check โดยอัตโนมัติสำหรับ Firebase AI Logic หากคุณได้ตั้งค่า Firebase AI Logic ในโปรเจ็กต์ Firebase ก่อนช่วงต้นเดือนกรกฎาคม 2026 (หรือหากไม่ได้บังคับใช้ App Check ด้วยเหตุผลอื่น ) คุณจะบังคับใช้ App Check ด้วยตนเองได้ หากต้องการประสบการณ์การเริ่มต้นใช้งานที่ง่ายขึ้นหรือการพัฒนาในเครื่อง คุณสามารถบังคับใช้ App Check แล้วตั้งค่า App Check ผู้ให้บริการแก้ไขข้อบกพร่อง

ตั้งแต่วันที่ 2 พฤศจิกายน 2026 เป็นต้นไป Firebase App Checkการบังคับใช้จะจำเป็นต้องใช้ Firebase AI Logic ดูข้อมูลเพิ่มเติม

สรุปภาพรวมเกี่ยวกับวิธีการทำงานของ App Check

เมื่อใช้ App Check อุปกรณ์ที่เรียกใช้แอปของคุณจะใช้ผู้ให้บริการการรับรองแอปหรืออุปกรณ์ ซึ่งจะยืนยันข้อมูลต่อไปนี้อย่างใดอย่างหนึ่งหรือทั้ง 2 อย่าง

คำขอมาจากแอปที่แท้จริงของคุณ
คำขอมาจากอุปกรณ์ของแท้ที่ไม่มีการดัดแปลง

การรับรองนี้จะแนบไปกับทุกคำขอที่แอปของคุณส่งโดยใช้ SDK Firebase AI Logic เมื่อมีการบังคับใช้ App Check ระบบจะปฏิเสธคำขอจากไคลเอ็นต์ ที่ไม่มีการรับรองที่ถูกต้อง รวมถึงคำขอที่มาจาก แอปหรือแพลตฟอร์มที่คุณไม่ได้ให้สิทธิ์

เมื่อตั้งค่า App Check ให้พิจารณาเพิ่มการป้องกันการเล่นซ้ำ ซึ่งจะทำให้โทเค็น App Check ใช้ได้ครั้งเดียวเท่านั้น ตัวเลือกนี้จะช่วยเพิ่มการปกป้องนอกเหนือจากการปกป้องพื้นฐาน และช่วยให้คุณกำหนดระดับการปกป้องที่เหมาะสมสำหรับแอปและ กรณีการใช้งานของคุณได้

คุณดูข้อมูลโดยละเอียดเกี่ยวกับ App Check ได้ในเอกสารประกอบ ซึ่งรวมถึงคำอธิบายของผู้ให้บริการรับรอง ตลอดจนโควต้าและขีดจำกัดที่เกี่ยวข้อง

ตั้งค่า App Check

วิธีการต่อไปนี้ได้รับการเพิ่มประสิทธิภาพสำหรับการตั้งค่าFirebase App Check การบังคับใช้สำหรับ Firebase AI Logic

ขั้นตอนที่ 1: บังคับใช้ App Check

ตั้งแต่ช่วงต้นเดือนกรกฎาคม 2026 เป็นต้นไป ในระหว่างเวิร์กโฟลว์การตั้งค่าแบบมีคำแนะนำในFirebaseคอนโซล Firebase จะบังคับใช้ Firebase App Check โดยอัตโนมัติ สำหรับ Firebase AI Logic เพื่อช่วยปกป้อง Gemini API

อย่างไรก็ตาม หากคุณได้ตั้งค่า Firebase AI Logic ในโปรเจ็กต์ Firebase ก่อนช่วงต้นเดือนกรกฎาคม 2026 (หรือไม่ได้บังคับใช้ App Check ด้วยเหตุผลอื่น) คุณจะบังคับใช้ App Check ด้วยตนเองได้โดยใช้คำสั่งต่อไปนี้

ตรวจสอบว่ามีการบังคับใช้ App Check กับ Firebase AI Logic แล้วหรือไม่
1. ในFirebaseคอนโซล ให้ไปที่ความปลอดภัย > App Check > แท็บ API
2. ค้นหาแถวของ Firebase AI Logic หากระบุว่า Unenforced ให้ทำตามวิธีการที่เหลือต่อไป
คลิกแถวของ Firebase AI Logic แล้วคุณจะเห็นกราฟเมตริก คลิกตั้งค่าใต้กราฟเหล่านั้น
ในหน้าจอแรกของกล่องโต้ตอบ (การป้องกันพื้นฐาน) ให้เลือก บังคับใช้ แล้วคลิกต่อไป
ในหน้าจอถัดไป (การป้องกันการเล่นซ้ำ) ให้เลือกปิดใช้ แล้วคลิกต่อไป

หมายเหตุ: การตั้งค่าการป้องกันการเล่นซ้ำ กำหนดให้คุณต้องเปิดใช้โทเค็นแบบจำกัดการใช้งานในแอป เมื่อทำ เสร็จแล้ว คุณจะกลับมาที่Firebaseคอนโซลในภายหลังและตั้งค่า ตัวเลือกการป้องกันการเล่นซ้ำได้
ในหน้าจอสุดท้าย โปรดอ่านข้อควรพิจารณาในการบังคับใช้ App Check เพื่อให้แน่ใจว่าคุณพร้อมที่จะบังคับใช้ App Check หากพร้อมแล้ว ให้คลิกดำเนินการต่อ

คุณไม่จำเป็นต้องลงทะเบียนแอปหากต้องการบังคับใช้ App Check และใช้ผู้ให้บริการแก้ไขข้อบกพร่องกับ Firebase AI Logic เท่านั้นในแอปก่อนเวอร์ชันที่ใช้งานจริง อย่างไรก็ตาม เมื่อพร้อมที่จะเผยแพร่แอปไปยัง ผู้ใช้ปลายทางแล้ว คุณจะต้องลงทะเบียนแอปเป็นส่วนหนึ่งของการตั้งค่า ผู้ให้บริการการรับรองเวอร์ชันที่ใช้งานจริง (เช่น App Attest, Play Integrity หรือ reCAPTCHA Enterprise)

ขั้นตอนที่ 2: ตั้งค่าผู้ให้บริการแก้ไขข้อบกพร่องสำหรับการพัฒนาในเครื่อง

สำหรับการพัฒนาในเครื่อง คุณสามารถตั้งค่าApp Check ผู้ให้บริการแก้ไขข้อบกพร่องและ ยังคงบังคับใช้ App Check สำหรับ Firebase AI Logic ได้

Swift

วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปในโปรแกรมจำลอง แบบอินเทอร์แอกทีฟ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้

ในโปรเจ็กต์ Xcode ให้นำเข้า FirebaseAppCheck และเริ่มต้น App Check ด้วยโรงงานผู้ให้บริการแก้ไขข้อบกพร่องก่อนกำหนดค่า Firebase

import SwiftUI
import FirebaseCore
import FirebaseAppCheck

@main
struct YourApp: App {
  init() {
    let providerFactory = AppCheckDebugProviderFactory()
    AppCheck.setAppCheckProviderFactory(providerFactory)
    FirebaseApp.configure()
  }

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้
1. เปิดแอปในเครื่องจำลองหรือบนอุปกรณ์ทดสอบ
2. เปิดคอนโซล Xcode แล้วมองหาApp Checkโทเค็นการแก้ไขข้อบกพร่อง เช่น
```
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
```
3. คัดลอกโทเค็น (เช่น 123a4567-b89c-12d3-e456-789012345678)
ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
1. ในคอนโซล Firebase ให้ไปที่แท็บความปลอดภัย > App Check > แอป
2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
3. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

โปรดดูรายละเอียดเกี่ยวกับผู้ให้บริการแก้ไขข้อบกพร่อง (รวมถึงวิธีรับโทเค็นการแก้ไขข้อบกพร่องใหม่) ในเอกสารApp Checkอย่างเป็นทางการ

Kotlin

วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปในโปรแกรมจำลองแบบโต้ตอบ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้

ในการสร้างการแก้ไขข้อบกพร่อง ให้กำหนดค่า App Check เพื่อใช้โรงงานผู้ให้บริการแก้ไขข้อบกพร่อง ดังนี้
```
Firebase.initialize(context = this)
Firebase.appCheck.installAppCheckProviderFactory(
    DebugAppCheckProviderFactory.getInstance(),
)MainActivity.kt
```
รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้
1. เรียกใช้แอปในโปรแกรมจำลองหรือในอุปกรณ์ทดสอบ
2. มองหาApp Checkโทเค็นการแก้ไขข้อบกพร่องในบันทึก เช่น
```
D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
```
3. คัดลอกโทเค็น (เช่น 123a4567-b89c-12d3-e456-789012345678)
ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
1. ในคอนโซล Firebase ให้ไปที่แท็บความปลอดภัย > App Check > แอป
2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
3. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

Java

ในการสร้างการแก้ไขข้อบกพร่อง ให้กำหนดค่า App Check เพื่อใช้โรงงานผู้ให้บริการแก้ไขข้อบกพร่อง ดังนี้
```
FirebaseApp.initializeApp(/*context=*/ this);
FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
firebaseAppCheck.installAppCheckProviderFactory(
        DebugAppCheckProviderFactory.getInstance());MainActivity.java
```
รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้
1. เรียกใช้แอปในโปรแกรมจำลองหรือในอุปกรณ์ทดสอบ
2. มองหาApp Checkโทเค็นการแก้ไขข้อบกพร่องในบันทึก เช่น
```
D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
```
3. คัดลอกโทเค็น (เช่น 123a4567-b89c-12d3-e456-789012345678)
ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
1. ในคอนโซล Firebase ให้ไปที่แท็บความปลอดภัย > App Check > แอป
2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
3. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

Web

วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปจาก localhost แบบอินเทอร์แอกทีฟ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้

ในบิลด์การแก้ไขข้อบกพร่อง ให้เปิดใช้โหมดแก้ไขข้อบกพร่องโดยตั้งค่า self.FIREBASE_APPCHECK_DEBUG_TOKENเป็น true ก่อนที่จะเริ่มต้น App Check เช่น
```
self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
initializeAppCheck(app, { /* App Check options */ });
```
ไปที่เว็บแอปในเครื่องแล้วเปิดเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์ คุณจะเห็นโทเค็นการแก้ไขข้อบกพร่องใน คอนโซลดีบัก
```
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
You will need to safelist it in the Firebase console for it to work.
```
ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
1. ในคอนโซล Firebase ให้ไปที่แท็บความปลอดภัย > App Check > แอป
2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
3. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

Dart

iOS+

เปิดใช้งาน App Check ด้วยผู้ให้บริการแก้ไขข้อบกพร่องทันทีหลังจากที่คุณ เริ่มต้นแอป Firebase

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    // Set appleProvider to `AppleProvider.debug`
    appleProvider: AppleProvider.debug,
  );
  runApp(App());
}

เปิดใช้การบันทึกการแก้ไขข้อบกพร่องในโปรเจ็กต์ Xcode โดยทำดังนี้
1. เปิดผลิตภัณฑ์ > รูปแบบ > แก้ไขรูปแบบ
2. เลือกเรียกใช้จากเมนูด้านซ้าย แล้วเลือกแท็บ อาร์กิวเมนต์
3. ในส่วนอาร์กิวเมนต์ที่ส่งเมื่อตอนเริ่ม ให้เพิ่ม -FIRDebugEnabled
รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้
1. เปิด ios/Runner.xcworkspace ด้วย Xcode แล้วเรียกใช้แอปใน โปรแกรมจำลองหรือในอุปกรณ์ทดสอบ
2. เปิดคอนโซล Xcode แล้วมองหาApp Checkโทเค็นการแก้ไขข้อบกพร่อง เช่น
```
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
```
3. คัดลอกโทเค็น (เช่น 123a4567-b89c-12d3-e456-789012345678)
ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
1. ในคอนโซล Firebase ให้ไปที่แท็บความปลอดภัย > App Check > แอป
2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
3. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

Android

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    // Set androidProvider to `AndroidProvider.debug`
    androidProvider: AndroidProvider.debug,
  );
  runApp(App());
}

รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้
1. เรียกใช้แอปในโปรแกรมจำลองหรือในอุปกรณ์ทดสอบ
2. มองหาApp Checkโทเค็นการแก้ไขข้อบกพร่องในบันทึก เช่น
```
D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
```
3. คัดลอกโทเค็น (เช่น 123a4567-b89c-12d3-e456-789012345678)
ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
1. ในคอนโซล Firebase ให้ไปที่แท็บความปลอดภัย > App Check > แอป
2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
3. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

เว็บ

วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปจาก localhostแบบอินเทอร์แอกทีฟ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้

ในไฟล์ web/index.html ให้เปิดใช้โหมดแก้ไขข้อบกพร่องโดยตั้งค่า self.FIREBASE_APPCHECK_DEBUG_TOKEN เป็น true ดังนี้
```
<body>
  <script>
    self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
  </script>

  ...

</body>
```
เรียกใช้เว็บแอปในเครื่องและเปิดเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์ ใน คอนโซลดีบัก คุณจะเห็นโทเค็นการแก้ไขข้อบกพร่อง
```
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
You will need to safelist it in the Firebase console for it to work.
```
โทเค็นนี้จะจัดเก็บไว้ในเบราว์เซอร์ของคุณในเครื่อง และจะใช้ทุกครั้งที่คุณใช้แอปในเบราว์เซอร์เดียวกันในเครื่องเดียวกัน หากต้องการใช้โทเค็นในเบราว์เซอร์อื่นหรือในเครื่องอื่น ให้ตั้งค่า self.FIREBASE_APPCHECK_DEBUG_TOKEN เป็นสตริงโทเค็นแทน true
ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
1. ในคอนโซล Firebase ให้ไปที่แท็บความปลอดภัย > App Check > แอป
2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
3. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

Unity

สร้างโทเค็นการแก้ไขข้อบกพร่องในFirebaseคอนโซลโดยทำดังนี้
1. ในFirebaseคอนโซล ให้ไปที่ความปลอดภัย > App Check > แท็บแอป
2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
3. ทำตามวิธีการบนหน้าจอเพื่อสร้างโทเค็นการแก้ไขข้อบกพร่องใหม่

เพิ่มโค้ดต่อไปนี้ในโค้ดการเริ่มต้นของแอป

using Firebase.AppCheck;

void InitializeFirebase() {
  // Configure the Debug Provider factory with your debug token.
  DebugAppCheckProviderFactory.Instance.SetDebugToken("YOUR_DEBUG_TOKEN");

  // Set App Check to use the debug provider factory
  FirebaseAppCheck.SetAppCheckProviderFactory(
    DebugAppCheckProviderFactory.Instance);

  // Proceed to initialize Firebase as normal
}

ขั้นตอนที่ 3: ตั้งค่า App Check สำหรับผู้ใช้ปลายทางและการผลิต

เมื่อพร้อมที่จะเผยแพร่แอปต่อผู้ใช้ปลายทาง คุณจะต้องลงทะเบียน แอปและตั้งค่าผู้ให้บริการการรับรองเวอร์ชันที่ใช้งานจริง (เช่น App Attest, Play Integrity หรือ reCAPTCHA Enterprise)

เลือกผู้ให้บริการการรับรองการผลิต และทําตามวิธีการติดตั้งใช้งาน ที่ลิงก์ต่อไปนี้
- แพลตฟอร์ม Apple: DeviceCheck หรือ App Attest หรือ reCAPTCHA Enterprise
- Android Play Integrity หรือ reCAPTCHA Enterprise
- เว็บ reCAPTCHA Enterprise
- Flutter: รองรับ ผู้ให้บริการทั้งหมดข้างต้น รวมถึง reCAPTCHA Enterprise
  หากคุณใช้ปลั๊กอินเวอร์ชันเก่า โปรดดู หมายเหตุเกี่ยวกับการสร้างอินสแตนซ์พิเศษด้านล่าง สำหรับ Flutter และ App Check
- Unity: รองรับ ผู้ให้บริการทั้งหมดข้างต้น (รองรับ reCAPTCHA Enterprise เร็วๆ นี้)
โปรดทราบว่าหากผู้ให้บริการการรับรองเหล่านี้ไม่เพียงพอต่อความต้องการของคุณ คุณสามารถใช้ผู้ให้บริการที่กำหนดเองซึ่งใช้ผู้ให้บริการการรับรองบุคคลที่สามหรือเทคนิคการรับรองของคุณเอง
(แนะนำ) เพิ่มการปกป้องโดยเพิ่มการป้องกันการเล่นซ้ำ ซึ่งหมายความว่าจะใช้โทเค็น App Check ได้เพียงครั้งเดียว

ต้องมีการเริ่มต้นอินสแตนซ์พิเศษสำหรับ Flutter หากใช้ปลั๊กอินเวอร์ชันเก่า

คลิกผู้ให้บริการ Gemini API เพื่อดูเนื้อหาและโค้ดของผู้ให้บริการรายนั้นๆ ในหน้านี้

คุณต้องสร้างอินสแตนซ์พิเศษนี้ก็ต่อเมื่อแอปใช้ปลั๊กอิน Flutter firebase_ai v3.11.0 หรือต่ำกว่า (BoM v4.12.0 หรือต่ำกว่า) หากแอปใช้ปลั๊กอินเวอร์ชันใหม่กว่า ก็ไม่จำเป็นต้องสร้างอินสแตนซ์พิเศษนี้

หากบังคับใช้ App Check ในแอป Flutter ที่ใช้ปลั๊กอินเวอร์ชันเก่า คุณต้องส่ง App Check อย่างชัดเจนในระหว่างการเริ่มต้น เช่น


// ...

// During instantiation, enable usage of limited-use tokens
final ai = await FirebaseAI.googleAI(
  // For Flutter plugin v3.11.0 or lower (BoM v4.12.0 or lower), pass in App Check explicitly.
  appCheck: FirebaseAppCheck.instance,
  useLimitedUseAppCheckTokens: true,
);

// ...

เพิ่มการป้องกันโดยเพิ่มการป้องกันการเล่นซ้ำ

เราขอแนะนำให้ใช้ SDK เวอร์ชันล่าสุด แต่ โปรดตรวจสอบว่าคุณใช้เวอร์ชันใดเวอร์ชันหนึ่งต่อไปนี้เป็นอย่างน้อยเพื่อใช้ การป้องกันการเล่นซ้ำ
แพลตฟอร์ม Apple v12.2.0 ขึ้นไป | Android BoM v34.14.0 ขึ้นไป (App Check v19.1.0 ขึ้นไป) | Web v12.14.0 ขึ้นไป | Flutter v4.15.0 ขึ้นไป (App Check v4.10.0 ขึ้นไป) | Unity v13.12.0 ขึ้นไป

โดยค่าเริ่มต้น App Check จะใช้โทเค็นเซสชันซึ่งมี Time to Live (TTL) ที่กำหนดค่าได้ระหว่าง 30 นาทีถึง 7 วัน App Check SDK จะแคชโทเค็นเซสชันเหล่านี้ ส่งพร้อมกับ คำขอจากแอป และนำกลับมาใช้ใหม่ได้จนกว่า TTL จะหมดอายุ การใช้โทเค็นเซสชันถือเป็นการปกป้องพื้นฐาน

อย่างไรก็ตาม คุณสามารถเพิ่มการป้องกันให้เหนือกว่าการป้องกันพื้นฐานนี้ได้โดยการบังคับใช้การป้องกันการเล่นซ้ำ ซึ่งจะใช้โทเค็นแบบใช้ครั้งเดียวแทน เมื่อบังคับใช้การป้องกันการเล่นซ้ำ ระบบจะดำเนินการต่อไปนี้

App Check จะบล็อกคำขอไปยัง Firebase AI Logic ที่ใช้โทเค็นเซสชัน แต่ App Check จะอนุญาตคำขอไปยัง Firebase AI Logic ก็ต่อเมื่อใช้โทเค็นที่จำกัดการใช้ที่สร้างขึ้นใหม่
หลังจากยืนยันโทเค็นที่จำกัดการใช้แล้ว ระบบจะใช้โทเค็นดังกล่าวเพื่อให้ใช้ได้เพียงครั้งเดียว ซึ่งจะช่วยป้องกันการโจมตีแบบใช้โทเค็นซ้ำ (Replay)
App Check SDK จะสร้างโทเค็นที่จำกัดการใช้ใหม่สำหรับคำขอแต่ละรายการ โปรดทราบว่ากระบวนการนี้อาจส่งผลต่อคำขอของคุณโดยเพิ่มเวลาในการตอบสนองและ บางครั้งอาจมีค่าใช้จ่าย (ขึ้นอยู่กับผู้ให้บริการการรับรอง)

ตั้งค่าและบังคับใช้การป้องกันการเล่นซ้ำ

วิธีตั้งค่าและบังคับใช้การป้องกันการเล่นซ้ำมีดังนี้

หากยังไม่ได้ ตั้งค่า App Check ให้ ทำตามวิธีการก่อนหน้าในหน้านี้

เปิดใช้โทเค็นที่จำกัดการใช้

ในแอปขณะสร้างอินสแตนซ์ ให้ตั้งค่าuseLimitedUseAppCheckTokens พารามิเตอร์เป็น true

Swift


// ...

// During instantiation, enable usage of limited-use tokens.
let ai = FirebaseAI.firebaseAI(
  backend: .googleAI(),
  useLimitedUseAppCheckTokens: true
)

// ...

Kotlin


// ...

// During instantiation, enable usage of limited-use tokens.
val ai = Firebase.ai(
  backend = GenerativeBackend.googleAI(),
  useLimitedUseAppCheckTokens = true
)

// ...

Java


// ...

// During instantiation, enable usage of limited-use tokens.
FirebaseAI ai = FirebaseAI.getInstance(
  /* backend: */ GenerativeBackend.googleAI(),
  /* useLimitedUseAppCheckTokens: */ true
);

// ...

Web


// ...

// During instantiation, enable usage of limited-use tokens.
const ai = getAI(firebaseApp, {
  backend: new GoogleAIBackend(),
  useLimitedUseAppCheckTokens: true
});

// ...

Dart


// ...

// During instantiation, enable usage of limited-use tokens
final ai = await FirebaseAI.googleAI(
  useLimitedUseAppCheckTokens: true,
);

// ...

Unity

// ...

// During instantiation, enable usage of limited-use tokens
var ai = FirebaseAI.GetInstance(
  useLimitedUseAppCheckTokens: true
);

// ...

บังคับใช้การป้องกันการเล่นซ้ำ
1. ในโค้ดเบสของแอป ให้ตรวจสอบว่าคุณได้เปิดใช้โทเค็นแบบจำกัดการใช้งานแล้ว (ดูขั้นตอนก่อนหน้า)
2. ในFirebaseคอนโซล ให้ไปที่ความปลอดภัย > App Check
3. ขยายมุมมองเมตริกสำหรับ Firebase AI Logic
4. ตรวจสอบว่าการป้องกันพื้นฐานบังคับใช้แล้ว จากนั้นคลิกต่อไป
5. สำหรับการป้องกันการเล่นซ้ำ ให้เลือกไม่บังคับใช้ (ตรวจสอบเท่านั้น) หรือบังคับใช้
  
  พิจารณาสิ่งต่อไปนี้เพื่อตัดสินใจว่าจะบังคับใช้การป้องกันการเล่นซ้ำเมื่อใด
  - ขอแนะนำให้ตรวจสอบคำขอหากผู้ใช้จำนวนมากมีแนวโน้มที่จะใช้แอปเวอร์ชันก่อนหน้าโดยไม่ได้เปิดใช้โทเค็นแบบจำกัดการใช้งาน หากคุณบังคับใช้การป้องกันการเล่นซ้ำทันที ระบบจะบล็อกคำขอจากผู้ใช้เหล่านั้น
  - คุณสามารถตรวจสอบเมตริกยังไม่ยืนยัน: โทเค็นที่นำกลับมาใช้ใหม่ โดยเฉพาะ ซึ่งเป็นจำนวนคำขอที่มีโทเค็นที่ ใช้ไปแล้วในคำขอก่อนหน้า ตรวจสอบเมตริกนี้ใน Firebase คอนโซล (ไปที่ความปลอดภัย > App Check > แท็บ API)
    
    หากคำขอล่าสุดส่วนใหญ่เป็นคำขอในหมวดหมู่นี้ คุณสามารถหลีกเลี่ยงการรบกวนผู้ใช้และพิจารณารอการบังคับใช้ การป้องกันการเล่นซ้ำจนกว่าจะมีผู้ใช้อัปเดตแอปของคุณเป็นเวอร์ชันที่ใช้โทเค็นแบบจำกัดการใช้งานมากขึ้น

หมายเหตุ: โปรดทราบสิ่งต่อไปนี้หากคุณ เปิดใช้การใช้โทเค็นแบบจำกัดการใช้งานเท่านั้น และคุณไม่ได้บังคับใช้การป้องกันการเล่นซ้ำ

โทเค็นแบบใช้ได้จำกัดมี TTL เพียง 5 นาที และปรับ TTL ไม่ได้ (ต่างจากโทเค็นเซสชัน) เมื่อไม่ได้บังคับใช้ การป้องกันการเล่นซ้ำ โทเค็นแบบใช้ได้จำกัดจะคล้ายกับโทเค็นเซสชันตรงที่ สามารถนำกลับมาใช้ใหม่ได้จนกว่า TTL จะหมดอายุ
แม้ว่าโทเค็นแบบจำกัดการใช้งานจะใช้ได้เป็นเวลา 5 นาที แต่ SDK จะยังสร้างโทเค็นใหม่สำหรับคำขอแต่ละคำขอ นอกจากนี้ SDK ยังไม่แคชโทเค็นแบบจำกัดการใช้งานด้วย
เมื่อไม่ได้บังคับใช้การป้องกันการเล่นซ้ำ App Check จะไม่บล็อกคำขอไปยัง Firebase AI Logic ที่ใช้โทเค็นเซสชันที่ถูกต้อง

ทำความเข้าใจวิธีที่ Firebase AI Logic ผสานรวมกับ App Check

หากต้องการใช้ Firebase AI Logic SDK คุณต้องเปิดใช้ Firebase AI Logic API (firebasevertexai.googleapis.com) ในโปรเจ็กต์ Firebase เนื่องจากระบบจะส่งคำขอที่ SDK ของ Firebase AI Logic สร้างขึ้นไปยังเซิร์ฟเวอร์ Firebase AI Logic ก่อน ซึ่งทำหน้าที่เป็นเกตเวย์พร็อกซีที่Firebase App Checkการยืนยัน เกิดขึ้นก่อนที่ระบบจะอนุญาตให้คำขอไปยัง Gemini API และ เข้าถึงโมเดล Gemini

คำถามที่พบบ่อยและการแก้ปัญหา

ดูคำถามที่พบบ่อยและการแก้ปัญหาเพิ่มเติม หรือรหัสข้อผิดพลาดที่เกี่ยวข้องกับ Firebase AI Logic

ฉันต้องApp Checkบังคับใช้กับแอปทุกเวอร์ชันไหม

App Check ต้องบังคับใช้กับแอปทุกเวอร์ชันที่ใช้ Firebase AI Logic

สิ่งสำคัญคือต้องApp Checkบังคับใช้ตั้งแต่เนิ่นๆ โดยเฉพาะ ก่อนที่คุณจะส่งแอปไปยังระบบควบคุมซอร์สโค้ดที่พร้อมใช้งานแบบสาธารณะ แชร์แอป หรือทำให้แอปพร้อมใช้งานแบบสาธารณะ

หากติดตั้งใช้งาน App Check ในฐานของโค้ดของแอปทันที แอปทุกเวอร์ชันจะส่งโทเค็น App Check ที่ถูกต้องได้ คำขอที่ไม่ได้ส่งโทเค็นที่ถูกต้องจะถือว่าไม่ได้รับการยืนยันและจะถูกบล็อกเมื่อมีการบังคับใช้ App Check

หากคุณได้เผยแพร่แอปเวอร์ชันที่ไม่มี App Check ที่ใช้งานแล้วต่อผู้ใช้ปลายทาง โปรดดูคำถามที่พบบ่อยเกี่ยวกับวิธีใช้งานและบังคับใช้ App Check สำหรับแอปที่เผยแพร่แล้ว

ฉันจะติดตั้งใช้งานและบังคับใช้ App Check สำหรับแอปที่เผยแพร่ไปแล้วได้อย่างไร

สำหรับแอปเวอร์ชันที่ไม่ได้ใช้ App Check คำขอไปยัง Firebase AI Logic จากเวอร์ชันเหล่านั้นจะไม่มีโทเค็น App Check ที่ถูกต้อง และถือว่าไม่ได้รับการยืนยัน ระบบจะบล็อกคำขอเหล่านี้เมื่อมีการบังคับใช้ App Check สำหรับ Firebase AI Logic

ประกาศเตือน: ตั้งแต่วันที่ 2 พฤศจิกายน 2026 เป็นต้นไป App Check จะต้องมีการบังคับใช้สำหรับ Firebase AI Logic
ในวันที่นี้ เราจะบังคับใช้ App Check สำหรับ Firebase AI Logic โดยอัตโนมัติ และจะยกเลิกการบังคับใช้ไม่ได้ หากคุณมีผู้ใช้ปลายทางในแอปเวอร์ชันที่ไม่ได้ใช้ App Check ระบบจะบล็อกคำขอจากผู้ใช้เหล่านั้น ดังนั้น คุณจึงต้องย้ายข้อมูลผู้ใช้ปลายทางเหล่านี้ไปยัง แอปเวอร์ชันที่มี App Check โดยเร็วที่สุด

วิธีการต่อไปนี้จะช่วยคุณย้ายข้อมูลแอปเพื่อให้บังคับใช้ App Check ได้โดยไม่ทำให้บริการหยุดชะงักสำหรับแอปที่เผยแพร่แล้ว ซึ่งไม่มี App Check

ใช้ผู้ให้บริการการรับรองเวอร์ชันที่ใช้งานจริงในแอปโดยเร็วที่สุด
- แพลตฟอร์ม Apple: DeviceCheck หรือ App Attest หรือ reCAPTCHA Enterprise
- Android Play Integrity หรือ reCAPTCHA Enterprise
- เว็บ reCAPTCHA Enterprise
- Flutter: รองรับ ผู้ให้บริการทั้งหมดข้างต้น รวมถึง reCAPTCHA Enterprise
- Unity: รองรับ ผู้ให้บริการทั้งหมดข้างต้น (รองรับ reCAPTCHA Enterprise เร็วๆ นี้)
หมายเหตุ: เมื่อติดตั้งใช้งาน App Check ให้พิจารณาเปิดใช้โทเค็นแบบใช้ครั้งเดียวเพื่อให้คุณมีตัวเลือกในภายหลังในการเพิ่มการปกป้องโดยใช้การป้องกันการเล่นซ้ำ ซึ่งหมายความว่าโทเค็น App Check จะใช้ได้เพียงครั้งเดียวเท่านั้น
ตรวจสอบคำขอจากแอปเพื่อช่วยคุณตัดสินใจว่าเมื่อใดที่ควรบังคับใช้ App Check

เช่น หากคำขอที่ส่งล่าสุดเกือบทั้งหมดมาจากไคลเอ็นต์ที่ยืนยันแล้ว คุณควรพิจารณาบังคับใช้App Check
บังคับใช้ App Check สำหรับ Firebase AI Logic

คำเตือน: หากคุณไม่ได้บังคับใช้ App Check สำหรับ Firebase AI Logic ภายในวันที่ 2 พฤศจิกายน 2026 ระบบจะบังคับใช้โดยอัตโนมัติ ดูข้อมูลเพิ่มเติม
สำหรับการพัฒนาในเครื่องเมื่อมีการบังคับใช้ App Check คุณจะ ตั้งค่าผู้ให้บริการแก้ไขข้อบกพร่องของ App Check และยังคงบังคับใช้ App Check สำหรับ Firebase AI Logic ได้

ข้อผิดพลาด 403: `PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check`

หากได้รับ403 - PERMISSION_DENIEDข้อผิดพลาดที่ระบุว่า To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check แสดงว่าคำขอของคุณไม่มีโทเค็น App Check ที่ถูกต้องและคุณ พยายามเข้าถึงโมเดลที่มักถูกละเมิด

ระบบพบว่าโมเดล Generative บางโมเดลเป็นที่นิยมในหมู่ผู้ไม่ประสงค์ดีที่ ใช้ในทางที่ผิด

เนื่องจากคุณไม่ได้App Checkบังคับใช้สำหรับ Firebase AI Logic โปรเจ็กต์ของคุณจึงเสี่ยงต่อการละเมิดโมเดลเหล่านี้ Firebase จะบล็อกการเข้าถึงโมเดลเหล่านี้เพื่อช่วยปกป้องนักพัฒนาแอปของเรา เว้นแต่คำขอจะมีโทเค็น App Check ที่ถูกต้อง (ซึ่งหมายความว่ามีการบังคับใช้ App Check สำหรับ Firebase AI Logic)

หากต้องการเข้าถึงโมเดลที่แสดงข้อผิดพลาด ให้ทำดังนี้

ตั้งค่า App Check สำหรับ Firebase AI Logic สำหรับการพัฒนาในเครื่อง ให้ตรวจสอบว่าคุณได้ตั้งค่าApp Check ผู้ให้บริการแก้ไขข้อบกพร่องแล้ว

การบังคับใช้ App Check มีความสำคัญอย่างยิ่งต่อการช่วยปกป้อง Gemini API และ โมเดล Gemini จากการละเมิด และจำเป็นต้องมีการบังคับใช้เพื่อแก้ไขข้อผิดพลาดนี้
ส่งคำขอจากแอปของคุณไปยัง Firebase AI Logic อีกครั้ง

คำขอนี้จะส่งโทเค็น App Check ที่ถูกต้อง และคุณจะไม่ได้รับข้อผิดพลาด 403 - PERMISSION_DENIED นี้อีกต่อไป
ก่อนที่จะเผยแพร่แอปต่อผู้ใช้ปลายทาง คุณต้อง ตั้งค่าผู้ให้บริการการรับรองเวอร์ชันที่ใช้งานจริง (เช่น App Attest, Play Integrity หรือ reCAPTCHA Enterprise) เพื่อให้ ผู้ใช้ปลายทางเข้าถึงฟีเจอร์ AI ได้เมื่อมีการบังคับใช้ App Check

ข้อผิดพลาด 403: `PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check`

หากได้รับ403 - PERMISSION_DENIEDข้อผิดพลาดที่ระบุว่า Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check แสดงว่าระบบระบุโปรเจ็กต์ Firebase ของคุณว่าไม่มีการใช้งาน และคุณ ไม่ได้App Checkบังคับใช้สำหรับ Firebase AI Logic

"โปรเจ็กต์ที่ไม่ได้ใช้งาน" คือโปรเจ็กต์ที่Firebase AI Logic เปิดใช้ แต่ไม่มีการใช้งาน Firebase AI Logic ในช่วงที่ผ่านมา

เนื่องจากคุณไม่ได้บังคับใช้ App Check สำหรับ Firebase AI Logic โปรเจ็กต์ของคุณจึงเสี่ยงต่อการละเมิด Gemini API Firebase ได้ปิดใช้งานการใช้ Firebase AI Logic จนกว่าคุณจะบังคับใช้ App Check สำหรับ Firebase AI Logic เพื่อช่วยปกป้องโปรเจ็กต์ของคุณ

เมื่อพร้อมที่จะเริ่มใช้ Firebase AI Logic อีกครั้ง ให้ทำดังนี้

ตั้งค่า App Check สำหรับ Firebase AI Logic สำหรับการพัฒนาในเครื่อง ให้ตรวจสอบว่าคุณได้ตั้งค่าApp Check ผู้ให้บริการแก้ไขข้อบกพร่องแล้ว

การบังคับใช้ App Check มีความสำคัญอย่างยิ่งต่อการช่วยปกป้อง Gemini API และ โมเดล Gemini จากการละเมิด และจำเป็นต้องมีการบังคับใช้เพื่อแก้ไขข้อผิดพลาดนี้
ส่งคำขอจากแอปของคุณไปยัง Firebase AI Logic อีกครั้ง

คำขอนี้จะส่งโทเค็น App Check ที่ถูกต้อง และคุณจะไม่ได้รับข้อผิดพลาด 403 - PERMISSION_DENIED นี้อีกต่อไป
หากคุณบังคับใช้ App Check อยู่แล้วและยังคงได้รับข้อผิดพลาดนี้ ให้ตรวจสอบว่าได้เปิดการป้องกันการเล่นซ้ำสำหรับ Firebase AI Logic หรือไม่ (รวมถึงในโหมด "ตรวจสอบเท่านั้น")

เมื่อเปิดการป้องกันการเล่นซ้ำ ระบบจะนับเฉพาะโทเค็นแบบใช้ได้จำกัดเป็นโทเค็นที่ยืนยันแล้ว สำหรับ Firebase AI Logic ส่วนโทเค็นเซสชันปกติจะไม่ล้างข้อผิดพลาดนี้ เปิดใช้โทเค็นแบบใช้ครั้งเดียวในแอป หรือปิดการป้องกันการเล่นซ้ำสำหรับ Firebase AI Logic ส่งคำขออีกครั้ง และรอประมาณ 1 วันก่อนที่จะเปิดการป้องกันการเล่นซ้ำอีกครั้ง (ระบบจะประเมินกิจกรรมของโปรเจ็กต์ใหม่ทุกวัน)
ก่อนที่จะเผยแพร่แอปต่อผู้ใช้ปลายทาง คุณต้อง ตั้งค่าผู้ให้บริการการรับรองเวอร์ชันที่ใช้งานจริง (เช่น App Attest, Play Integrity หรือ reCAPTCHA Enterprise) เพื่อให้ ผู้ใช้ปลายทางเข้าถึงฟีเจอร์ AI ได้เมื่อมีการบังคับใช้ App Check

บังคับใช้ App Check โดยไม่มีผู้ให้บริการการรับรองการใช้งานจริง (ผู้ให้บริการการแก้ไขข้อบกพร่องเท่านั้น)

คุณบังคับใช้ App Check สำหรับ Firebase AI Logic ได้โดยไม่ต้องลงทะเบียนแอปกับผู้ให้บริการการรับรองการผลิต แต่คุณสามารถตั้งค่าApp Check ผู้ให้บริการแก้ไขข้อบกพร่องแทนได้ การตั้งค่านี้มีประโยชน์สำหรับการพัฒนาในเครื่องหรือ หากคุณเพิ่งเริ่มต้นใช้งานหรือทดลองใช้ Firebase AI Logic

ก่อนหน้านี้ในหน้านี้ คุณจะเห็นวิธีการที่เพิ่มประสิทธิภาพแล้วสำหรับ การตั้งค่า App Check สำหรับ Firebase AI Logic รวมถึงการบังคับใช้ App Check และการตั้งค่า App Check ผู้ให้บริการแก้ไขข้อบกพร่อง

ไม่บังคับใช้ App Check (ไม่แนะนำอย่างยิ่ง)

คำเตือน: ไม่บังคับใช้ App Check สำหรับ Firebase AI Logic เป็นสิ่งที่เราไม่แนะนำอย่างยิ่ง เมื่อไม่ได้บังคับใช้ App Check กับ Firebase AI Logic Gemini API จะเสี่ยงต่อการถูกละเมิด

อย่างไรก็ตาม หากเลือกที่จะไม่บังคับใช้ App Check คุณต้องบังคับใช้อีกครั้ง โดยเฉพาะอย่างยิ่งก่อนที่จะส่งแอปไปยังระบบควบคุมซอร์สโค้ดที่เปิดเผยต่อสาธารณะ แชร์แอป หรือทำให้แอปพร้อมใช้งานต่อสาธารณะ

หากคุณยกเลิกการบังคับใช้ App Check เนื่องจากเพิ่งเริ่มต้นใช้งาน หรือลองใช้ Firebase AI Logic คุณควรพิจารณาตั้งค่าผู้ให้บริการแก้ไขข้อบกพร่องสำหรับการพัฒนาในเครื่อง แทนการยกเลิกการบังคับใช้ App Check

ตั้งแต่วันที่ 2 พฤศจิกายน 2026 เป็นต้นไป คุณจะต้องFirebase App Checkบังคับใช้เพื่อใช้ Firebase AI Logic และจะยกเลิกการบังคับใช้ไม่ได้ ดูข้อมูลเพิ่มเติม

ตรวจสอบว่ามีการบังคับใช้ App Check สำหรับ Firebase AI Logic หรือไม่
1. ในFirebaseคอนโซล ให้ไปที่ความปลอดภัย > App Check > แท็บ API
2. ค้นหาแถวของ Firebase AI Logic หากระบุว่า Enforced ให้ทำตามวิธีการที่เหลือต่อไป
คลิกแถวของ Firebase AI Logic แล้วคุณจะเห็นกราฟเมตริก คลิกตั้งค่าใต้กราฟเหล่านั้น
ในหน้าจอแรกของกล่องโต้ตอบ (การป้องกันพื้นฐาน) ให้เลือก ไม่ได้บังคับใช้ (ตรวจสอบเท่านั้น) แล้วคลิกต่อไป
ในหน้าจอถัดไป (การป้องกันการเล่นซ้ำ) ให้เลือกปิดใช้ แล้วคลิกต่อไป
ในหน้าจอสุดท้าย ให้คลิกดำเนินการต่อเพื่อยกเลิกการบังคับใช้ App Check

เมื่อไม่ได้บังคับใช้ App Check กับ Firebase AI Logic Gemini API จะเสี่ยงต่อการถูกละเมิด
ตรวจสอบว่าคุณได้App Checkบังคับใช้อีกครั้ง โดยเฉพาะก่อนที่จะส่งแอปไปยังระบบควบคุมซอร์สโค้ดที่เผยแพร่ต่อสาธารณะ แชร์แอป หรือเผยแพร่แอปต่อสาธารณะ

สรุปภาพรวมเกี่ยวกับวิธีการทำงานของ App Check

ตั้งค่า App Check

ขั้นตอนที่ 1: บังคับใช้ App Check

ขั้นตอนที่ 2: ตั้งค่าผู้ให้บริการแก้ไขข้อบกพร่องสำหรับการพัฒนาในเครื่อง

Swift

Kotlin

Java

Web

Dart

iOS+

Android

เว็บ

Unity

ขั้นตอนที่ 3: ตั้งค่า App Check สำหรับผู้ใช้ปลายทางและการผลิต

เพิ่มการป้องกันโดยเพิ่มการป้องกันการเล่นซ้ำ

ตั้งค่าและบังคับใช้การป้องกันการเล่นซ้ำ

Swift

Kotlin

Java

Web

Dart

Unity

ทำความเข้าใจวิธีที่ Firebase AI Logic ผสานรวมกับ App Check

คำถามที่พบบ่อยและการแก้ปัญหา

ฉันต้องApp Checkบังคับใช้กับแอปทุกเวอร์ชันไหม

ฉันจะติดตั้งใช้งานและบังคับใช้ App Check สำหรับแอปที่เผยแพร่ไปแล้วได้อย่างไร

ข้อผิดพลาด 403: PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check

ข้อผิดพลาด 403: PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check

บังคับใช้ App Check โดยไม่มีผู้ให้บริการการรับรองการใช้งานจริง (ผู้ให้บริการการแก้ไขข้อบกพร่องเท่านั้น)

ไม่บังคับใช้ App Check (ไม่แนะนำอย่างยิ่ง)

ข้อผิดพลาด 403: `PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check`

ข้อผิดพลาด 403: `PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check`