Download the PHP package raid/guardian without Composer

Laravel Authentication Package

This package provides a unified authentication flow by acting as a wrapper around any authentication package. It introduces several new concepts:

• Authenticatable
• Guardians
• Authenticators
• Matchers
• Norms
• Sequences
• Drivers

Requirements

• PHP >= 8.2
• An installed authentication package (e.g., Laravel Sanctum, Laravel Passport, or any other compatible package)

This package acts as a wrapper and requires an existing authentication package to provide the underlying authentication mechanisms.

Installation

Install the package via Composer:

Configuration

Publish the configuration file with the following command:

Usage

Here is an example of using the package in a controller:

Key Components:

• The Guardian manages the authentication process and returns an Authenticator instance.
• The Authenticator relies on Matchers, runs Norms, and executes Sequences for successful authentication.

Core Components

Authenticatable

The Authenticatable class is responsible for locating a user and returning an Illuminate\Contracts\Auth\Authenticatable instance.

Example Implementation:

Requirements:

• Implement AuthenticatableInterface.
• Define the findForAuthentication method.

Guardian

The Guardian class orchestrates the Authenticatable and Authenticators during authentication.

Command to Generate:

Configuration Example:

Authenticator

Manages the core authentication logic.

Command to Generate:

Configuration Example:

Defining Authenticators

For more details on configuring authenticators, see the Configuration Section.

Matcher

Matches the user with given credentials.

Command to Generate:

Configuration Example:

Defining Matchers

For more details on configuring matchers, see the Configuration Section.

Norm

Defines rules to validate authentication.

Command to Generate:

Configuration Example:

Defining Norms

For more details on configuring norms, see the Configuration Section.

Sequence

Adds additional steps to the authentication process.

Command to Generate:

Configuration Example:

Defining Sequences

For more details on configuring matchers, see the Configuration Section.

Driver

Handles token generation for authenticated users depending on the authentication package.

Driver Types:

• PassportDriver
• JwtDriver
• SanctumDriver

Defining the Default Driver:

Update the configuration in config\guardian.php:

Creating a Custom Driver:

Configuration Example:

Error Handling

Manage errors using the errors() method:

Components Configuration

Key Properties for Configuration

Defining Authenticators

Authenticators manages the core authentication logic.

You can configure the authenticators for a Guardian in two ways:

1. Using a Property in the Guardian Class

Define the list of authenticators directly in your custom Guardian class:

2. Using the Configuration File

Define authenticators in the config/guardian.php file under guardian_authenticators:

Default Authenticator

To set a default authenticator for a Guardian:

• In the Guardian Class: Use the $defaultAuthenticator property.
• In the Configuration File: Use guardian_authenticators key.

If no default authenticator is specified, the Guardian will use the default authenticator configured in config/guardian.php under default_authenticator.

Defining Matchers

Matchers are used to locate the user based on credentials. You can define matchers in two ways:

1. Using a Property in the Authenticator Class

In your custom authenticator class, define the matchers property:

2. Using the Configuration File

You can also define matchers in the config/guardian.php file under authenticator_matchers:

Defining Norms

Norms validate the authentication process. Similar to matchers, norms can be defined in two ways:

1. Using a Property in the Authenticator Class

In your custom authenticator class, define the norms property:

2. Using the Configuration File

Define norms in the config/guardian.php file under authenticator_norms:

Defining Sequences

Sequences add extra steps to the authentication process. Like matchers and norms, they can be defined in two ways:

1. Using a Property in the Authenticator Class

In your custom authenticator class, define the sequences property:

2. Using the Configuration File

Define sequences in the config/guardian.php file under authenticator_sequences:

Summary

• Property in Authenticator Class: Encapsulation of matchers, norms, and sequences within the authenticator class.
• Configuration File: Centralized configuration for easier management across multiple authenticators.

This flexibility allows you to structure your application according to your needs.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT License. See the LICENSE file for details.

Credits

• Mohamed Khedr

Support Raid

Raid is an MIT-licensed open-source project developed with community contributions.