83 lines
2.7 KiB
Markdown
83 lines
2.7 KiB
Markdown
<div align="center">
|
|
<h1>libmcaptcha</h1>
|
|
<p>
|
|
<strong>mCaptcha - PoW based DoS protection</strong>
|
|
</p>
|
|
|
|
[](https://mcaptcha.github.io/libmcaptcha/libmcaptcha/index.html)
|
|
[](https://mcaptcha.org/docs/api/mcaptcha-system)
|
|
[](https://deps.rs/repo/github/mCaptcha/libmcaptcha)
|
|
[](http://www.gnu.org/licenses/agpl-3.0)
|
|
/badge.svg>)
|
|
<br />
|
|
[](https://codecov.io/gh/mCaptcha/libmcaptcha)
|
|
[](https://matrix.to/#/+mcaptcha:matrix.batsense.net)
|
|
|
|
</div>
|
|
|
|
mCaptcha uses SHA256 based proof-of-work(PoW) to rate limit users.
|
|
|
|
If someone wants to hammer your site, they will have to do more work to
|
|
send requests than your server will have to do to respond to their
|
|
request.
|
|
|
|
> **NOTE:** `0.1.x` is out, expect breaking changes as ergonomics and
|
|
> performance is improved. Checkout [changelog](./CHANGELOG.md) for
|
|
> changes and migration pointers. Breaking changes will be frequent
|
|
> through `0.1.x`.
|
|
|
|
## Why use mCaptcha?
|
|
|
|
- Free software, privacy focused
|
|
- Seamless UX - No more annoying captchas!
|
|
- IP address independent(sort of) - your users are behind a NAT? We got you covered!
|
|
- Automatic bot throttling
|
|
- Resistant to replay attacks - bye-bye captcha farms!
|
|
|
|
## Demo
|
|
|
|
### Demo servers are available at:
|
|
|
|
- https://demo.mcaptcha.org/
|
|
- https://demo2.mcaptcha.org/ (runs on a Raspberry Pi!)
|
|
|
|
> Core functionality is working but it's still very much
|
|
> work-in-progress.
|
|
|
|
Feel free to provide bogus information while signing up(project under
|
|
development, database frequently wiped).
|
|
|
|
### Self-hosted:
|
|
|
|
Please refer to [mCaptcha/mCaptcha](https://github.com/mCaptcha/mCaptcha) for
|
|
instructions.
|
|
|
|
## Documentation
|
|
|
|
- [master-branch](https://mcaptcha.github.io/mCaptcha/libmcaptcha/index.html)
|
|
- [All published versions](https://mcaptcha.org/docs/api/mcaptcha-system)
|
|
|
|
## Usage
|
|
|
|
mCaptcha is made up of three components:
|
|
|
|
#### 1. Front-end library
|
|
|
|
We have a WASM library now, Android and iOS libraries soon
|
|
|
|
#### 2. Back-end library
|
|
|
|
We have Rust library, other languages will have support soon
|
|
|
|
#### 3. Rate limiting service
|
|
|
|
Under development.
|
|
|
|
A paid, managed service will be made available soon but
|
|
I([@realaravinth](https://batsense.net)) encourage you guys to
|
|
self-host. Go decentralisation!
|
|
|
|
## Contributing
|
|
|
|
yes please!
|