upbond / laravel-auth
Laravel plugin that helps authenticate with the upbond auth service
Installs: 6 615
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 5
Forks: 0
Open Issues: 0
Requires
- php: ^7.3 | ^8.0
- illuminate/contracts: 5.* | ^6.0 | ^7.0 | ^8.0
- illuminate/support: 5.* | ^6.0 | ^7.0 | ^8.0
- upbond/auth-php: 2.0
Requires (Dev)
- dealerdirect/phpcodesniffer-composer-installer: ^0.5.0
- orchestra/testbench: ^3.8|^4.0|^5.0
- phpcompatibility/php-compatibility: ^8.1
- phpunit/phpunit: ^7|^8|^9
- squizlabs/php_codesniffer: ^3.2
README
This package is inspired by Auth0
Documentation
Please see the Laravel webapp quickstart for a complete guide on how to install this in an existing project or to download a pre-configured sample project. Additional documentation on specific scenarios is below.
Setting up
$this->app->bind(
\Upbond\Auth\Login\Contract\AuthUserRepository::class,
\Upbond\Auth\Login\Repository\AuthUserRepository::class
);
Setting up a JWKs cache
In the register
method of your AppServiceProvider
add:
// app/Providers/AppServiceProvider.php use Illuminate\Support\Facades\Cache; // ... public function register() { // ... $this->app->bind( '\Auth\SDK\Helpers\Cache\CacheHandler', function() { static $cacheWrapper = null; if ($cacheWrapper === null) { $cache = Cache::store(); $cacheWrapper = new LaravelCacheWrapper($cache); } return $cacheWrapper; }); }
Setting up for lumen
$app->register(Upbond\Auth\Login\LoginServiceProvider::class);
Update .env for your env default to api.upbond.io
UPBOND_API_URI=api.dev.upbond.io
You can implement your own cache strategy by creating a new class that implements the Auth\SDK\Helpers\Cache\CacheHandler
contract, or just use the cache strategy you want by picking that store with Cache::store('your_store_name')
;
Storing users in your database
You can customize the way you handle the users in your application by creating your own UserRepository
. This class should implement the Auth\Login\Contract\AuthUserRepository
contract. Please see the Custom User Handling section of the Laravel Quickstart for the latest example.
Using auth guard
To protect APIs using an access token generated by Auth, there is an upbond
API guard provided (Laravel documentation on guards). To use this guard, add it to config/auth.php
with the driver upbond
:
'providers' => [
'users' => [
'driver' => 'upbond',
],
],
Once that has been added, add the guard to the middleware of any API route and check authentication during the request:
// get user
auth('upbond')->user();
// check if logged in
auth('upbond')->check();
// protect routes via middleware use
Route::group(['middleware' => 'auth:upbond'], function () {});
Route::get( '/auth/callback', '\Upbond\Auth\Login\AuthController@callback' )->name( 'auth-callback' );
env file
UPBOND_API_URI
UPBOND_AUTH_DOMAIN
UPBOND_AUTH_CLIENT_ID
UPBOND_AUTH_CLIENT_SECRET
Installation
Install this plugin into a new or existing project using Composer:
$ composer require upbond/laravel-auth
Additional steps to install can be found in the quickstart.
Contributing
We appreciate feedback and contribution to this repo! Before you get started, please see the following:
Support + Feedback
Include information on how to get support. Consider adding:
What is Auth?
Auth helps you to easily:
- implement authentication with multiple identity providers, including social (e.g., Google, Facebook, Microsoft, LinkedIn, GitHub, Twitter, etc), or enterprise (e.g., Windows Azure AD, Google Apps, Active Directory, ADFS, SAML, etc.)
- log in users with username/password databases, passwordless, or multi-factor authentication
- link multiple user accounts together
- generate signed JSON Web Tokens to authorize your API calls and flow the user identity securely
- access demographics and analytics detailing how, when, and where users are logging in
- enrich user profiles from other data sources using customizable JavaScript rules
License
The Auth Laravel Login plugin is licensed under MIT - LICENSE