Laravel 12 - Integrate reCAPTCHA v3 with Livewire Auth.

Quick Overview

Step # 1 : Create a New Laravel Project with Livewire Authentication.

laravel new reCAPTCHAV3

composer create-project laravel/laravel --prefer-dist reCAPTCHAV3

• Would you like to install the starter kit? — Choose Livewire.
• Which authentication provider do you prefer? [Laravel's built-in authentication]? — Choose Laravel.
• Would you like to use Laravel Volt? (yes/no)? — Choose No.
• After selecting None, you'll be asked about testing framework. — Choose Pest.
• Frontend Dependencies: When prompted, type yes to install them automatically
  
  

Step # 2 : Access the project.

cd c:xampp/htdocs/reCAPTCHAV3

Step # 3 : Install the reCAPTCHA V3 Package.

composer require josiasmontag/laravel-recaptchav3

Step # 4 : Publish the Configuration File.

php artisan vendor:publish --provider="Lunaweb\RecaptchaV3\Providers\RecaptchaV3ServiceProvider"

Step # 5 : Obtain reCAPTCHA v3 Site Key and Secret.

1. Go to the reCAPTCHA Admin Console (Link : https://www.google.com/recaptcha/admin/create).
2. Log in with your Google account, or sign up if you don’t have one yet.
3. Create a label for your site to easily identify your keys later.
4. Select reCAPTCHA v3 as the version.
5. Add your site’s domain(s) to ensure security. Since we are working on localhost, you can use 127.0.0.1 as your domain.
6. Click Submit to generate your Site Key and Secret Key.
   
   

RECAPTCHAV3_SITEKEY="Define your SITE KEY here"
RECAPTCHAV3_SECRET="Define your SITE SECRET here"

Step # 6 : Initialize reCAPTCHA V3 JavaScript.

<!-- Initialize reCAPTCHA V3 -->
{!! RecaptchaV3::initJs() !!}

Step # 7 : Add reCAPTCHA Field to the Registration Form.

{{-- Hidden input for reCAPTCHA V3 --}}
{!! RecaptchaV3::field('register') !!}
<div class="flex items-center justify-end">
    <flux:button type="submit" variant="primary" class="w-full">
        {{ __('Create account') }}
    </flux:button>
</div>

Step # 8 : Validate reCAPTCHA in the CreateNewUser Action.

'g-recaptcha-response' => 'required|recaptchav3:register,0.5',

Step # 9 : Verify reCAPTCHA Integration.

php artisan serve

<?php
namespace App\Actions\Fortify;
use App\Models\User;
use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;
use Laravel\Fortify\Contracts\CreatesNewUsers;
class CreateNewUser implements CreatesNewUsers
{
    use PasswordValidationRules;
    /**
     * Validate and create a newly registered user.
     *
     * @param array<string, string> $input
     */
    public function create(array $input): User
    {
        // View all form data, including the reCAPTCHA token
        dd($input);
        Validator::make($input, [
            'name' => ['required', 'string', 'max:255'],
            'email' => [
                'required',
                'string',
                'email',
                'max:255',
                Rule::unique(User::class),
            ],
            'password' => $this->passwordRules(),
            // Validate the reCAPTCHA v3 response with a minimum score of 0.5
            'g-recaptcha-response' => 'required|recaptchav3:register,0.5',
        ])->validate();
        return User::create([
            'name' => $input['name'],
            'email' => $input['email'],
            'password' => $input['password'],
        ]);
    }
}

Step # 10 : Example of Validation Based on reCAPTCHA Score (Optional).

<?php
namespace App\Actions\Fortify;
use App\Models\User;
use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;
use Illuminate\Validation\ValidationException;
use Laravel\Fortify\Contracts\CreatesNewUsers;
// Facade for verifying reCAPTCHA v3 tokens and retrieving scores
use Lunaweb\RecaptchaV3\Facades\RecaptchaV3;
class CreateNewUser implements CreatesNewUsers
{
    use PasswordValidationRules;
    /**
     * Validate and create a newly registered user.
     *
     * @param array<string, string> $input
     */
    public function create(array $input): User
    {
        // Get reCAPTCHA score
        $score = RecaptchaV3::verify($input['g-recaptcha-response'], 'register');
        // // Inspect score with dd()
        if ($score > 0.5) {
            dd($score, 'Score OK – continue registration');
        } else {
            dd($score, 'Score too low – block registration');
        }
        // Validate user input including reCAPTCHA
        Validator::make($input, [
            'name' => ['required', 'string', 'max:255'],
            'email' => ['required', 'string', 'email', 'max:255', Rule::unique(User::class)],
            'password' => $this->passwordRules(),
            // The reCAPTCHA token is required; the score is verified manually with RecaptchaV3::verify()
            'g-recaptcha-response' => 'required',
        ])->validate();
        return User::create([
            'name' => $input['name'],
            'email' => $input['email'],
            'password' => $input['password'],
        ]);
    }
}

Conclusion