דף זה מראה לך כיצד להפעיל בדיקת אפליקציות באפליקציית C++, באמצעות ספק בדיקת האפליקציות המותאם אישית שלך . כאשר אתה מפעיל App Check, אתה עוזר להבטיח שרק האפליקציה שלך יכולה לגשת למשאבי Firebase של הפרויקט שלך.
אם ברצונך להשתמש ב-App Check עם ספקי ברירת המחדל, ראה הפעל App Check עם ספקי ברירת מחדל עם C++ .
לפני שאתה מתחיל
הוסף את Firebase לפרויקט C++ שלך אם עדיין לא עשית זאת.
יישם את ההיגיון בצד השרת של ספק האפליקציה המותאם אישית שלך .
1. הוסף את ספריית App Check לאפליקציה שלך
כלול את ספריית App Check במערך התלות שלך, בצע את הוראות ההגדרה עבור App Check.
2. הטמעת ממשקי App Check
ראשית, עליך ליצור מחלקות המיישמות את ממשקי AppCheckProvider
ו- AppCheckProviderFactory
.
מחלקה AppCheckProvider
שלך חייבת להיות בשיטת GetToken()
אשר אוספת כל מידע שספק ה-App Check המותאם אישית שלך דורש כהוכחה לאותנטיות, ושולחת אותו לשירות רכישת האסימון שלך בתמורה לאסימון App Check. ה-App Check SDK מטפל בשמירה במטמון של אסימון, אז קבל תמיד אסימון חדש בהטמעת GetToken()
.
class YourCustomAppCheckProvider : public AppCheckProvider {
void GetToken(std::function<void(AppCheckToken, int, const std::string&)>
completion_callback) {
// Logic to exchange proof of authenticity for an App Check token and
// expiration time.
// ...
// Create AppCheckToken object.
AppCheckToken appCheckToken;
appCheckToken.token = token;
appCheckToken.expire_time_millis = expireTime;
completion_callback(appCheckToken, 0, "");
// Or, if needing to return an error
//completion_callback({}, error_code, "Error description");
}
};
כמו כן, הטמע מחלקה של AppCheckProviderFactory
שיוצרת מופעים של הטמעת AppCheckProvider
שלך:
class YourCustomAppCheckProviderFactory : public AppCheckProviderFactory {
AppCheckProvider* CreateProvider(App* app) {
// Create and return an AppCheckProvider object.
return new YourCustomAppCheckProvider(app);
}
}
3. אתחול App Check
הוסף את קוד האתחול הבא לאפליקציה שלך כך שהיא תפעל לפני שתשתמש ב-SDK אחר של Firebase:
firebase::app_check::AppCheck::SetAppCheckProviderFactory(
YourCustomAppCheckProviderFactory::GetInstance());
הצעדים הבאים
לאחר התקנת ספריית App Check באפליקציה שלך, התחל להפיץ את האפליקציה המעודכנת למשתמשים שלך.
אפליקציית הלקוח המעודכנת תתחיל לשלוח אסימוני App Check יחד עם כל בקשה שהיא תגיש ל-Firebase, אך מוצרי Firebase לא ידרשו שהאסימונים יהיו תקפים עד שתפעיל אכיפה בקטע App Check של מסוף Firebase.
עקוב אחר מדדים ואפשר אכיפה
עם זאת, לפני שתפעיל אכיפה, עליך לוודא כי פעולה זו לא תפריע למשתמשים הלגיטימיים הקיימים שלך. מצד שני, אם אתה רואה שימוש חשוד במשאבי האפליקציה שלך, אולי תרצה לאפשר אכיפה מוקדם יותר.
כדי לעזור בקבלת החלטה זו, תוכל להסתכל על מדדי App Check עבור השירותים שבהם אתה משתמש:
- עקוב אחר מדדי בקשות לבדיקת אפליקציה עבור מסד נתונים בזמן אמת, Cloud Firestore, אחסון בענן ואימות (ביטא).
- מעקב אחר מדדי בקשת בדיקת אפליקציה עבור פונקציות ענן .
הפעל אכיפת בדיקת אפליקציות
כשתבין כיצד בדיקת אפליקציות תשפיע על המשתמשים שלך ואתה מוכן להמשיך, תוכל להפעיל את אכיפת בדיקת האפליקציה:
- אפשר אכיפת בדיקת אפליקציות עבור מסד נתונים בזמן אמת, Cloud Firestore, אחסון בענן ואימות (ביטא).
- אפשר אכיפת בדיקת אפליקציות עבור פונקציות ענן .
השתמש ב-App Check בסביבות ניפוי באגים
אם, לאחר שרשמתם את האפליקציה שלכם ל-App Check, ברצונכם להפעיל את האפליקציה שלכם בסביבה שבדרך כלל לא תסווג אותה כתקינה, כגון אמולטור במהלך הפיתוח, או מסביבת אינטגרציה מתמשכת (CI), תוכלו צור בניית באגים של האפליקציה שלך המשתמשת בספק ניפוי באגים של App Check במקום בספק אישור אמיתי.
ראה בדיקת שימוש באפליקציה עם ספק ניפוי הבאגים עם C++ .