سوالات متداول

آیا باید از reCAPTCHA Enterprise استفاده کنم؟

reCAPTCHA Enterprise تا 10،000 ارزیابی در ماه را به صورت رایگان ارائه می‌دهد و همچنین ویژگی‌های اضافی را نیز ارائه می‌دهد. ویژگی‌های دیگر مانند تجزیه و تحلیل بلادرنگ، بهترین نقطه شروع را برای اکثر توسعه‌دهندگان فراهم می‌کند. از اینجا شروع کنید.

آیا می‌توانم از reCAPTCHA با راه‌حل‌های شخص ثالث استفاده کنم؟

بله، می‌توانید از هر دو reCAPTCHA (نسخه غیر سازمانی) و reCAPTCHA سازمانی استفاده کنید. معمولاً راه‌حل‌های شخص ثالث، کلید عمومی و کلید مخفی یا کلید API شما را درخواست می‌کنند. مطمئن شوید که کلید مخفی و کلید API خود را فقط به اشخاص ثالث مورد اعتماد ارائه می‌دهید.

چگونه از نسخه ۲ یا ۳ به reCAPTCHA Enterprise مهاجرت کنیم؟

فرآیند مهاجرت ۵ تا ۱۰ دقیقه طول می‌کشد و نیازی به تغییر کد ندارد.

آیا باید از reCAPTCHA نسخه ۲ یا نسخه ۳ استفاده کنم؟

reCAPTCHA نسخه ۳ برای صاحبان سایت‌هایی است که می‌خواهند اطلاعات بیشتری در مورد ترافیک خود داشته باشند. برای اطلاعات بیشتر، به راهنمای توسعه‌دهنده reCAPTCHA نسخه ۳ مراجعه کنید.

ما از امنیت و قابلیت استفاده برای نسخه ۲ پشتیبانی می‌کنیم.

برای اطلاعات بیشتر در مورد تفاوت‌های reCAPTCHA نسخه ۲ و ۳، به مقایسه نسخه‌ها مراجعه کنید.

آیا reCAPTCHA از کوکی‌ها استفاده می‌کند؟

reCAPTCHA هنگام اجرا، یک کوکی ضروری (_GRECAPTCHA) را برای ارائه تحلیل ریسک خود تنظیم می‌کند. اگر ترجیح می‌دهید از دامنه www.google.com که ممکن است کوکی‌های دیگری تنظیم کرده باشد استفاده نکنید، می‌توانید به جای آن از www.recaptcha.net استفاده کنید.

آیا محدودیت QPS یا محدودیت روزانه‌ای برای استفاده از reCAPTCHA وجود دارد؟

اگر می‌خواهید بیش از ۱۰۰۰ تماس در ثانیه یا ۱،۰۰۰،۰۰۰ تماس در ماه برقرار کنید، باید از reCAPTCHA Enterprise استفاده کنید یا این فرم را پر کنید و منتظر تأیید استثنا باشید. اگر یک کلید سایت از ۱۰۰۰ QPS تجاوز کند، ممکن است برخی از درخواست‌ها پردازش نشوند. اگر یک کلید سایت نسخه ۳ از سهمیه ماهانه خود فراتر رود، ممکن است `site_verify` با برگرداندن امتیاز ثابت ۰.۹ و پیام خطای `"بیش از سهمیه رایگان."` برای بقیه ماه از باز شدن باز بماند. هیچ نشانه‌ای برای کاربر وجود ندارد که نشان دهد سایت‌های نسخه ۳ از سهمیه فراتر رفته‌اند. اگر یک کلید سایت نسخه ۲ از سهمیه ماهانه خود فراتر رود، ممکن است پیام زیر یا مشابه آن برای بقیه ماه در ویجت reCAPTCHA برای کاربران نمایش داده شود: `این سایت از سهمیه reCAPTCHA فراتر رفته است.` قبل از اعمال سهمیه، به صاحبان سایت سه بار از طریق ایمیل اطلاع داده می‌شود و حداقل ۹۰ روز فرصت داده می‌شود تا به reCAPTCHA Enterprise مهاجرت کنند. اگر بیش از ۱,۰۰۰,۰۰۰ تماس در ماه برای هر دامنه‌ای استفاده شود، کلیدهای سایت بیش از سهمیه در نظر گرفته می‌شوند. این شامل مواردی نیز می‌شود که این حجم در چندین کلید در همان دامنه پخش شده باشد.

می‌خواهم نشان reCAPTCHA را پنهان کنم. چه چیزی مجاز است؟

