Skip to content

Keep bots and unwanted humans away from your website

License

Notifications You must be signed in to change notification settings

phrenotype/figleaf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FigLeaF

license contributors code size downloads

This library keeps bots and unwanted humans from making requests to your website.

It offers full csrf token generation and validation, without external dependencies.

With this, a brute force attack is only possible with browser automation, hence increased cost.

Install

composer require figleaf/figleaf

Usage

To generate a csrf token for some random use ( you decide )

<?php

use FigLeaf\FigLeaf;

$token = FigLeaf::token(true);

echo $token;
36ea3cb936ea66dbe4fc50444176a84c8138f76859467b86986efb53f1d6

To get the current or old token value use FigLeaf::token().

To generate a hidden input field

<?php

use FigLeaf\FigLeaf;

$input = FigLeaf::input(true);

echo $input;
<input type="hidden" name="__figleaf_token" value="36ea3cb936ea66dbe4fc50444176a84c8138f76859467b86986efb53f1d6"/>

Again, to get an input based on the old or current value, use FigLeaf::input().

You can then go on to add the input to your form or web request as the case may be.

Validation

After a form is submitted or a request is sent by a user, you validate it by passing an associative array based on the request medium

<?php

use FigLeaf\FigLeaf;

$validator = Figleaf::validate($_REQUEST);

if($validator->passed()){
    // Do something
}

if($validator->failed()){
    // Do something
}

Recommendation

It is highly recommeded you always generate new tokens per request, otherwise, this whole 'keeping bots and unwanted humans' away thing will just be an empty promise.

Contact

Email : paul.contrib@gmail.com