r0073rr0r/laravel-webauthn

Laravel Livewire WebAuthn package for registration and login.

1.1.1 2025-10-31 13:05 UTC

Requires

• php: ^8.2
• ext-openssl: *
• laravel/framework: ^12.0
• laravel/jetstream: ^5.0
• livewire/livewire: ^3.0
• spomky-labs/base64url: ^2.0
• spomky-labs/cbor-php: ^3.1
• web-auth/webauthn-framework: ^5.2

Requires (Dev)

• laravel/pint: ^1.25
• orchestra/testbench: ^10.6
• phpunit/phpunit: ^11.5

MIT

• r0073rr0r

README

Laravel package with Livewire components for WebAuthn authentication (biometric authentication, USB security keys, passkeys).

📋 Requirements

• PHP 8.2+
• Laravel 12.x
• Livewire 3.x
• Jestream 5.x
• OpenSSL extension for PHP
• Composer packages:
  • spomky-labs/base64url ^2.0
  • spomky-labs/cbor-php ^3.1
  • web-auth/webauthn-framework ^5.2

📦 Installation

Install the package via Composer:

composer require r0073rr0r/laravel-webauthn

Publish views and config files:

php artisan vendor:publish --provider="r0073rr0r\WebAuthn\WebAuthnServiceProvider"

Publish all package resources (views, translations, and public assets) with a single command:

php artisan vendor:publish --tag=webauthn

Migrate database tables:

php artisan migrate

⚙️ Setup

After publishing the assets, include the WebAuthn JavaScript file in your layout (e.g., in resources/views/layouts/app.blade.php & resources/views/layouts/guest.blade.php or wherever you have your main layout):

<script src="{{ asset('vendor/webauthn/webauthn/webauthn.js') }}"></script>

This script is required for the WebAuthn components to work properly.

🚀 Usage

Registration (WebAuthnRegister)

Add the component to your Blade view (I added it in resources/views/profile/show.blade.php):

<livewire:web-authn-register />

This component allows users to register their WebAuthn device (fingerprint, Face ID, USB security key, etc.).

Login (WebAuthnLogin)

Add the component to your Blade view (I added it in resources/views/auth/login.blade.php after login form):

<livewire:web-authn-login />

This component allows users to log in using their previously registered WebAuthn device.

🎨 Customization

You can customize the view files after publishing them:

• resources/views/vendor/laravel-webauthn/livewire/web-authn-register.blade.php
• resources/views/vendor/laravel-webauthn/livewire/web-authn-login.blade.php

🔒 Security

WebAuthn is a modern standard for secure passwordless authentication. This package uses browser native WebAuthn APIs for maximum security.

📝 License

MIT License

🤝 Contributing

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