Download the PHP package keukenmagazijn/passport-authenticator without Composer

Laravel Passport Authenticator

Introduction

This package is a self-refreshing Laravel Passport authenticator. There are superclasses available with which you can make quick custom connectors for all your (micro)services and you will never have to worry about having to maintain, refresh or create your bearer tokens yourself.

IMPORTANT! This is for usage with password clients only: https://laravel.com/docs/5.8/passport#creating-a-password-grant-client.

How to install

• You can install the package by requiring the keukenmagazijn/passport-authenticator package, or run composer require keukenmagazijn/passport-authenticator in your project root directory.
• When your package is included, you should run php artisan migrate to create the external_oauth2_credentials table, which the package requires to maintain your tokens.

How to use the package.

The setup

The configuration

The first recommended step is to create a config file for your passport, you don't have to but it's the clean thing to do. So let's say we have this config file available: config/external_application.php

Extending the Library superclasses

This library offers two superclasses, these need to be extended and available in order for the library to do its work properly.

The Authenticator

The Keukenmagazijn\PassportAuthenticator\Abstracts\ConcretePassportAuthenticator code handles all the magic for your credentials. Let's make our own custom authenticator.

app/Components/PassportAuthenticators/Instances/ExampleAuthenticator.php:

Now we need to create a factory as the ConcretePassportAuthenticator depends on this to create a configured authenticator.

The Factory

• Keukenmagazijn\PassportAuthenticator\Factories\ConcretePassportAuthenticatorFactory\ This is the "superfactory" that we need to make an extension to. It contains a method which configures our Authenticator - which we will make after the factory - easily for us:

This is what the method looks like:

So, knowing the method we need to use, let's create our first custom authenticator:

Components\PassportAuthenticators\Factories\ExampleFactory.php:

A production use-case example

So now the set-up is done, you might wonder how you can actually use the package, so I'll show you an example of it!

It's really simple, all you have to do it instantiate the authenticator and use the get/post methods available in the superclasses of this library:

This code will be all you need after the initial set-up!