nigelgreenway/tutis

A framework agnostic authentication library

Tutis

Tutis is a wrapper for handling passwords. It is provided with a password handler that uses bcrypt and allows you to generate a hash, rehash and verify a password, all via a simple call to the Tutis\Pass object., _(*1)

Install

Via Composer, _(*2)

``` bash $ composer require NigelGreenway/Tutis, <sub>(*3)</sub>

## Usage

### Generate a pass for a user (using BasicPasswordHandler)

``` php
$username = 'bob.builder';

$password = '9455w0rd';
$options = [
    'cost' => 12,
];
$passwordHandler = Tutis\Handler\BasicPasswordHandler::hash($password, $options);

$pass = Tutis\Pass::generate($username, $passwordHandler, Tutis\Pass::ACTIVE);
echo $pass->toUsername() // bob.builder
echo $pass->toHash() // $0m3l0ngh4sh

Authenticate the password

``` php $username = 'bob.builder'; $password = '9455w0rd'; $hash = '$0m3l0ngh4sh';, <sub>(*4)</sub>

$pass = Tutis\Pass::authenticate( $username, $password, $hash, BasicPasswordHandler::class, 1 ), <sub>(*5)</sub>

var_dump($pass); // Instance of Tutis\Pass, <sub>(*6)</sub>

## Change log

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

## Testing

``` bash
$ composer test

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*7)</sub>

Security

If you discover any security related issues, please email github@futurepixels.co.uk instead of using the issue tracker., <sub>(*8)</sub>

Credits

• Nigel Greenway
• All Contributors

License

The Apache License (Apache). Please see License File for more information., <sub>(*9)</sub>