به عنوان بخشی از ثبت برنامه خود در کنسول Firebase برای استفاده از ارائه دهنده reCAPTCHA Enterprise ، باید یک کلید reCAPTCHA برای برنامه خود ارائه دهید. App Check از کلیدهای reCAPTCHA مبتنی بر امتیاز استفاده میکند، که آن را برای کاربران نامرئی میکند. این بدان معناست که ارائه دهنده reCAPTCHA Enterprise از کاربران نمیخواهد که در هر زمانی چالشی را حل کنند.
این صفحه نحوه ایجاد این کلیدهای مبتنی بر امتیاز را برای استفاده در پلتفرمهای زیر شرح میدهد: وب ، اندروید و اپل . همچنین میتوانید دستورالعملهای دقیقتر را در مستندات reCAPTCHA Enterprise برای برنامههای وب و برنامههای تلفن همراه بیابید.
برای فلاتر، میتوانید دستورالعملهای مربوط به پلتفرمهایی که پروژه شما هدف قرار میدهد را دنبال کنید.
قبل از اینکه شروع کنی
قبل از ایجاد کلیدهای reCAPTCHA مبتنی بر امتیاز برای برنامههای روی پلتفرمهای زیر، این الزامات و توصیهها را بررسی کنید: وب ، اندروید و اپل .
مجوزهای مورد نیاز IAM
مطمئن شوید که نقش IAM زیر را دارید: reCAPTCHA Enterprise Admin ( roles/recaptchaenterprise.admin ).
توصیههای عمومی
هیچ محدودیتی در تعداد کلیدهای reCAPTCHA که میتوانید برای یک پروژه Firebase ایجاد کنید وجود ندارد. در اینجا توصیههای کلی برای ایجاد کلیدهای reCAPTCHA برای تنظیمات رایج پروژههای Firebase ارائه شده است:
برای هر یک از برنامههای ثبتشدهی فایربیس خود یک کلید ایجاد کنید. برای مثال:
اگر یک برنامه iOS، اندروید و وب دارید که پروژه Firebase یکسانی را به اشتراک میگذارند، پروژه شما باید سه کلید داشته باشد.
اگر چندین برنامه از یک پلتفرم دارید که پروژه Firebase یکسانی را به اشتراک میگذارند، پروژه شما باید برای هر یک از آن برنامهها یک کلید داشته باشد.
برای برنامههای توسعه، مرحلهبندی و تولید، کلیدهای جداگانه ایجاد کنید (هر یک از این انواع باید از قبل از یک پروژه Firebase جداگانه استفاده کنند). در غیر این صورت، شما با دادههای محیطهای غیرتولیدی خود، تجزیه و تحلیل ریسک reCAPTCHA Enterprise را در معرض خطر قرار میدهید.
وب
برای ایجاد یک کلید مبتنی بر امتیاز، میتوانید از کنسول Google Cloud ، gcloud CLI یا REST API استفاده کنید.
برای وبسایتها، کلید reCAPTCHA منحصر به دامنهها و زیردامنههایی است که شما مشخص میکنید. اگر وبسایت خود را از چندین دامنه ارائه میدهید، میتوانید بیش از یک دامنه را مشخص کنید. اگر یک دامنه (مثلاً examplepetstore.com ) را مشخص کنید، نیازی به مشخص کردن زیردامنههای آن (مثلاً subdomain.examplepetstore.com ) ندارید.
کنسول Google Cloud
در کنسول Google Cloud ، به صفحه دفاع در برابر کلاهبرداری (جایی که کلیدهای reCAPTCHA تنظیم میکنید) بروید.
مطمئن شوید که در پروژه صحیح هستید (به انتخابگر پروژه در بالای صفحه مراجعه کنید).
روی کلید ایجاد کلیک کنید.
در فیلد نام نمایشی ، یک نام نمایشی برای کلید وارد کنید.
برای نوع برنامه ، وب را انتخاب کنید.
برای محافظت از کلید دامنه و زیردامنههای خود، مطمئن شوید که گزینهی «غیرفعال کردن تأیید دامنه» غیرفعال است.
در بخش فهرست دامنهها ، موارد زیر را انجام دهید:
روی افزودن دامنه کلیک کنید.
در قسمت دامنه ، نام دامنه خود را وارد کنید.
(اختیاری) برای افزودن یک دامنه دیگر، روی افزودن دامنه کلیک کنید و نام دامنه دیگری را وارد کنید.
App Check از برنامههای تحت وبی که روی بیش از ۲۵۰ دامنه سرویس میدهند، پشتیبانی نمیکند .
هرگز
localhostبه عنوان دامنه به کلید reCAPTCHA که برای تولید استفاده میشود (یا قرار است برای تولید استفاده شود) اضافه نکنید.
(اختیاری) اگر در حال ایجاد یک کلید آزمون برای برنامه غیرتولیدی خود هستید و اگر میخواهید نمرهای را مشخص کنید که میخواهید کلید هنگام ایجاد هرگونه ارزیابی برای آن، آن را برگرداند، موارد زیر را انجام دهید:
برای دسترسی به مرحله تنظیمات تکمیلی ، روی مرحله بعدی (اختیاری) کلیک کنید.
گزینهی « آیا از چالشها استفاده خواهید کرد؟» را فعال نکنید .
گزینهی « آیا این کلید را فقط برای اهداف آزمایشی ایجاد میکنید؟» را فعال کنید، سپس از نوار لغزندهی «تنظیم امتیاز» برای تعیین امتیازی بین ۰ تا ۱.۰ استفاده کنید.
روی کلید ایجاد کلیک کنید.
کلید تازه ایجاد شده در صفحه کلیدهای reCAPTCHA در کنسول Google Cloud فهرست شده است.
gcloud CLI
برای ایجاد یک کلید مبتنی بر امتیاز با استفاده از gcloud CLI ، دستورالعملهای موجود در مستندات reCAPTCHA Enterprise را دنبال کنید.
استراحت
برای ایجاد یک کلید مبتنی بر امتیاز با استفاده از REST API، دستورالعملهای موجود در مستندات reCAPTCHA Enterprise را دنبال کنید.
اندروید
برای ایجاد یک کلید مبتنی بر امتیاز، میتوانید از کنسول Google Cloud ، gcloud CLI یا REST API استفاده کنید.
کنسول Google Cloud
در کنسول Google Cloud ، به صفحه دفاع در برابر کلاهبرداری (جایی که کلیدهای reCAPTCHA تنظیم میکنید) بروید.
مطمئن شوید که در پروژه صحیح هستید (به انتخابگر پروژه در بالای صفحه مراجعه کنید).
روی کلید ایجاد کلیک کنید.
در فیلد نام نمایشی ، یک نام نمایشی برای کلید وارد کنید.
برای نوع برنامه ، اندروید را انتخاب کنید.
برای محافظت از کلید برنامه اندروید خود، مطمئن شوید که گزینه غیرفعال کردن تأیید نام بسته غیرفعال است.
در بخش فهرست بستههای اندروید ، موارد زیر را انجام دهید:
روی افزودن بسته اندروید کلیک کنید.
در فیلد بسته اندروید ، نام بسته برنامه اندروید خود را وارد کنید (برای مثال،
com.example.my_app).مطمئن شوید که همان نام بستهای را که هنگام ایجاد برنامه اندروید Firebase خود در پروژه Firebase خود ارائه دادید، وارد میکنید. مقدار نام بسته به حروف کوچک و بزرگ حساس است.
برای App Check ، هر نام بسته فقط میتواند به یک کلید reCAPTCHA مربوط باشد.
اگر میخواهید برای برنامهای که علاوه بر Google Play Store ، در فروشگاههای برنامه دیگر نیز موجود است، کلید ایجاد کنید، گزینه « پشتیبانی از برنامههای توزیعشده در خارج از فروشگاه گوگل پلی» را فعال کنید.
(اختیاری) اگر در حال ایجاد یک کلید آزمون برای برنامه غیرتولیدی خود هستید و اگر میخواهید نمرهای را مشخص کنید که میخواهید کلید هنگام ایجاد هرگونه ارزیابی برای آن، آن را برگرداند، موارد زیر را انجام دهید:
برای دسترسی به مرحله تنظیمات تکمیلی ، روی مرحله بعدی (اختیاری) کلیک کنید.
گزینهی « آیا از چالشها استفاده خواهید کرد؟» را فعال نکنید .
گزینهی « آیا این کلید را فقط برای اهداف آزمایشی ایجاد میکنید؟» را فعال کنید، سپس از نوار لغزندهی «تنظیم امتیاز» برای تعیین امتیازی بین ۰ تا ۱.۰ استفاده کنید.
روی کلید ایجاد کلیک کنید.
کلید تازه ایجاد شده در صفحه کلیدهای reCAPTCHA در کنسول Google Cloud فهرست شده است.
gcloud CLI
برای ایجاد یک کلید مبتنی بر امتیاز با استفاده از gcloud CLI ، دستورالعملهای موجود در مستندات reCAPTCHA Enterprise را دنبال کنید.
استراحت
برای ایجاد یک کلید مبتنی بر امتیاز با استفاده از REST API، دستورالعملهای موجود در مستندات reCAPTCHA Enterprise را دنبال کنید.
پلتفرمهای اپل
برای ایجاد یک کلید مبتنی بر امتیاز، میتوانید از کنسول Google Cloud ، gcloud CLI یا REST API استفاده کنید.
کنسول Google Cloud
در کنسول Google Cloud ، به صفحه دفاع در برابر کلاهبرداری (جایی که کلیدهای reCAPTCHA تنظیم میکنید) بروید.
مطمئن شوید که در پروژه صحیح هستید (به انتخابگر پروژه در بالای صفحه مراجعه کنید).
روی کلید ایجاد کلیک کنید.
در فیلد نام نمایشی ، یک نام نمایشی برای کلید وارد کنید.
برای نوع برنامه ، iOS را انتخاب کنید.
برای محافظت از کلید برنامه پلتفرم اپل خود، مطمئن شوید که گزینه غیرفعال کردن تأیید شناسه بسته، غیرفعال است.
در بخش فهرست شناسه بسته iOS ، موارد زیر را انجام دهید:
روی افزودن شناسه بسته iOS کلیک کنید.
در فیلد شناسه بسته (Bundle ID )، شناسه بسته برنامه خود را وارد کنید (برای مثال،
com.example.my_app).مطمئن شوید که همان شناسه بستهای را که هنگام ایجاد برنامه Firebase Apple خود ارائه دادید، در پروژه Firebase خود وارد میکنید. مقدار شناسه بسته به حروف کوچک و بزرگ حساس است.
برای App Check ، هر شناسه بسته فقط میتواند با یک کلید reCAPTCHA مطابقت داشته باشد.
(اختیاری) برای افزودن یک شناسه بسته اضافی، روی افزودن شناسه بسته iOS کلیک کنید و یک شناسه بسته دیگر وارد کنید.
تنظیمات توسعهدهندگان اپل را ارائه دهید.
ما اکیداً توصیه میکنیم این دادهها را ارائه دهید زیرا به reCAPTCHA Enterprise اجازه میدهد نمرات ریسک دقیقتری برای ترافیک شما ارائه دهد.
اطلاعات زیر را وارد کنید:
کلید خصوصی (.p8) : این کلید در مرکز توسعهدهندگان اپل و در بخش گواهینامهها، شناسهها و پروفایلها تولید میشود.
شناسه کلید : شناسه کلید توسعهدهنده اپل (رشتهای ۱۰ کاراکتری).
شناسه تیم : شناسه تیم اپل (رشتهای ۱۰ کاراکتری) که مالک پروفایل تأمینکنندهای است که برای ساخت برنامه شما استفاده میشود.
(اختیاری) اگر در حال ایجاد یک کلید آزمون برای برنامه غیرتولیدی خود هستید و اگر میخواهید نمرهای را مشخص کنید که میخواهید کلید هنگام ایجاد هرگونه ارزیابی برای آن، آن را برگرداند، موارد زیر را انجام دهید:
برای دسترسی به مرحله تنظیمات تکمیلی ، روی مرحله بعدی (اختیاری) کلیک کنید.
گزینهی « آیا از چالشها استفاده خواهید کرد؟» را فعال نکنید .
گزینهی « آیا این کلید را فقط برای اهداف آزمایشی ایجاد میکنید؟» را فعال کنید، سپس از نوار لغزندهی «تنظیم امتیاز» برای تعیین امتیازی بین ۰ تا ۱.۰ استفاده کنید.
روی کلید ایجاد کلیک کنید.
کلید تازه ایجاد شده در صفحه کلیدهای reCAPTCHA در کنسول Google Cloud فهرست شده است.
gcloud CLI
برای ایجاد یک کلید مبتنی بر امتیاز با استفاده از gcloud CLI ، دستورالعملهای موجود در مستندات reCAPTCHA Enterprise را دنبال کنید.
استراحت
برای ایجاد یک کلید مبتنی بر امتیاز با استفاده از REST API، دستورالعملهای موجود در مستندات reCAPTCHA Enterprise را دنبال کنید.