این صفحه به شما نشان میدهد که چگونه App Check را در یک برنامه C++ با استفاده از ارائهدهندگان پیشفرض فعال کنید: Play Integrity در اندروید و Device Check یا App Attest در پلتفرمهای اپل. وقتی App Check را فعال میکنید، به شما اطمینان میدهیم که فقط برنامه شما میتواند به منابع Firebase پروژه شما دسترسی داشته باشد. به نمای کلی این ویژگی مراجعه کنید.
۱. پروژه فایربیس خود را راهاندازی کنید
اگر قبلاً Firebase را به پروژه C++ خود اضافه نکردهاید، آن را اضافه کنید .
برنامههای خود را برای استفاده از App Check با ارائهدهندگان Play Integrity، Device Check یا App Attest در بخش Project Settings > App Check کنسول Firebase ثبت کنید.
شما معمولاً باید تمام برنامههای پروژه خود را ثبت کنید، زیرا به محض اینکه اجرای قانون را برای یک محصول Firebase فعال کنید، فقط برنامههای ثبت شده میتوانند به منابع backend محصول دسترسی داشته باشند.
برای دستورالعملهای دقیق در مورد نحوه ثبت نام در هر ارائه دهنده، به مستندات خاص اندروید و iOS مراجعه کنید.
اختیاری : در تنظیمات ثبت برنامه، یک زمان ماندگاری (TTL) سفارشی برای توکنهای App Check صادر شده توسط ارائهدهنده تنظیم کنید. میتوانید TTL را روی هر مقداری بین 30 دقیقه تا 7 روز تنظیم کنید. هنگام تغییر این مقدار، به موارد زیر توجه داشته باشید:
- امنیت: TTL های کوتاه تر امنیت قوی تری را فراهم می کنند، زیرا بازه زمانی که یک توکن فاش شده یا رهگیری شده می تواند توسط یک مهاجم مورد سوء استفاده قرار گیرد را کاهش می دهند.
- عملکرد: هرچه TTL های کوتاهتر باشند، برنامه شما دفعات بیشتری عملیات تصدیق را انجام میدهد. از آنجایی که فرآیند تصدیق برنامه هر بار که انجام میشود، به درخواستهای شبکه تأخیر اضافه میکند، TTL کوتاه میتواند بر عملکرد برنامه شما تأثیر بگذارد.
- سهمیه و هزینه: TTL های کوتاه تر و تأیید مجدد مکرر، سهمیه شما را سریعتر تمام می کند و برای خدمات پولی، احتمالاً هزینه بیشتری دارد. به سهمیه ها و محدودیت ها مراجعه کنید.
مدت زمان پیشفرض TTL برای اکثر برنامهها معقول است. توجه داشته باشید که کتابخانه App Check تقریباً در نصف مدت زمان TTL، توکنها را بهروزرسانی میکند.
۲. کتابخانه App Check را به برنامه خود اضافه کنید
کتابخانه App Check را با دنبال کردن دستورالعملهای راهاندازی App Check، به مجموعه وابستگیهای خود اضافه کنید.
۳. بررسی اولیه برنامه
کد مقداردهی اولیه زیر را به برنامه خود اضافه کنید تا قبل از استفاده از هرگونه سرویس Firebase، از جمله ایجاد هرگونه برنامه Firebase، اجرا شود.
اندروید
فایل هدر مربوط به
firebase::app_checkاضافه کنید:#include "firebase/app_check.h"
کتابخانه App Check را با استفاده از ارائهدهنده Play Integrity مقداردهی اولیه کنید:
firebase::app_check::AppCheck::SetAppCheckProviderFactory( firebase::app_check::PlayIntegrityProviderFactory::GetInstance());
آیاواس+
فایل هدر مربوط به
firebase::app_checkاضافه کنید:#include "firebase/app_check.h"
کتابخانه App Check را با استفاده از ارائهدهنده Device Check یا App Attest مقداردهی اولیه کنید:
firebase::app_check::AppCheck::SetAppCheckProviderFactory( firebase::app_check::DeviceCheckProviderFactory::GetInstance());
مراحل بعدی
پس از نصب کتابخانه App Check در برنامه خود، شروع به توزیع برنامه بهروزرسانیشده بین کاربران خود کنید.
برنامه کلاینت بهروزرسانیشده، همراه با هر درخواستی که به Firebase ارسال میکند، شروع به ارسال توکنهای App Check میکند، اما محصولات Firebase تا زمانی که شما در بخش App Check کنسول Firebase، اجرای این کدها را فعال نکنید، نیازی به معتبر بودن آنها نخواهند داشت.
نظارت بر معیارها و فعال کردن اجرای آنها
با این حال، قبل از فعال کردن اجرای قانون، باید مطمئن شوید که انجام این کار، کاربران قانونی فعلی شما را مختل نمیکند. از طرف دیگر، اگر استفاده مشکوکی از منابع برنامه خود مشاهده میکنید، بهتر است زودتر اجرای قانون را فعال کنید.
برای کمک به تصمیمگیری، میتوانید به معیارهای App Check برای سرویسهایی که استفاده میکنید نگاهی بیندازید:
- نظارت بر برنامه بررسی معیارهای درخواست برای پایگاه داده Realtime، Cloud Firestore و Cloud Storage.
- نظارت بر برنامه، بررسی معیارهای درخواست برای عملکردهای ابری .
فعال کردن اجرای بررسی برنامه
وقتی فهمیدید که App Check چگونه بر کاربران شما تأثیر میگذارد و آماده ادامه کار بودید، میتوانید اجرای App Check را فعال کنید:
- فعال کردن اجرای App Check برای Realtime Database، Cloud Firestore و Cloud Storage.
- فعال کردن اجرای بررسی برنامه برای عملکردهای ابری .
استفاده از App Check در محیطهای اشکالزدایی
اگر پس از ثبت برنامه خود برای App Check، میخواهید برنامه خود را در محیطی اجرا کنید که App Check معمولاً آن را معتبر نمیداند، مانند روی دسکتاپ، یک شبیهساز در حین توسعه یا از یک محیط ادغام مداوم (CI)، میتوانید یک نسخه اشکالزدایی از برنامه خود ایجاد کنید که از ارائهدهنده اشکالزدایی App Check به جای یک ارائهدهنده گواهی واقعی استفاده میکند.
به بخش «استفاده از بررسی برنامه با ارائهدهنده اشکالزدایی در برنامههای C++» مراجعه کنید.