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

Model updates:

Gemini 4 Argon is now 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-4-argon, gemini-3.8-flash, or gemini-nano-banana-2.1). 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 แล้วคุณจะเห็นกราฟเมตริก คลิกตั้งค่าใต้กราฟเหล่านั้น
ในหน้าจอแรกของกล่องโต้ตอบ (การปกป้องพื้นฐาน) ให้เลือกบังคับใช้ แล้วคลิกต่อไป
ในหน้าจอถัดไป (Replay protection) ให้เลือก Disabled แล้วคลิก Continue

หมายเหตุ: การตั้งค่าการป้องกันการเล่นซ้ำกำหนดให้คุณต้องเปิดใช้โทเค็นที่จำกัดการใช้ในแอป เมื่อดำเนินการเสร็จแล้ว คุณสามารถกลับมาที่คอนโซล 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. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

เว็บ

ในไฟล์ 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 คุณจะต้องส่ง App Check อย่างชัดแจ้งในระหว่างการสร้างอินสแตนซ์ในแอป Flutter ที่ใช้ปลั๊กอินเวอร์ชันเก่า ดังนี้


// ...

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

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

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

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

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

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

หากยังไม่ได้ดำเนินการ ให้ตั้งค่า 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

หากต้องการใช้ SDK ของ Firebase AI Logic คุณต้องเปิดใช้ API ของ Firebase AI Logic (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โดยอัตโนมัติ โปรดทราบว่าคุณสามารถเลื่อนการบังคับใช้อัตโนมัติออกไปชั่วคราวได้จนถึงวันที่ 21 มกราคม 2027 (ดูวิธีเลื่อนการบังคับใช้อัตโนมัติได้ในวิธีการด้านล่าง)

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับข้อกำหนดนี้

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

เลื่อนการบังคับใช้ App Check โดยอัตโนมัติสำหรับ Firebase AI Logic:
1. ในคอนโซล Firebase ให้ไปที่ความปลอดภัย > App Check > แท็บ API
2. ค้นหาแถวสำหรับ Firebase AI Logic
3. ที่ท้ายแถว ให้ค้นหาเครื่องมือเลือกวันที่บังคับใช้: พร้อมไอคอนแก้ไข
4. เลือกวันที่ที่ต้องการให้บังคับใช้ App Check โดยอัตโนมัติสำหรับ Firebase AI Logic
  
  วันที่สุดท้ายที่เป็นไปได้คือวันที่ 21 มกราคม 2027 หลังจากวันที่ดังกล่าว คุณจะไม่สามารถเลื่อนการบังคับใช้ App Check โดยอัตโนมัติสำหรับ Firebase AI Logic ได้
5. คลิกบันทึก
คำเตือน: โปรดทราบว่าหากคุณเลื่อนการบังคับใช้อัตโนมัติและเลือกที่จะไม่บังคับใช้ App Check สำหรับ Firebase AI Logic การเข้าถึง Gemini API จะเสี่ยงต่อการละเมิด นอกจากนี้ การเลื่อนเวลานี้เป็นเพียงมาตรการชั่วคราวเท่านั้น หลังจากวันที่ 21 มกราคม 2027 คุณจะไม่สามารถเลื่อนเวลาการบังคับใช้ App Check โดยอัตโนมัติสำหรับ Firebase AI Logic ได้อีก
ใช้ผู้ให้บริการเอกสารรับรองเวอร์ชันที่ใช้งานจริงในแอปโดยเร็วที่สุด
- แพลตฟอร์ม Apple: DeviceCheck หรือ App Attest หรือ reCAPTCHA Enterprise
- Android: Play Integrity หรือ reCAPTCHA Enterprise
- เว็บ: reCAPTCHA Enterprise
- Flutter: รองรับผู้ให้บริการทั้งหมดข้างต้น รวมถึง reCAPTCHA Enterprise
- Unity: รองรับผู้ให้บริการทั้งหมดข้างต้น (จะรองรับ reCAPTCHA Enterprise เร็วๆ นี้)
หมายเหตุ: เมื่อใช้ App Check ให้พิจารณาเปิดใช้โทเค็นที่จำกัดการใช้เพื่อให้คุณมีตัวเลือกในภายหลังสำหรับการปกป้องที่ดียิ่งขึ้นโดยใช้การป้องกันการโจมตีแบบ Replay ซึ่งหมายความว่าโทเค็น 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 โดยอัตโนมัติเป็นเวลา Firebase AI Logic

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

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

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

วิธีเลื่อนการบังคับใช้ App Check โดยอัตโนมัติสำหรับ Firebase AI Logic มีดังนี้

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

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

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

ยกเลิกการบังคับใช้ 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 หากมีข้อความว่าบังคับใช้ ให้ทำตามวิธีการที่เหลือต่อไป
เลื่อนการบังคับใช้ App Check โดยอัตโนมัติสำหรับ Firebase AI Logic:
1. ที่ท้ายแถวของ Firebase AI Logic ให้ค้นหาเครื่องมือเลือกวันที่บังคับใช้: พร้อมไอคอนแก้ไข
2. เลือกวันที่ที่ต้องการให้บังคับใช้ App Check โดยอัตโนมัติสำหรับ Firebase AI Logic
  
  วันที่สุดท้ายที่เป็นไปได้คือวันที่ 21 มกราคม 2027 หลังจากวันที่ดังกล่าว คุณจะไม่สามารถเลื่อนการบังคับใช้ App Check โดยอัตโนมัติสำหรับ Firebase AI Logic ได้
3. คลิกบันทึก
คำเตือน: โปรดทราบว่าหากคุณเลื่อนการบังคับใช้อัตโนมัติและเลือกที่จะไม่บังคับใช้ App Check สำหรับ Firebase AI Logic การเข้าถึง Gemini API จะเสี่ยงต่อการละเมิด นอกจากนี้ การเลื่อนเวลานี้เป็นเพียงมาตรการชั่วคราวเท่านั้น หลังจากวันที่ 21 มกราคม 2027 คุณจะไม่สามารถเลื่อนเวลาการบังคับใช้ App Check โดยอัตโนมัติสำหรับ Firebase AI Logic ได้อีก
กลับไปที่รายการ API แล้วคลิกแถวของ Firebase AI Logic แล้วคุณจะเห็นกราฟเมตริก คลิกตั้งค่าใต้กราฟเหล่านั้น
ในหน้าจอแรกของกล่องโต้ตอบ (การปกป้องพื้นฐาน) ให้เลือกไม่บังคับใช้ (ตรวจสอบเท่านั้น) แล้วคลิกต่อไป
ในหน้าจอถัดไป (Replay protection) ให้เลือก Disabled แล้วคลิก Continue
ในหน้าจอสุดท้าย ให้คลิกต่อไปเพื่อยกเลิกการบังคับใช้ 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 โดยอัตโนมัติเป็นเวลา Firebase 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`

ข้อผิดพลาด 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`