forked from mCaptcha/website
267 lines
13 KiB
HTML
267 lines
13 KiB
HTML
|
<!doctype html>
|
||
|
|
<html lang="en-US">
|
||
|
|
<head>
|
||
|
|
<meta charset="utf-8">
|
||
|
|
<meta http-equiv="x-ua-compatible" content="ie=edge">
|
||
|
|
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
|
||
|
|
<link rel="preload" as="font" href="/fonts/vendor/jost/jost-v4-latin-regular.woff2" type="font/woff2" crossorigin>
|
||
|
|
<link rel="preload" as="font" href="/fonts/vendor/jost/jost-v4-latin-700.woff2" type="font/woff2" crossorigin>
|
||
|
|
<link rel="stylesheet" href="/main.4492eacff4110697cd6162326bce4ee59e92315bf9acc357594066968669326dc80b75b1a39e6cea81c4f8898bd1d294fcc657a9cb61baed14c7dee6f9e2b2d6.css" integrity="sha512-RJLqz/QRBpfNYWIya85O5Z6SMVv5rMNXWUBmloZpMm3IC3Wxo55s6oHE+ImL0dKU/MZXqcthuu0Ux97m+eKy1g==" crossorigin="anonymous">
|
||
|
|
<noscript><style>img.lazyload { display: none; }</style></noscript>
|
||
|
|
<meta name="robots" content="index, follow">
|
||
|
|
<meta name="googlebot" content="index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1">
|
||
|
|
<meta name="bingbot" content="index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1">
|
||
|
|
<title>Visitor Threshold - mCaptcha</title>
|
||
|
|
<meta name="description" content="Visitor threshold is used to split traffic into levels. If the traffic level supersceedes the configured threshold, then mCaptcha will increase difficulty factor based on the configuration provided.">
|
||
|
|
<link rel="canonical" href="/docs/terminology/visitor-threshold/">
|
||
|
|
<meta name="twitter:card" content="summary_large_image">
|
||
|
|
<meta name="twitter:image" content="/icon.png">
|
||
|
|
<meta name="twitter:title" content="Visitor Threshold">
|
||
|
|
<meta name="twitter:description" content="Visitor threshold is used to split traffic into levels. If the traffic level supersceedes the configured threshold, then mCaptcha will increase difficulty factor based on the configuration provided.">
|
||
|
|
|
||
|
|
<meta name="twitter:site" content="@">
|
||
|
|
<meta name="twitter:creator" content="@">
|
||
|
|
|
||
|
|
<meta property="og:title" content="Visitor Threshold">
|
||
|
|
<meta property="og:description" content="Visitor threshold is used to split traffic into levels. If the traffic level supersceedes the configured threshold, then mCaptcha will increase difficulty factor based on the configuration provided.">
|
||
|
|
<meta property="og:type" content="article">
|
||
|
|
<meta property="og:url" content="/docs/terminology/visitor-threshold/">
|
||
|
|
|
||
|
|
<meta property="og:image" content="/icon.png"/>
|
||
|
|
<meta property="article:published_time" content="2022-07-22T00:00:00+00:00">
|
||
|
|
<meta property="article:modified_time" content="2023-02-13T16:50:36+05:30">
|
||
|
|
<meta property="og:site_name" content="mCaptcha">
|
||
|
|
|
||
|
|
<meta property="article:publisher" content="https://www.facebook.com/">
|
||
|
|
<meta property="article:author" content="https://www.facebook.com/">
|
||
|
|
<meta property="og:locale" content="en_US">
|
||
|
|
|
||
|
|
<script type="application/ld+json">
|
||
|
|
{
|
||
|
|
"@context": "http://schema.org",
|
||
|
|
"@type": "BreadcrumbList",
|
||
|
|
"itemListElement": [{
|
||
|
|
"@type": "ListItem",
|
||
|
|
"position": 1 ,
|
||
|
|
"name": "Home",
|
||
|
|
"item": "\/"
|
||
|
|
},{
|
||
|
|
"@type": "ListItem",
|
||
|
|
"position": 2 ,
|
||
|
|
"name": "Docsterminologyvisitor Threshold",
|
||
|
|
"item": "\/docsterminologyvisitor-threshold\/"
|
||
|
|
}]
|
||
|
|
}
|
||
|
|
</script>
|
||
|
|
|
||
|
|
<meta name="theme-color" content="#fff">
|
||
|
|
<link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
|
||
|
|
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
|
||
|
|
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
|
||
|
|
<link rel="manifest" href="/site.webmanifest">
|
||
|
|
|
||
|
|
</head>
|
||
|
|
<body class="docs single">
|
||
|
|
|
||
|
|
|
||
|
|
<div class="header-bar fixed-top"></div>
|
||
|
|
<header class="navbar fixed-top navbar-expand-md navbar-light">
|
||
|
|
<div class="container">
|
||
|
|
<input class="menu-btn order-0" type="checkbox" id="menu-btn">
|
||
|
|
<label class="menu-icon d-md-none" for="menu-btn"><span class="navicon"></span></label>
|
||
|
|
<a class="navbar-brand order-1 order-md-0 me-auto" href="/">mCaptcha</a>
|
||
|
|
<button id="mode" class="btn btn-link order-2 order-md-4" type="button" aria-label="Toggle mode">
|
||
|
|
<span class="toggle-dark"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-moon"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"></path></svg></span>
|
||
|
|
<span class="toggle-light"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-sun"><circle cx="12" cy="12" r="5"></circle><line x1="12" y1="1" x2="12" y2="3"></line><line x1="12" y1="21" x2="12" y2="23"></line><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line><line x1="1" y1="12" x2="3" y2="12"></line><line x1="21" y1="12" x2="23" y2="12"></line><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line><line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line></svg></span>
|
||
|
|
</button>
|
||
|
|
<ul class="navbar-nav social-nav order-3 order-md-5">
|
||
|
|
<li class="nav-item">
|
||
|
|
<a class="nav-link" href="https://github.com/mCaptcha"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-github"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 0 0-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0 0 20 4.77 5.07 5.07 0 0 0 19.91 1S18.73.65 16 2.48a13.38 13.38 0 0 0-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 0 0 5 4.77a5.44 5.44 0 0 0-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 0 0 9 18.13V22"></path></svg><span class="ms-2 visually-hidden">GitHub</span></a>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<div class="collapse navbar-collapse order-4 order-md-1">
|
||
|
|
<ul class="navbar-nav main-nav me-auto order-5 order-md-2"><li class="nav-item">
|
||
|
|
<a class="nav-link" href="/blog/">Blog</a>
|
||
|
|
</li>
|
||
|
|
<li class="nav-item">
|
||
|
|
<a class="nav-link" href="/community/">Community</a>
|
||
|
|
</li>
|
||
|
|
<li class="nav-item">
|
||
|
|
<a class="nav-link" href="/contact/">Contact</a>
|
||
|
|
</li>
|
||
|
|
<li class="nav-item">
|
||
|
|
<a class="nav-link" href="/about/">About</a>
|
||
|
|
</li>
|
||
|
|
<li class="nav-item active">
|
||
|
|
<a class="nav-link" href="/docs/introduction/installing-captcha/">Docs</a>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<div class="break order-6 d-md-none"></div>
|
||
|
|
<form class="navbar-form flex-grow-1 order-7 order-md-3">
|
||
|
|
<input id="userinput" class="form-control is-search" type="search" placeholder="Search docs..." aria-label="Search docs..." autocomplete="off">
|
||
|
|
<div id="suggestions" class="shadow bg-white rounded"></div>
|
||
|
|
</form>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</header>
|
||
|
|
|
||
|
|
<div class="wrap container" role="document">
|
||
|
|
<div class="content">
|
||
|
|
|
||
|
|
<div class="row flex-xl-nowrap">
|
||
|
|
<div class="col-lg-5 col-xl-4 docs-sidebar">
|
||
|
|
<nav class="docs-links" aria-label="Main navigation">
|
||
|
|
<h3>Introduction</h3>
|
||
|
|
<ul class="list-unstyled">
|
||
|
|
<li><a class="docs-link" href="/docs/introduction/installing-captcha/">Installing mCaptcha on your website</a></li>
|
||
|
|
<li><a class="docs-link" href="/docs/introduction/configuring-difficulty-factor/">Configuring Difficulty Factor</a></li>
|
||
|
|
</ul>
|
||
|
|
<h3>Terminology</h3>
|
||
|
|
<ul class="list-unstyled">
|
||
|
|
<li><a class="docs-link" href="/docs/terminology/access-token/">Access token</a></li>
|
||
|
|
<li><a class="docs-link" href="/docs/terminology/cooldown-period/">Cooldown Period</a></li>
|
||
|
|
<li><a class="docs-link" href="/docs/terminology/difficulty-factor/">Difficulty Factor</a></li>
|
||
|
|
<li><a class="docs-link" href="/docs/terminology/sitekey/">Site key</a></li>
|
||
|
|
<li><a class="docs-link active" href="/docs/terminology/visitor-threshold/">Visitor Threshold</a></li>
|
||
|
|
</ul>
|
||
|
|
<h3>Self-Hosted</h3>
|
||
|
|
<ul class="list-unstyled">
|
||
|
|
<li><a class="docs-link" href="/docs/self-hosted/getting-started/">Getting started</a></li>
|
||
|
|
<li><a class="docs-link" href="/docs/self-hosted/bare-metal/">Deploy bare metal</a></li>
|
||
|
|
<li><a class="docs-link" href="/docs/self-hosted/docker/">Using Docker</a></li>
|
||
|
|
<li><a class="docs-link" href="/docs/self-hosted/dependencies/">Database and cache</a></li>
|
||
|
|
</ul>
|
||
|
|
<h3>API</h3>
|
||
|
|
<ul class="list-unstyled">
|
||
|
|
<li><a class="docs-link" href="/docs/api/browser/">Browser libraries</a></li>
|
||
|
|
<li><a class="docs-link" href="/docs/api/mcaptcha-system/">mCaptcha System Library</a></li>
|
||
|
|
<li><a class="docs-link" href="/docs/api/pow-sha256/">pow_sha256</a></li>
|
||
|
|
</ul>
|
||
|
|
<h3>Help</h3>
|
||
|
|
<ul class="list-unstyled">
|
||
|
|
<li><a class="docs-link" href="/docs/help/troubleshooting/">Troubleshooting</a></li>
|
||
|
|
<li><a class="docs-link" href="/docs/help/faq/">FAQ</a></li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
</nav>
|
||
|
|
</div>
|
||
|
|
<nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation">
|
||
|
|
<div class="page-links">
|
||
|
|
<h3>On this page</h3>
|
||
|
|
<nav id="TableOfContents"></nav>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
</nav>
|
||
|
|
<main class="docs-content col-lg-11 col-xl-9">
|
||
|
|
|
||
|
|
<h1>Visitor Threshold</h1>
|
||
|
|
<p class="lead"></p>
|
||
|
|
<p>mCaptcha’s variable difficulty factor mechanism requires a website’s traffic
|
||
|
|
statistics be split into levels, so that it can deploy the right
|
||
|
|
difficulty factor for each level.</p>
|
||
|
|
<p>Visitor threshold is used to traffic into levels and mCaptcha accepts a
|
||
|
|
difficulty configuration for each of these levels. When current traffic
|
||
|
|
exceeds a difficulty factor, mCaptcha will increase the difficulty
|
||
|
|
factor to the next configured level.</p>
|
||
|
|
<p>For instance, consider the configuration given below:</p>
|
||
|
|
<ul>
|
||
|
|
<li>Cool down period: 30 seconds</li>
|
||
|
|
</ul>
|
||
|
|
<table>
|
||
|
|
<thead>
|
||
|
|
<tr>
|
||
|
|
<th>Level</th>
|
||
|
|
<th>Difficulty Factor</th>
|
||
|
|
<th>Visitor Threshold</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody>
|
||
|
|
<tr>
|
||
|
|
<td>1</td>
|
||
|
|
<td>5,000</td>
|
||
|
|
<td>2,000</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>2</td>
|
||
|
|
<td>50,000</td>
|
||
|
|
<td>5,000</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>3</td>
|
||
|
|
<td>500,000</td>
|
||
|
|
<td>10,000</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td>4</td>
|
||
|
|
<td>5,000,000</td>
|
||
|
|
<td>15,000</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
<p>If the website sees 2,000 requests in a 30 second window, level 1
|
||
|
|
difficulty factor(5,000) will be deployed. If the traffic increases to
|
||
|
|
5,000 requests in a 30 second window, then difficulty factor will be
|
||
|
|
upgraded to level 2(50,000). Likewise 10,000 and 15,000 requests over 30
|
||
|
|
seconds will result in difficulty factor being upgraded to 500,000 and
|
||
|
|
5,000,000 respectively.</p>
|
||
|
|
<p>Visitor threshold is how mCaptcha determines which difficulty factor
|
||
|
|
level to deploy. mCaptcha uses leaky bucket algorithm to keep the
|
||
|
|
visitor threshold constantly updated within the configured cool down
|
||
|
|
period. So, at any given moment the, the current visitor level will be
|
||
|
|
the amount of traffic that was served in the cool down period specified.</p>
|
||
|
|
|
||
|
|
<p class="edit-page"><a href="https://github.com/mCaptcha/website/blob/master/content/docs/terminology/visitor-threshold.md"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5L17 3z"></path></svg>Edit this page on GitHub</a></p>
|
||
|
|
|
||
|
|
<div class="docs-navigation d-flex justify-content-between">
|
||
|
|
|
||
|
|
<a href="/docs/terminology/sitekey/">
|
||
|
|
<div class="card my-1">
|
||
|
|
<div class="card-body py-2">
|
||
|
|
← Site key
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</a>
|
||
|
|
<a class="ms-auto" href="/docs/self-hosted/getting-started/">
|
||
|
|
<div class="card my-1">
|
||
|
|
<div class="card-body py-2">
|
||
|
|
Getting started →
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</a>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
</main>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
|
||
|
|
<footer class="footer text-muted">
|
||
|
|
<div class="container">
|
||
|
|
<div class="row">
|
||
|
|
<div class="col-lg-8 order-last order-lg-first">
|
||
|
|
<ul class="list-inline">
|
||
|
|
<li class="list-inline-item">Powered by <a href="https://gohugo.io/">Hugo</a>, and <a href="https://getdoks.org/">Doks</a></li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="col-lg-8 order-first order-lg-last text-lg-end">
|
||
|
|
<ul class="list-inline">
|
||
|
|
<li class="list-inline-item"><a href="/about/">About</a></li>
|
||
|
|
<li class="list-inline-item"><a href="/donate">Donate</a></li>
|
||
|
|
<li class="list-inline-item"><a href="/privacy-policy/">Privacy</a></li>
|
||
|
|
<li class="list-inline-item"><a href="/security">Security</a></li>
|
||
|
|
<li class="list-inline-item"><a href="https://stats.uptimerobot.com/GK7VLFJnBl">Status</a></li>
|
||
|
|
<li class="list-inline-item"><a href="/thanks">Thanks</a></li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</footer>
|
||
|
|
|
||
|
|
<script src="/main.min.fc14a6a9dceb7093b6984e33583a45c79e3c960959d75df6b62753b4d1c63a97d25af2b0ca924ed12675f1de34f3fce9ec81668f2d3bee114b9b6357dd2e92cd.js" integrity="sha512-/BSmqdzrcJO2mE4zWDpFx548lglZ1132tidTtNHGOpfSWvKwypJO0SZ18d408/zp7IFmjy077hFLm2NX3S6SzQ==" crossorigin="anonymous" defer></script>
|
||
|
|
<script src="/index.min.f24b6e33dac74771476dda67fe905af998983abef17f74f74d71228ac8f40f87af8b15bcd9f0da775c90a41395c3d153fb0067cc75ff642c520b3607340014c0.js" integrity="sha512-8ktuM9rHR3FHbdpn/pBa+ZiYOr7xf3T3TXEiisj0D4evixW82fDad1yQpBOVw9FT+wBnzHX/ZCxSCzYHNAAUwA==" crossorigin="anonymous" defer></script>
|
||
|
|
|
||
|
|
</body>
|
||
|
|
</html>
|