codybuell/laravault-auth

Package for authenticating Laravel against Hashicorp's Vault.

Laravault-Auth

Laravel package for using Hashicorp's Vault as an Authentication Provider. Authenticates users against an instance of Vault, stores user information in the session, and handles closing of the laravel session when the vault ttl expires. Built and tested with Laravel 5.4., _(*1)

Installation

1. Install the LaravaultAuth package manually or with composer:

• Composer, _(*2)

  composer require codybuell/laravault-auth, _(*3)

• Manually, _(*4)

  ``` git clone https://github.com/codybuell/laravault-auth.git vendor/codybuell/laravault-auth, <sub>(*5)</sub>

  # edit composer.json, under autoload -> psr-4 append:, <sub>(*6)</sub>

  "CodyBuell\LaravaultAuth\": "vendor/codybuell/laravault-auth/src" ```, <sub>(*7)</sub>

1. Add provider to config/app.php providers array:, <sub>(*8)</sub>

   CodyBuell\LaravaultAuth\LaravaultAuthServiceProvider::class,

2. Publish config and configure config/laravault-auth.php:, <sub>(*9)</sub>

   php artisan vendor:publish

3. Set 'vault' as your auth provider in config/auth.php:, <sub>(*10)</sub>

   'providers' => [
       'users' => [
           'driver' => 'vault',
       ],
   ]

4. Set auth to use username rather than email. In app/Http/Controllers/Auth/LoginController.php add:, <sub>(*11)</sub>

   /**
    * Use usernames instead of emails.
    */
   public function username() {
     return 'username';
   }

Usage

Accessing Vault Client Token

Accessing User Attributes

Todo

• write tests
• add option to not tie laravel session length to vault ttl