เริ่มต้นใช้งาน App Check ในแอป Unity
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
หน้านี้แสดงวิธีเปิดใช้ App Check ในแอป Unity โดยใช้
ผู้ให้บริการเริ่มต้น: Play Integrity ใน Android และเปิดใช้การตรวจสอบอุปกรณ์หรือ App Attest อยู่
แพลตฟอร์มของ Apple การเปิดใช้ App Check ช่วยให้มั่นใจได้ว่า
มีเพียงแอปของคุณเท่านั้นที่เข้าถึงทรัพยากร Firebase ของโปรเจ็กต์ได้ โปรดดู
ภาพรวมของฟีเจอร์นี้
1. สร้างโปรเจ็กต์ Firebase
เพิ่ม Firebase ไปยังโปรเจ็กต์ Unity หากยังไม่ได้เพิ่ม
ทำแล้ว
ลงทะเบียนแอปเพื่อใช้ App Check กับ Play Integrity, Device Check
หรือผู้ให้บริการ App Attest ใน
การตั้งค่าโครงการ > App Check
ของคอนโซล Firebase
ปกติแล้วคุณจะต้องลงทะเบียนแอปทั้งหมดของโครงการ เพราะเมื่อคุณ
เปิดใช้การบังคับใช้สำหรับผลิตภัณฑ์ Firebase เฉพาะแอปที่ลงทะเบียนเท่านั้นที่ทำได้
เพื่อเข้าถึงทรัพยากรแบ็กเอนด์ของผลิตภัณฑ์
หากต้องการทราบขั้นตอนการลงทะเบียนกับผู้ให้บริการแต่ละรายโดยละเอียด โปรดดูที่
ในเอกสารประกอบเฉพาะสำหรับ Android และ iOS
ไม่บังคับ: ในการตั้งค่าการลงทะเบียนแอป ให้ตั้งค่า Time to Live ที่กำหนดเอง
(TTL) สำหรับโทเค็น App Check ที่ออกโดยผู้ให้บริการ คุณจะตั้งค่า TTL ได้
เป็นค่าใดก็ได้ระหว่าง 30 นาทีถึง 7 วัน เมื่อเปลี่ยนค่านี้
ทราบถึงข้อดีข้อเสียต่อไปนี้
- การรักษาความปลอดภัย: TTL ขนาดสั้นจะให้ความปลอดภัยที่เข้มงวดกว่า เนื่องจากจะช่วยลด
โทเค็นที่รั่วไหลหรือถูกดักไว้อาจถูกละเมิดโดย
ผู้โจมตี
- ประสิทธิภาพ: TTL ขนาดสั้นหมายความว่าแอปจะดำเนินการรับรองได้มากขึ้น
เป็นประจำ เนื่องจากกระบวนการรับรองแอปเพิ่มเวลาในการตอบสนองให้กับเครือข่าย
ทุกครั้งที่มีการดำเนินการ TTL ขนาดสั้นอาจส่งผลต่อประสิทธิภาพ
ของแอปของคุณ
- โควต้าและค่าใช้จ่าย: TTL ที่สั้นกว่าและการรับรองซ้ำบ่อยๆ จะทำให้
เร็วขึ้น และสำหรับบริการที่มีค่าใช้จ่ายอาจมีค่าใช้จ่ายเพิ่มขึ้น
ดูโควต้าและ ขีดจำกัด
TTL เริ่มต้น
เหมาะสมสำหรับแอปส่วนใหญ่ โปรดทราบว่าไลบรารี App Check จะรีเฟรช
โทเค็นที่ระยะเวลาประมาณครึ่งหนึ่งของระยะเวลา TTL
2. เพิ่มไลบรารี App Check ลงในแอป
รวมไลบรารี App Check ไว้ในชุดทรัพยากร Dependency ต่อไปนี้
วิธีการตั้งค่าสำหรับ App Check
3. เริ่มต้น App Check
เพิ่มโค้ดการเริ่มต้นต่อไปนี้ลงในแอปเพื่อให้แอปทำงานก่อนคุณ
ใช้บริการ Firebase รวมถึงการสร้างแอป Firebase
Android
เพิ่มการประกาศที่ใช้สําหรับ Firebase.AppCheck:
using Firebase.AppCheck
เริ่มต้นไลบรารี App Check กับผู้ให้บริการ Play Integrity โดยทำดังนี้
FirebaseAppCheck.SetAppCheckProviderFactory(
PlayIntegrityProviderFactory.Instance);
iOS ขึ้นไป
เพิ่มการประกาศที่ใช้สําหรับ Firebase.AppCheck:
using Firebase.AppCheck
เริ่มต้นไลบรารี App Check ด้วย Device Check หรือ App Attest
เป็นผู้ให้บริการคลาวด์
FirebaseAppCheck.SetAppCheckProviderFactory(
DeviceCheckProviderFactory.Instance);
ขั้นตอนถัดไป
เมื่อติดตั้งไลบรารี App Check ในแอปแล้ว ให้เริ่มเผยแพร่
ที่อัปเดตให้กับผู้ใช้
แอปไคลเอ็นต์ที่อัปเดตจะเริ่มส่งโทเค็น App Check พร้อมกับ
ส่งคำขอไปยัง Firebase แต่ผลิตภัณฑ์ Firebase ไม่จำเป็นต้องใช้โทเค็น
จะยังมีผลจนกว่าคุณจะเปิดใช้การบังคับใช้ในส่วน App Check ของ
คอนโซล Firebase
ตรวจสอบเมตริกและเปิดใช้การบังคับใช้
แต่ก่อนเปิดใช้การบังคับใช้ คุณควรตรวจสอบว่าการดำเนินการดังกล่าวจะไม่
กับผู้ใช้ที่ถูกต้องตามกฎหมายที่มีอยู่ ในทางกลับกัน ถ้าคุณเห็น
การใช้ทรัพยากรแอปของคุณที่น่าสงสัย คุณอาจต้องเปิดใช้การบังคับใช้
เร็วขึ้น
โปรดดูเมตริก App Check สำหรับ
บริการที่คุณใช้:
เปิดใช้การบังคับใช้ App Check
เมื่อเข้าใจว่า App Check จะส่งผลต่อผู้ใช้อย่างไรและพร้อมจะ
การดำเนินการต่อก็เปิดใช้การบังคับใช้ App Check ได้โดยทำดังนี้
ใช้ App Check ในสภาพแวดล้อมการแก้ไขข้อบกพร่อง
หลังจากลงทะเบียนแอปสำหรับ App Check แล้ว คุณต้องการเรียกใช้
แอปในสภาพแวดล้อมที่ App Check มักจะไม่จัดว่า "ถูกต้อง"
เช่น บนเดสก์ท็อป โปรแกรมจำลองระหว่างการพัฒนา หรือจาก
การผสานรวม (CI) ได้ คุณจะสร้างบิลด์การแก้ไขข้อบกพร่องของแอปที่
ใช้ผู้ให้บริการแก้ไขข้อบกพร่องของ App Check แทนผู้ให้บริการเอกสารรับรองจริง
โปรดดูหัวข้อใช้ App Check กับผู้ให้บริการแก้ไขข้อบกพร่องในแอป Unity
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-08-22 UTC
[null,null,["อัปเดตล่าสุด 2024-08-22 UTC"],[],[],null,["\u003cbr /\u003e\n\nThis page shows you how to enable App Check in a Unity app, using the\ndefault providers: Play Integrity on Android, and Device Check or App Attest on\nApple platforms. When you enable App Check, you help ensure that\nonly your app can access your project's Firebase resources. See an\n[Overview](/docs/app-check) of this feature.\n\n1. Set up your Firebase project\n\n1. [Add Firebase to your Unity project](/docs/unity/setup) if you haven't\n already done so.\n\n2. Register your apps to use App Check with the Play Integrity, Device Check,\n or App Attest providers in the\n [**Project Settings \\\u003e App Check**](https://console.firebase.google.com/project/_/appcheck)\n section of the Firebase console.\n\n You usually need to register all of your project's apps, because once you\n enable enforcement for a Firebase product, only registered apps will be able\n to access the product's backend resources.\n\n For detailed instructions on how to register with each provider, refer to\n the Android and iOS specific documentation.\n3. **Optional**: In the app registration settings, set a custom time-to-live\n (TTL) for App Check tokens issued by the provider. You can set the TTL\n to any value between 30 minutes and 7 days. When changing this value, be\n aware of the following tradeoffs:\n\n - Security: Shorter TTLs provide stronger security, because it reduces the window in which a leaked or intercepted token can be abused by an attacker.\n - Performance: Shorter TTLs mean your app will perform attestation more frequently. Because the app attestation process adds latency to network requests every time it's performed, a short TTL can impact the performance of your app.\n - Quota and cost: Shorter TTLs and frequent re-attestation deplete your quota faster, and for paid services, potentially cost more. See [Quotas \\& limits](/docs/app-check#quotas_limits).\n\n The default TTL\n is reasonable for most apps. Note that the App Check library refreshes\n tokens at approximately half the TTL duration.\n\n2. Add the App Check library to your app\n\nInclude the App Check library in your set of dependencies, following\n[the setup instructions](/docs/unity/setup#add-sdks) for App Check.\n\n3. Initialize App Check\n\nAdd the following initialization code to your app so that it runs before you\nuse any Firebase services including any creation of Firebase Apps. \n\nAndroid\n\n1. Add the using declaration for `Firebase.AppCheck`:\n\n ```c#\n using Firebase.AppCheck\n ```\n2. Initialize the App Check library with the Play Integrity provider:\n\n FirebaseAppCheck.SetAppCheckProviderFactory(\n PlayIntegrityProviderFactory.Instance);\n\niOS+\n\n1. Add the using declaration for `Firebase.AppCheck`:\n\n ```c#\n using Firebase.AppCheck\n ```\n2. Initialize the App Check library with the Device Check or App Attest\n provider:\n\n FirebaseAppCheck.SetAppCheckProviderFactory(\n DeviceCheckProviderFactory.Instance);\n\nNext steps\n\nOnce the App Check library is installed in your app, start distributing the\nupdated app to your users.\n\nThe updated client app will begin sending App Check tokens along with every\nrequest it makes to Firebase, but Firebase products will not require the tokens\nto be valid until you enable enforcement in the App Check section of the\nFirebase console.\n\nMonitor metrics and enable enforcement\n\nBefore you enable enforcement, however, you should make sure that doing so won't\ndisrupt your existing legitimate users. On the other hand, if you're seeing\nsuspicious use of your app resources, you might want to enable enforcement\nsooner.\n\nTo help make this decision, you can look at App Check metrics for the\nservices you use:\n\n- [Monitor App Check request metrics](/docs/app-check/monitor-metrics) for Realtime Database, Cloud Firestore, and Cloud Storage.\n- [Monitor App Check request metrics for Cloud Functions](/docs/app-check/monitor-functions-metrics).\n\nEnable App Check enforcement\n\nWhen you understand how App Check will affect your users and you're ready to\nproceed, you can enable App Check enforcement:\n\n- [Enable App Check enforcement](/docs/app-check/enable-enforcement) for Realtime Database, Cloud Firestore, and Cloud Storage.\n- [Enable App Check enforcement for Cloud Functions](/docs/app-check/cloud-functions).\n\nUse App Check in debug environments\n\nIf, after you have registered your app for App Check, you want to run your\napp in an environment that App Check would normally not classify as valid,\nsuch as on desktop, an emulator during development, or from a continuous\nintegration (CI) environment, you can create a debug build of your app that\nuses the App Check debug provider instead of a real attestation provider.\n\nSee [Use App Check with the debug provider in Unity apps](/docs/app-check/unity/debug-provider)."]]
