README.md

Easily add OAuth2 access to your projects

This OAuth for Laravel package provides a simple and reusable integration for implementing OAuth authentication in Laravel projects. The main goal is to allow developers to extend and customize their application's authentication system without needing to modify their existing user models.

The package is designed to work flexibly with any user model that implements the Authenticatable interface, ensuring that it can be easily adapted to various projects without direct dependencies on a specific user model.

Installation

You can install the package via composer:

composer require raiolanetworks/oauth

The next step is to configure the package using this command:

php artisan oauth:install

When this command is executed, the user will be guided through a series of steps to properly configure the necessary variables in both the configuration file and the environment file.

Steps in the installation process:

Setting variables in the configuration file

• Authenticatable model name: Here you need to enter the name of the user management model used in the project, which must implement the Authenticatable interface.

• Main guard name: You should specify the name of the guard that handles the login process in the project.

• Login route: You need to provide the route defined in the project where the login process takes place.

Creation of variables in the .env file

• OAuth base URL: Enter the base URL of the OAuth provider, which will be used for authorization and authentication requests.

• OAuth client ID: Provide the unique identifier of the OAuth client, issued by the OAuth authentication service being used.

• OAuth client secret key: Enter the secret key associated with the OAuth client, which is used to validate the authentication between the client and the OAuth server.

• OAuth admin group name: Specify the name of the user group with administrative privileges that will be managed within the OAuth system.

• OAuth mode: Select the mode of operation of the OAuth system, which will allow 3 modes: “OAUTH”, “PASSWORD” or “BOTH”.

Once all steps are completed, the migrations will be automatically executed and the configuration file will be published.

You can publish different files:

Migrations

php artisan vendor:publish --tag="oauth-migrations"

Config file

php artisan vendor:publish --tag="oauth-config"

Translations

php artisan vendor:publish --tag="oauth-translations"

Implementing the Package in the Project

Once you have installed the package in your project, the next step is to configure your own login flow. This can be done through a button, link, or any other interface element that triggers a function in a controller. In this function, you'll implement the package and call the request() function:

$authController = new OAuthController;
$authController->request();

1. Create a Controller to Handle OAuth Authentication

First, you'll need to create a controller that handles the OAuth authentication logic. You can use the OAuthController provided by the package or create your own controller. The main goal is to call the request() method from the package to start the OAuth authentication process.

Example Controller:

<?php

namespace App\Http\Controllers;

use Raiolanetworks\OAuth\OAuthController;

class AuthController extends Controller
{
    public function loginWithOAuth()
    {
        $authController = new OAuthController;
        return $authController->request();
    }
}

2. Set Up a Login Route

In your routes file (routes/web.php), define a route that points to the controller you just created. This route will trigger the OAuth authentication process when the user interacts with the login button or link.

use App\Http\Controllers\AuthController;

Route::get('/login/oauth', [AuthController::class, 'loginWithOAuth'])->name('login.oauth');

3. Create a Login Button or Link in the View

In your application's view (e.g., resources/views/auth/login.blade.php), add a button or link that points to the route you defined in the previous step. When the user clicks the button, the OAuth authentication process will begin.

<a href="{{ route('login.oauth') }}" class="btn btn-primary">
    Log in with OAuth
</a>

4. Authentication Process

When the user clicks the button or link, a request will be sent to the login() function of the AuthController. From there, the controller will call the request() method of the package's OAuthController, which handles the OAuth authentication flow by redirecting the user to the OAuth provider for authorization.

Once the user completes the authorization process, the OAuth provider will redirect back to your application, where you can handle the response and authenticate the user in your system.

This will complete the integration of the OAuth package into your project, allowing you to set up a login flow that triggers the OAuth authentication process with a button or link.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Martín Gómez
• Víctor Escribano

License

The MIT License (MIT). Please see License File for more information.