salvo-captcha/README.md
Awiteb 8b17b6d824
chore: Update README.md
Signed-off-by: Awiteb <a@4rs.nl>
2024-08-13 00:29:43 +03:00

3.6 KiB

salvo-captcha

A captcha middleware for salvo framework. With fully customizable captchas generator, storage, and finders

salvo-captcha-video

Add to your project

First, add the following to your Cargo.toml:

[dependencies]
salvo-captcha = "0.2"

Or use cargo add to add the dependency to your Cargo.toml:

$ cargo add salvo-captcha

Usage

See the examples directory for a complete example. You can also see the implemented generators, storages, and finders in the source code.

Storage

There is a default storage, which is MemoryStorage it's a simple in-memory storage. You can implement your own storage by implementing the CaptchaStorage trait.

Cacache Storage

A high-performance, concurrent, content-addressable disk cache. The storage is based on cacache-rs crate. to use it, you need to enable the cacache-storage feature.

[dependencies]
salvo-captcha = { version = "0.2", features = ["cacache-storage"] }

Captcha Finder

We provide fully customizable query parameters, form fields, and headers to find the captcha token and the captcha answer. You can implement your own finder by implementing the CaptchaFinder trait.

Captcha Generator

We provide SimpleCaptchaGenerator which is a simple captcha generator based on the captcha crate, you can enable it by enabling the simple-generator feature.

[dependencies]
salvo-captcha = { version = "0.2", features = ["simple-generator"] }

You can implement your own generator by implementing the CaptchaGenerator trait.

Captcha name and difficulty

In this table, you can see the difference between the difficulties and the name of the captcha.

Name Easy Medium Hard
Normal Simple Simple Simple
SlightlyTwisted Simple Simple Simple
VeryTwisted Simple Simple Simple

Mirrors

Main Repository

License

This project is licensed under the MIT license for more details see LICENSE or http://opensource.org/licenses/MIT.