דף זה מראה לך כיצד להפעיל App Check באפליקציית אינטרנט, באמצעות ספק reCAPTCHA v3 המובנה. כאשר אתה מפעיל App Check, אתה עוזר להבטיח שרק האפליקציה שלך יכולה לגשת למשאבי Firebase של הפרויקט שלך. ראה סקירה כללית של תכונה זו.
עליך להשתמש ב-reCAPTCHA Enterprise עבור אינטגרציות חדשות, ואנו ממליצים בחום למפתחי אפליקציות המשתמשים ב-reCAPTCHA v3 לשדרג במידת האפשר.
כדי ללמוד את ההבדלים בין reCAPTCHA v3 ל-reCAPTCHA Enterprise, עיין בהשוואת התכונות .
שימו לב ש-reCAPTCHA v3 אינו נראה למשתמשים. ספק reCAPTCHA v3 לא ידרוש מהמשתמשים לפתור אתגר בכל עת. עיין בתיעוד reCAPTCHA v3 .
אם ברצונך להשתמש ב-App Check עם ספק מותאם אישית משלך, ראה יישום ספק App Check מותאם אישית .
1. הגדר את פרויקט Firebase שלך
הוסף את Firebase לפרויקט JavaScript שלך אם עדיין לא עשית זאת.
רשום את האתר שלך ל-reCAPTCHA v3 וקבל את מפתח האתר והמפתח הסודי של reCAPTCHA v3.
רשום את האפליקציות שלך כדי להשתמש ב-App Check עם ספק reCAPTCHA בקטע App Check של מסוף Firebase. תצטרך לספק את המפתח הסודי שקיבלת בשלב הקודם.
בדרך כלל עליך לרשום את כל האפליקציות של הפרויקט שלך, מכיוון שברגע שתפעיל אכיפה עבור מוצר Firebase, רק אפליקציות רשומות יוכלו לגשת למשאבי הקצה האחורי של המוצר.
אופציונלי : בהגדרות רישום האפליקציה, הגדר זמן מותאם אישית עד לחיות (TTL) עבור אסימוני App Check שהונפקו על ידי הספק. אתה יכול להגדיר את ה-TTL לכל ערך בין 30 דקות ל-7 ימים. בעת שינוי ערך זה, שים לב להפרעות הבאות:
- אבטחה: TTL קצרים יותר מספקים אבטחה חזקה יותר, מכיוון שהיא מצמצמת את החלון שבו אסימון שדלף או יורט יכול להיות מנוצל לרעה על ידי תוקף.
- ביצועים: TTL קצר יותר אומר שהאפליקציה שלך תבצע אישור בתדירות גבוהה יותר. מכיוון שתהליך אישור האפליקציה מוסיף זמן אחזור לבקשות הרשת בכל פעם שהוא מבוצע, TTL קצר יכול להשפיע על ביצועי האפליקציה שלך.
- מכסה ועלות: TTL קצרים יותר ואישור חוזר תכוף מוציאים את המכסה שלך מהר יותר, ועבור שירותים בתשלום, פוטנציאל לעלות יותר. ראה מכסות ומגבלות .
ברירת המחדל של TTL של יום אחד היא סבירה עבור רוב האפליקציות. שים לב שספריית App Check מרעננת אסימונים בערך במחצית משך ה-TTL.
2. הוסף את ספריית App Check לאפליקציה שלך
הוסף את Firebase לאפליקציית האינטרנט שלך אם עדיין לא עשית זאת. הקפד לייבא את ספריית App Check.
3. אתחול App Check
הוסף את קוד האתחול הבא לאפליקציה שלך, לפני שתיגש לשירותי Firebase כלשהם. תצטרך להעביר את מפתח האתר reCAPTCHA שלך, שיצרת במסוף reCAPTCHA, כדי activate()
.
Web modular API
import { initializeApp } from "firebase/app"; import { initializeAppCheck, ReCaptchaV3Provider } from "firebase/app-check"; const app = initializeApp({ // Your firebase configuration object }); // Pass your reCAPTCHA v3 site key (public key) to activate(). Make sure this // key is the counterpart to the secret key you set in the Firebase console. const appCheck = initializeAppCheck(app, { provider: new ReCaptchaV3Provider('abcdefghijklmnopqrstuvwxy-1234567890abcd'), // Optional argument. If true, the SDK automatically refreshes App Check // tokens as needed. isTokenAutoRefreshEnabled: true });
Web namespaced API
firebase.initializeApp({ // Your firebase configuration object }); const appCheck = firebase.appCheck(); // Pass your reCAPTCHA v3 site key (public key) to activate(). Make sure this // key is the counterpart to the secret key you set in the Firebase console. appCheck.activate( 'abcdefghijklmnopqrstuvwxy-1234567890abcd', // Optional argument. If true, the SDK automatically refreshes App Check // tokens as needed. true);
הצעדים הבאים
לאחר שספריית App Check מותקנת באפליקציה שלך, פרוס אותה.
אפליקציית הלקוח המעודכנת תתחיל לשלוח אסימוני App Check יחד עם כל בקשה שהיא תגיש ל-Firebase, אך מוצרי Firebase לא ידרשו שהאסימונים יהיו תקפים עד שתפעיל אכיפה בקטע App Check של מסוף Firebase.
עקוב אחר מדדים ואפשר אכיפה
עם זאת, לפני שתפעיל אכיפה, עליך לוודא כי פעולה זו לא תפריע למשתמשים הלגיטימיים הקיימים שלך. מצד שני, אם אתה רואה שימוש חשוד במשאבי האפליקציה שלך, אולי תרצה לאפשר אכיפה מוקדם יותר.
כדי לעזור בקבלת החלטה זו, תוכל להסתכל על מדדי App Check עבור השירותים שבהם אתה משתמש:
- עקוב אחר מדדי בקשות לבדיקת אפליקציה עבור מסד נתונים בזמן אמת, Cloud Firestore, אחסון בענן ואימות (ביטא).
- מעקב אחר מדדי בקשת בדיקת אפליקציה עבור פונקציות ענן .
הפעל אכיפת בדיקת אפליקציות
כשתבין כיצד בדיקת אפליקציות תשפיע על המשתמשים שלך ואתה מוכן להמשיך, תוכל להפעיל את אכיפת בדיקת האפליקציה:
- אפשר אכיפת בדיקת אפליקציות עבור מסד נתונים בזמן אמת, Cloud Firestore, אחסון בענן ואימות (ביטא).
- אפשר אכיפת בדיקת אפליקציות עבור פונקציות ענן .
השתמש ב-App Check בסביבות ניפוי באגים
אם, לאחר שרשמתם את האפליקציה שלכם ל-App Check, ברצונכם להפעיל את האפליקציה שלכם בסביבה שבדרך כלל לא תסווג אותה כתקינה, כגון מקומית במהלך הפיתוח, או מסביבת אינטגרציה מתמשכת (CI), תוכלו ליצור בניית באגים של האפליקציה שלך שמשתמשת בספק ניפוי באגים של App Check במקום בספק אישור אמיתי.
ראה שימוש בבדיקת אפליקציות עם ספק ניפוי הבאגים באפליקציות אינטרנט .