<description><p>mCaptcha can protect your website from DDoS attacks. In this guide we&rsquo;ll
explore how to install mCaptcha on your website. The end result will be
something like this, on your website:</p>
<figure>
<img class="img-fluid lazyload blur-up" data-sizes="auto" src="//localhost:1313/docs/webmasters/installing-captcha/mcaptcha-widget-installation-result_hu8539423057366315365.png" data-srcset="//localhost:1313/docs/webmasters/installing-captcha/mcaptcha-widget-installation-result_hu1419480717185241492.png 800w,//localhost:1313/docs/webmasters/installing-captcha/mcaptcha-widget-installation-result_hu18366116196027657266.png 700w,//localhost:1313/docs/webmasters/installing-captcha/mcaptcha-widget-installation-result_hu8883404866445004597.png 600w,//localhost:1313/docs/webmasters/installing-captcha/mcaptcha-widget-installation-result_hu1488805238489702261.png 500w" width="618" height="669" alt="A registration form with mCaptcha widget installed">
<noscript><img class="img-fluid" sizes="100vw" srcset="//localhost:1313/docs/webmasters/installing-captcha/mcaptcha-widget-installation-result_hu1419480717185241492.png 800w,//localhost:1313/docs/webmasters/installing-captcha/mcaptcha-widget-installation-result_hu18366116196027657266.png 700w,//localhost:1313/docs/webmasters/installing-captcha/mcaptcha-widget-installation-result_hu8883404866445004597.png 600w,//localhost:1313/docs/webmasters/installing-captcha/mcaptcha-widget-installation-result_hu1488805238489702261.png 500w" src="//localhost:1313/docs/webmasters/installing-captcha/mcaptcha-widget-installation-result.png" width="618" height="669" alt="A registration form with mCaptcha widget installed"></noscript>
</figure>
<p>For the purpose of this demo, we will be using
<a href="https://demo.mcaptcha.org">demo.mcaptcha.org</a>, a demo instance running
in @realaravinth&rsquo;s bedroom(for this same reason, it shouldn&rsquo;t be used
for anything serious)</p></description>
<description><p>mCaptcha is highly responsive to detecting DDoS attacks. Admins are
advised to take advantage of it by setting low <a href="//localhost:1313/docs/terminology/difficulty-factor/">difficulty
factors</a> for normal traffic levels
for their website.</p>
<p><strong>Lowest advisable difficulty factor is 5000.</strong></p>
<p>For instance, if it is normal for my website to get 2000 requests for
every 30 seconds, I will set a <a href="//localhost:1313/docs/terminology/cooldown-period">cool
down</a> period of 30 seconds and the
first level of difficulty configuration will have a <a href="//localhost:1313/docs/terminology/visitor-threshold">visitor threshold</a> of 2000 with a
difficulty factor of 5000.</p></description>
<description><h2 id="authorization-token">Authorization token</h2>
<p>When a visitor solves the CAPTCHA and sends their solution to an
mCaptcha instance, the solution will be verified for correctness. If the
solution is correct, mCaptcha will return a single use authorization token.</p>
<p>This authorization token should be attached to the visitor&rsquo;s requited to the
protected service and the protected service should validity of the
authorization token with the mCaptcha instance and only allow authorization to
protected resource if the authorization token is valid.</p></description>
<description><h3 id="easy-mode-default-cooldown-period">Easy Mode: Default cooldown period</h3>
<p>When configuring mCaptcha in <a href="//localhost:1313/docs/webmasters/configuring-difficulty-factor/#easy-option">easy mode</a>, the default cooldown period is set to 30 seconds.</p>
<h2 id="how-to-get-site-key-from-dashboard">How to get site key from dashboard?</h2>
<ol>
<li>Go to &ldquo;Site keys&rdquo; on the side panel in the dashboard</li>
</ol>
<div align=center>
<figure>
<img class="img-fluid lazyload blur-up" data-sizes="auto" src="//localhost:1313/docs/webmasters/faq/sitekey-in-dashboard-sidepanel_hu1842978153838973955.png" data-srcset="//localhost:1313/docs/webmasters/faq/sitekey-in-dashboard-sidepanel_hu7616676515296954887.png 800w,//localhost:1313/docs/webmasters/faq/sitekey-in-dashboard-sidepanel_hu2820398381730295401.png 700w,//localhost:1313/docs/webmasters/faq/sitekey-in-dashboard-sidepanel_hu14296824487641448064.png 600w,//localhost:1313/docs/webmasters/faq/sitekey-in-dashboard-sidepanel_hu13642425771348413616.png 500w" width="222" height="496" alt="Site key menu option on the dashboard, encircled in red.">
<noscript><img class="img-fluid" sizes="100vw" srcset="//localhost:1313/docs/webmasters/faq/sitekey-in-dashboard-sidepanel_hu7616676515296954887.png 800w,//localhost:1313/docs/webmasters/faq/sitekey-in-dashboard-sidepanel_hu2820398381730295401.png 700w,//localhost:1313/docs/webmasters/faq/sitekey-in-dashboard-sidepanel_hu14296824487641448064.png 600w,//localhost:1313/docs/webmasters/faq/sitekey-in-dashboard-sidepanel_hu13642425771348413616.png 500w" src="//localhost:1313/docs/webmasters/faq/sitekey-in-dashboard-sidepanel.png" width="222" height="496" alt="Site key menu option on the dashboard, encircled in red."></noscript>
</figure>
</div>
<ol start="2">
<li>click on the clipboard button to copy the site key to your
clipboard.</li>
</ol>
<figure>
<img class="img-fluid lazyload blur-up" data-sizes="auto" src="//localhost:1313/docs/webmasters/faq/copy-sitekey_hu10670341732240698368.png" data-srcset="//localhost:1313/docs/webmasters/faq/copy-sitekey_hu12574324563529048918.png 900w,//localhost:1313/docs/webmasters/faq/copy-sitekey_hu10402720001579260311.png 800w,//localhost:1313/docs/webmasters/faq/copy-sitekey_hu3452963981457815043.png 700w,//localhost:1313/docs/webmasters/faq/copy-sitekey_hu12392874392811771870.png 600w,//localhost:1313/docs/webmasters/faq/copy-sitekey_hu2183952705797892621.png 500w" width="1825" height="831" alt="Copy site key to clipboard. Clipboard button is highlighted in the photo">
<noscript><img class="img-fluid" sizes="100vw" srcset="//localhost:1313/docs/webmasters/faq/copy-sitekey_hu12574324563529048918.png 900w,//localhost:1313/docs/webmasters/faq/copy-sitekey_hu10402720001579260311.png 800w,//localhost:1313/docs/webmasters/faq/copy-sitekey_hu3452963981457815043.png 700w,//localhost:1313/docs/webmasters/faq/copy-sitekey_hu12392874392811771870.png 600w,//localhost:1313/docs/webmasters/faq/copy-sitekey_hu2183952705797892621.png 500w" src="//localhost:1313/docs/webmasters/faq/copy-sitekey.png" width="1825" height="831" alt="Copy site key to clipboard. Clipboard button is highlighted in the photo"></noscript>
</figure></description>