شما مجاز به پنهان کردن نشان هستید، به شرطی که برند reCAPTCHA را به طور قابل مشاهده در جریان کاربری قرار دهید. لطفاً متن زیر را وارد کنید:

This site is protected by reCAPTCHA and the Google
    <a href="https://policies.google.com/privacy">Privacy Policy</a> and
    <a href="https://policies.google.com/terms">Terms of Service</a> apply.

برای مثال:

توجه: اگر تصمیم به پنهان کردن نشان دارید، لطفاً از

.grecaptcha-badge { visibility: hidden; }

می‌خواهم تست‌های خودکار را با reCAPTCHA اجرا کنم. چه کاری باید انجام دهم؟

برای reCAPTCHA نسخه ۳، یک کلید جداگانه برای محیط‌های آزمایشی ایجاد کنید. ممکن است امتیازها دقیق نباشند زیرا reCAPTCHA نسخه ۳ به مشاهده ترافیک واقعی متکی است.

برای reCAPTCHA نسخه ۲، از کلیدهای تست زیر استفاده کنید. همیشه با پیغام No CAPTCHA مواجه خواهید شد و تمام درخواست‌های تأیید با موفقیت انجام می‌شوند.

• کلید سایت: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
• کلید مخفی: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

ویجت reCAPTCHA یک پیام هشدار نشان می‌دهد تا مطمئن شود که برای ترافیک عملیاتی استفاده نمی‌شود.

چگونه می‌توانم هنگام اشکال‌زدایی سایتم از مواجهه با کد reCAPTCHA جلوگیری کنم؟

برای جلوگیری از ورود به کد reCAPTCHA هنگام اشکال‌زدایی سایر کدهای جاوا اسکریپت در سایت خود، اسکریپت reCAPTCHA /recaptcha__.+\.js$ را به لیست نادیده گرفتن مرورگر خود اضافه کنید. برای دستورالعمل‌های مربوط به کروم، به نادیده گرفتن لیست سفارشی اسکریپت‌ها مراجعه کنید. ویژگی‌های مشابه در مرورگرهای دیگر نیز موجود است.

چگونه می‌توانم اطلاعات بیشتری در مورد ترافیک وب‌سایتم ببینم؟

reCAPTCHA آمار روزانه را در کنسول مدیریت گزارش می‌دهد.

آیا می‌توانم از reCAPTCHA به صورت سراسری استفاده کنم؟

بله، لطفاً در شرایطی که «www.google.com» در دسترس نیست، از «www.recaptcha.net» در کد خود استفاده کنید.

• ابتدا، <script src=" https://www.google.com /recaptcha/api.js"></script> را با <script src=" https://www.recaptcha.net /recaptcha/api.js"></script> جایگزین کنید.
• پس از آن، همین کار را در هر جای دیگری که از "www.google.com/recaptcha/" در سایت شما استفاده می‌شود، اعمال کنید.

آیا می‌توانم ویجت یا نشان reCAPTCHA را سفارشی کنم؟

بله. reCAPTCHA دو تم روشن و تیره ارائه می‌دهد، همانطور که در زیر نشان داده شده است. برای انتخاب یک تم، کافیست ویژگی data-theme را در پارامتر grecaptcha.render تنظیم کنید.

تم روشن:

تم تاریک:

چگونه می‌توانم reCAPTCHA نسخه ۳ را سفارشی کنم؟

API جاوا اسکریپت موجود برای Invisible reCAPTCHA برای نسخه ۳ نیز کار می‌کند. کافیست از API جاوا اسکریپت برای رندر صریح reCAPTCHA با یک کلید سایت نسخه ۳ استفاده کنید تا به گزینه‌هایی مانند تغییر موقعیت نشان یا تغییر تم دسترسی پیدا کنید.

هنگام رندر کردن reCAPTCHA نسخه ۳ با این روش، به یاد داشته باشید که پارامتر size را روی 'invisible' تنظیم کنید و هنگام فراخوانی grecaptcha.execute به جای کلید سایت، از شناسه کلاینت برگردانده شده توسط grecaptcha.render استفاده کنید.

اخیراً ویجت reCAPTCHA من شروع به نمایش عبارت "کلید سایت نامعتبر است" کرده است. چه اتفاقی می‌افتد؟

اگر این خطا را مشاهده می‌کنید، کلید سایت reCAPTCHA شما دیگر معتبر نیست. برای فعال‌سازی، لطفاً یک کلید جدید ثبت کنید و دستورالعمل‌های موجود در آن صفحه را دنبال کنید.

من با خطای uncaught SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "&ltyour domain&gt" مواجه می‌شوم. چه کاری باید انجام دهم؟

این معمولاً زمانی اتفاق می‌افتد که عنصر HTML ویجت reCAPTCHA مدتی پس از کلیک کاربر نهایی روی کادر انتخاب، به صورت برنامه‌نویسی حذف شود. توصیه می‌کنیم از تابع جاوا اسکریپت grecaptcha.reset() برای تنظیم مجدد ویجت reCAPTCHA استفاده کنید.

من در وب‌سایتم از سیاست امنیت محتوا (CSP) استفاده می‌کنم. چگونه می‌توانم آن را طوری پیکربندی کنم که با reCAPTCHA کار کند؟

ما توصیه می‌کنیم از رویکرد مبتنی بر nonce که با CSP3 مستند شده است استفاده کنید. حتماً nonce خود را در تگ اسکریپت reCAPTCHA api.js قرار دهید و بقیه کار را ما انجام خواهیم داد.

نکته: reCAPTCHA در مرورگرهایی که از 'strict-dynamic' پشتیبانی می‌کنند، با آن نیز کار می‌کند.

روش دیگر، لطفاً مقادیر زیر را به دستورالعمل‌ها اضافه کنید:

• اسکریپت-src https://www.google.com/recaptcha/، https://www.gstatic.com/recaptcha/
• فریم-اس‌آرسی https://www.google.com/recaptcha/، https://recaptcha.google.com/recaptcha/
• اتصال-src https://www.google.com/recaptcha/

من با خطای «Localhost در لیست دامنه‌های پشتیبانی‌شده نیست» مواجه می‌شوم. چه کاری باید انجام دهم؟

دامنه‌های localhost به طور پیش‌فرض پشتیبانی نمی‌شوند. اگر می‌خواهید به پشتیبانی از آنها برای توسعه ادامه دهید، می‌توانید آنها را به لیست دامنه‌های پشتیبانی شده برای کلید سایت خود اضافه کنید. برای به‌روزرسانی لیست دامنه‌های پشتیبانی شده خود، به کنسول reCAPTCHA Enterprise یا کنسول reCAPTCHA ، در صورت لزوم، مراجعه کنید. توصیه می‌کنیم از کلیدهای جداگانه برای توسعه و تولید استفاده کنید و فقط localhost را در کلید سایت توسعه خود مجاز بدانید.

فقط در iOS 10، وقتی کاربر چالش را تمام می‌کند، صفحه به پایین اسکرول می‌شود؟

این یک اشکال تمرکز از طرف اپل است که ما به آنها گزارش داده‌ایم. این مشکل فقط کاربران iOS 10 و فقط در برخی سایت‌ها را تحت تأثیر قرار می‌دهد. اگر شما تحت تأثیر قرار گرفته‌اید، راه حل این است که ویجت reCAPTCHA را در صفحه بالاتر یا پایین‌تر ببرید، یا از reCAPTCHA نسخه ۳ استفاده کنید.

آیا ممکن است کامپیوتر یا شبکه من درخواست‌های خودکار ارسال کند؟

اگر از طریق ویجت reCAPTCHA به این صفحه هدایت شده بودید، پیامی با این مضمون می‌دیدید: «متاسفیم، اما ممکن است رایانه یا شبکه شما در حال ارسال درخواست‌های خودکار باشد. برای محافظت از کاربرانمان، در حال حاضر نمی‌توانیم درخواست شما را پردازش کنیم.»

متأسفانه این اتفاق می‌تواند برای کاربران خوب به چند دلیل رخ دهد:

• ممکن است شما در یک شبکه مشترک باشید که به طور نادرست مورد استفاده قرار می‌گیرد
• ممکن است ارائه دهنده خدمات اینترنتی شما اخیراً یک آدرس IP مشکوک به شما اختصاص داده باشد
• ممکن است سایتی که می‌خواهید به آن دسترسی پیدا کنید، در حال حاضر تحت حمله شدید باشد.

برای عیب‌یابی این مشکلات، لطفاً به صفحه راهنمای ترافیک غیرمعمول مراجعه کنید، یا بعداً دوباره امتحان کنید.

چه نام‌های اکشنی معتبر هستند؟

عملیات‌ها فقط می‌توانند شامل کاراکترهای الفبایی-عددی، اسلش و زیرخط باشند. عملیات‌ها نباید مختص کاربر خاصی باشند.