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

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

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

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

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

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

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

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

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

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

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

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

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

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

اگر می‌خواهید بیش‌از ۱۰۰۰ تماس در ثانیه یا ۱٬۰۰۰٬۰۰۰ تماس در ماه برقرار کنید، باید از reCAPTCHA Enterprise استفاده کنید یا این فرم را تکمیل کنید و منتظر تأیید استثنا بمانید. اگر کلید سایتی از ۱۰۰۰ درخواست در ثانیه فراتر رود، ممکن است برخی‌از درخواست‌ها پردازش نشوند. اگر کلید سایت v3 از سهمیه ماهانه‌اش فراتر رود، ممکن است `site_verify` با برگرداندن امتیاز ثابت ۰٫۹ و پیام خطای `«فراتر از سهمیه رایگان»` برای باقی‌مانده ماه، باز شود. وقتی سایت‌های نسخه ۳ از سهمیه فراتر می‌روند، هیچ نشانه‌ای برای کاربر قابل‌مشاهده نیست. اگر کلید سایت نسخه ۲ از سهمیه ماهانه‌اش فراتر رود، ممکن است پیام زیر یا پیامی مشابه برای باقی‌مانده ماه در ابزاره reCAPTCHA به کاربران نمایش داده شود: `This site is exceeding reCAPTCHA quota.` (این سایت از سهمیه reCAPTCHA فراتر رفته است.) پیش‌از اعمال سهمیه، سه بار ازطریق ایمیل به مالکان سایت اطلاع داده می‌شود و حداقل ۹۰ روز به آن‌ها فرصت داده می‌شود تا به reCAPTCHA Enterprise مهاجرت کنند. اگر بیش‌از ۱٬۰۰۰٬۰۰۰ تماس در ماه برای هر دامنه‌ای استفاده شود، کلیدهای سایت فراتر از سهمیه درنظر گرفته می‌شوند. این شامل مواردی می‌شود که این حجم در چندین کلید در یک دامنه پخش شده باشد.

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

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

This site is protected by reCAPTCHA.

برای مثال:

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

.grecaptcha-badge { visibility: hidden; }

می‌خواهم آزمایش‌های خودکار با reCAPTCHA اجرا کنم. چه کاری باید انجام دهم؟

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

برای reCAPTCHA نسخه ۲، از کلیدهای آزمایشی زیر استفاده کنید. همیشه «بدون CAPTCHA» دریافت خواهید کرد و همه درخواست‌های درستی‌سنجی تأیید خواهند شد.

• کلید سایت: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
• کلید محرمانه: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

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

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

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

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

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 نسخه ۳ را سفارشی‌سازی کنم؟

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

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

اخیراً ابزاره reCAPTCHA من «کلید سایت نامعتبر» را نمایش می‌دهد. چه اتفاقی افتاده؟

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

من یک SecurityError دریافت می‌کنم: یک قاب با مبدأ «https://www.google.com» از دسترسی به یک قاب با مبدأ «<دامنه شما>» مسدود شده است. چه باید بکنم؟

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

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

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

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

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

• script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
• frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/
• connect-src https://www.google.com/recaptcha/

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

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

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

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

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

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

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

• ممکن است در شبکه مشترکی باشید که از آن سوءاستفاده می‌شود
• رساننده خدمات اینترنتی شما ممکن است اخیراً نشانی IP مشکوکی به شما اختصاص داده باشد
• سایتی که می‌خواهید به آن دسترسی پیدا کنید ممکن است درحال‌حاضر تحت حمله سنگینی باشد

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

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

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