A robust Firebase Authentication API driver for Laravel and Firevel.
Laravel Firebase Authentication provides a sophisticated firebase guard for user authentication via the Firebase Authentication JWT token. This allows you to securely authenticate users in your Laravel or Firevel applications, leveraging the power of Firebase Authentication.
Follow these steps to get started with Laravel Firebase Authentication.
Begin by installing the package using composer with the command:
composer require firevel/firebase-authentication
- Update
config/auth.php: Specify Firebase as the authentication driver for your application.
'guards' => [
'web' => [
'driver' => 'firebase',
'provider' => 'users',
],
'api' => [
'driver' => 'firebase',
'provider' => 'users',
],
],
- Set Firebase project name: Configure your firebase project by adding
GOOGLE_CLOUD_PROJECTto your environment variables or set thefirebase.project_idconfig variable. - Update your
Usermodel: IntegrateFirevel\FirebaseAuthentication\FirebaseAuthenticabletrait, set$incrementing = falseand define$fillable.
Below are examples of how to update your User model for Eloquent and Firequent:
Eloquent
<?php
namespace App;
use Firevel\FirebaseAuthentication\FirebaseAuthenticable;
use Illuminate\Contracts\Auth\MustVerifyEmail;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
class User extends Authenticatable
{
use Notifiable, FirebaseAuthenticable;
/**
* Indicates if the IDs are auto-incrementing.
*
* @var bool
*/
public $incrementing = false;
/**
* The attributes that are mass assignable.
*
* @var array
*/
protected $fillable = [
'name', 'email', 'picture'
];
}
Firequent
<?php
namespace App;
use Firevel\FirebaseAuthentication\FirebaseAuthenticable;
use Firevel\Firequent\Model;
use Illuminate\Contracts\Auth\Authenticatable;
use Illuminate\Notifications\Notifiable;
class User extends Model implements Authenticatable
{
use Notifiable, FirebaseAuthenticable;
/**
* Indicates if the IDs are auto-incrementing.
*
* @var bool
*/
public $incrementing = false;
/**
* The attributes that are mass assignable.
*
* @var array
*/
protected $fillable = [
'name', 'email', 'picture'
];
}
- Update Migration for users table: If you're using Eloquent, you'll need to manually create or update the migration for the users table.
$table->string('id');
$table->string('name');
$table->string('email')->unique();
$table->string('picture');
$table->timestamps();
To avoid sharing users database credentials between micro-services, the recommended configuration differs slightly:
- Update
config/auth.php: Specify Firebase as the authentication driver for the 'api' guard.
'guards' => [
...
'api' => [
'driver' => 'firebase',
'provider' => 'users',
],
],
- Update User Provider: In the
config/auth.phpfile, define the user provider to use theFirevel\FirebaseAuthentication\FirebaseIdentitymodel.
'providers' => [
...
'users' => [
'driver' => 'eloquent',
'model' => Firevel\FirebaseAuthentication\FirebaseIdentity::class,
],
],
To utilize firebase authentication within your web routes, it is necessary to attach the bearer token to each HTTP request.
The bearer token can be stored in the bearer_token cookie variable. To do this, add the following to your Kernel.php:
protected $middlewareGroups = [
'web' => [
...
\Firevel\FirebaseAuthentication\Http\Middleware\AddAccessTokenFromCookie::class,
...
],
...
];
If the EncryptCookies middleware is in use, the following settings must be applied:
protected $except = [
...
'bearer_token',
...
];
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent