Laravel Auth – Custom authentication guards

In Laravel, authentication guards define how users are authenticated for each request. By default, Laravel ships with a web guard (for sessions and cookies) and an api guard (for token-based authentication). However, you can create custom authentication guards for specific authentication needs, such as using different user types (e.g., admins and regular users) or custom authentication logic.

 

Steps to Create a Custom Authentication Guard

1. Modify auth.php Configuration

The config/auth.php file contains the authentication guards and providers configuration. You’ll need to define a custom guard here.

Example: Create a custom admin guard for admin users.

In this configuration:

  • A new admin guard is defined with a session driver (same as web).
  • A new admins provider is defined, using the Admin model for authentication.

2. Create the Admin Model

You’ll need a model to represent the admins table. Create a model for Admin using Laravel’s Artisan command:

 

 

Then, define the Admin model (e.g., app/Models/Admin.php):

 

 

3. Create an Admin Login Controller

Next, create a controller for handling admin authentication. You can extend Laravel’s Auth functionality:

 

 

In AdminAuthController.php, add methods to handle login, logout, and authentication:

 

 

4. Routes for Admin Authentication

In your routes/web.php file, add routes to handle the admin login and logout:

 

 

5. Admin Dashboard Route (Middleware Protection)

Ensure that the admin dashboard is protected by the admin guard. You can do this by adding middleware to routes for admin areas:

 

 

6. Admin Login View

Create the resources/views/auth/admin-login.blade.php view for the admin login page:

 

 

7. Custom Guard Usage

Now, whenever you need to authenticate admin users, use the admin guard:

 

 

Summary of Steps:

  1. Define a Custom Guard: Modify config/auth.php to add a custom guard and provider.
  2. Create a Model: Set up a model like Admin to represent the users for that guard.
  3. Create a Controller: Handle login, logout, and authentication logic.
  4. Set Up Routes: Define routes for the login, logout, and admin dashboard.
  5. Create Login View: Build a form for admin login.
  6. Protect Admin Routes: Use middleware to protect routes.

 

Output:

The output of setting up custom authentication guards in Laravel involves a series of results visible at different stages of the process, such as when users attempt to authenticate, access protected routes, or perform certain actions.

1. Login Page (Admin Login Form)

When you navigate to the custom admin login route (e.g., /admin/login), you will see a login form that allows the admin to enter their email and password:

2. Successful Admin Login

When the admin successfully logs in by entering the correct email and password, they will be redirected to the admin dashboard (/admin/dashboard). The dashboard page could look like this:

3. Failed Admin Login

If the admin enters invalid credentials (wrong email or password), the system will display an error message and reload the login page:

4. Accessing Protected Routes (Dashboard) Without Authentication

If an admin tries to access the dashboard (/admin/dashboard) without being logged in, they will be redirected to the login page with an error message or redirection logic:

This happens because the dashboard route is protected by the auth:admin middleware, which requires authentication through the admin guard.

5. Successful Logout

After logging in as an admin, when the admin logs out (via /admin/logout), they will be logged out successfully and redirected to the login page or a designated logout page:

6. Checking Authentication in Code

In your code, when you check if the admin is authenticated using the custom admin guard:

The output will reflect whether an admin is logged in or not based on the session:

  • If logged in: "Admin is logged in!"
  • If not logged in: "No admin is logged in!"

7. Redirects and Middleware Output

When the auth:admin middleware is applied to the dashboard route, and an unauthenticated admin tries to access it, they will be redirected back to the login page (/admin/login) with appropriate redirection messages.


Summary of Outputs:

  1. Admin Login Page: Displays the custom login form.
  2. Successful Login: Redirects to the admin dashboard with a success message.
  3. Failed Login: Shows an error message on the login form.
  4. Accessing Protected Route Without Login: Redirects to the login page.
  5. Successful Logout: Logs out the admin and redirects to the login page.
  6. Code Checks: Outputs whether the admin is logged in or not.

 

  1. Laravel Breeze – Simple authentication starter kit
  2. Laravel Jetstream – Scaffolding for Laravel apps
  3. Laravel Passport – API authentication via OAuth2
  4. Laravel Sanctum – Simple API authentication
  5. Spatie Laravel Permission – Role and permission management
  6. Laravel Cashier – Subscription billing with Stripe
  7. Laravel Scout – Full-text search using Algolia
  8. Laravel Socialite – OAuth authentication (Google, Facebook, etc.)
  9. Laravel Excel – Excel import and export for Laravel
  10. Laravel Horizon – Redis queues monitoring
  11. Laravel Nova – Admin panel for Laravel
  12. Laravel Fortify – Backend authentication for Laravel
  13. Laravel Vapor – Serverless deployment on AWS
  14. Laravel Telescope – Debugging assistant for Laravel
  15. Laravel Dusk – Browser testing
  16. Laravel Mix – API for compiling assets
  17. Spatie Laravel Backup – Backup management
  18. Laravel Livewire – Building dynamic UIs
  19. Spatie Laravel Media Library – Manage media uploads
  20. Laravel Excel – Excel spreadsheet handling
  21. Laravel Debugbar – Debug tool for Laravel
  22. Laravel WebSockets – Real-time communication
  23. Spatie Laravel Sitemap – Generate sitemaps
  24. Laravel Spark – SaaS scaffolding
  25. Laravel Envoy – Task runner for deployment
  26. Spatie Laravel Translatable – Multilingual model support
  27. Laravel Backpack – Admin panel
  28. Laravel AdminLTE – Admin interface template
  29. Laravel Collective Forms & HTML – Simplified form and HTML generation
  30. Spatie Laravel Analytics – Google Analytics integration
  31. Laravel Eloquent Sluggable – Automatically create slugs
  32. Laravel Charts – Chart integration
  33. Laravel Auditing – Track changes in models
  34. Laravel JWT Auth – JSON Web Token authentication
  35. Laravel Queue Monitor – Monitor job queues
  36. Spatie Laravel Query Builder – Filter, sort, and include relationships in Eloquent queries
  37. Laravel Datatables – jQuery Datatables API
  38. Laravel Localization – Multilingual support for views and routes
  39. Laravel Acl Manager – Access control list manager
  40. Laravel Activity Log – Record activity in your app
  41. Laravel Roles – Role-based access control
  42. Spatie Laravel Tags – Tagging models
  43. Laravel Installer – CLI installer for Laravel
  44. Laravel Breadcrumbs – Generate breadcrumbs in Laravel
  45. Laravel Mailgun – Mailgun integration for Laravel
  46. Laravel Trustup Model History – Store model change history
  47. Laravel Deployer – Deployment automation tool
  48. Laravel Auth – Custom authentication guards
  49. Laravel CORS – Cross-Origin Resource Sharing (CORS) support
  50. Laravel Notifications – Send notifications through multiple channels
  51. Spatie Laravel Http Logger – Log HTTP requests
  52. Laravel Permission Manager – Manage permissions easily
  53. Laravel Stubs – Customize default stubs in Laravel
  54. Laravel Fast Excel – Speed up Excel exports
  55. Laravel Image – Image processing
  56. Spatie Laravel Backup Server – Centralize backups for Laravel apps
  57. Laravel Forge API – Manage servers through the Forge API
  58. Laravel Blade SVG – Use SVGs in Blade templates
  59. Laravel Ban – Ban/unban users from your application
  60. Laravel API Response – Standardize API responses
  61. Laravel SEO – Manage SEO meta tags
  62. Laravel Settings – Store and retrieve settings
  63. Laravel DOMPDF – Generate PDFs
  64. Laravel Turbo – Full-stack framework for building modern web apps
  65. Spatie Laravel Event Sourcing – Event sourcing implementation
  66. Laravel Jetstream Inertia – Jetstream’s Inertia.js integration
  67. Laravel Envoy Tasks – Task automation
  68. Laravel Likeable – Like/dislike functionality
  69. Laravel GeoIP – Determine visitor’s geographic location
  70. Laravel Country State City – Dropdowns for country, state, and city
  71. Laravel Hashids – Generate short unique hashes
  72. Laravel Repository – Repository pattern for Laravel
  73. Laravel UUID – UUID generation for models
  74. Spatie Laravel Medialibrary Pro – Enhanced media management
  75. Laravel Queue Monitor – Monitor Laravel job queues
  76. Laravel User Activity – Monitor user activity
  77. Laravel DB Snapshots – Create database snapshots
  78. Laravel Twilio – Twilio integration
  79. Laravel Roles – Role-based permission handling
  80. Laravel Translatable – Add translations to Eloquent models
  81. Laravel Teamwork – Manage teams in multi-tenant apps
  82. Laravel Full Text Search – Add full-text search to Laravel models
  83. Laravel File Manager – File and media management
  84. Laravel User Timezones – Automatically detect user time zones
  85. Laravel ChartsJS – Render charts with ChartsJS
  86. Laravel Stripe – Stripe API integration
  87. Laravel PDF Generator – PDF generation
  88. Laravel Elasticsearch – Elasticsearch integration
  89. Laravel Simple Qrcode – Generate QR codes
  90. Laravel Timezone – Manage timezones and conversions
  91. Laravel Collective API – API management for Laravel
  92. Laravel Rest API Boilerplate – REST API starter kit
  93. Laravel Multi Auth – Multi-authentication functionality
  94. Laravel Voyager – Admin panel for Laravel
  95. Laravel Voyager Database – Database manager for Voyager
  96. Laravel Categories – Handle categories for models
  97. Laravel Multitenancy – Multi-tenancy implementation
  98. Laravel Access Control – Advanced access control for users
  99. Laravel Menus – Menu management
  100. Laravel Translatable Routes – Multilingual route handling

 

Leave a Comment

Your email address will not be published. Required fields are marked *

Scroll to Top