Guide to implementing Apple ID login in Laravel

A detailed guide on how to integrate Apple ID login into a Laravel application using OAuth2. Learn how to configure your application to connect with Apple services and handle user login via Apple ID.

This article provides a step-by-step guide on how to integrate Apple ID as a login method in your Laravel application. We will use the socialiteproviders/apple package to connect with Apple's OAuth and handle user authentication from Apple ID.

Laravel Code

Step 1: Install Socialite Providers package

Use Composer to install the socialiteproviders/apple package for Laravel:

composer require socialiteproviders/apple

Step 2: Configure Apple ID OAuth

Add the Apple ID OAuth configuration to the config/services.php file:

'apple' => [
    'client_id' => env('APPLE_CLIENT_ID'),
    'client_secret' => env('APPLE_CLIENT_SECRET'),
    'redirect' => env('APPLE_REDIRECT_URI'),
],

Set the corresponding values in the .env file:

APPLE_CLIENT_ID=your-apple-client-id
APPLE_CLIENT_SECRET=your-apple-client-secret
APPLE_REDIRECT_URI=https://your-app.com/login/apple/callback

Step 3: Define routes for Apple login

Add routes for Apple login in the web.php file:

use Socialite;

Route::get('login/apple', function () {
    return Socialite::driver('apple')->redirect();
});

Route::get('login/apple/callback', function () {
    $user = Socialite::driver('apple')->user();
    
    // Handle user login or create a new user
    $existingUser = User::where('apple_id', $user->getId())->first();
    
    if ($existingUser) {
        Auth::login($existingUser);
        return redirect('/home');
    } else {
        // Create a new user if not exists
        $newUser = User::create([
            'name' => $user->getName(),
            'email' => $user->getEmail(),
            'apple_id' => $user->getId(),
        ]);
        
        Auth::login($newUser);
        return redirect('/home');
    }
});

Step 4: Create migration for apple_id column

Add the apple_id column to the users table to store the Apple user's ID:

php artisan make:migration add_apple_id_to_users_table --table=users

In the new migration file:

Schema::table('users', function (Blueprint $table) {
    $table->string('apple_id')->nullable();
});

Run the migration:

php artisan migrate

Detailed explanation of steps:

1. Install Socialite Providers: We use the socialiteproviders/apple package to connect to Apple's OAuth service.
2. Configure Apple ID OAuth: You'll need the client_id, client_secret, and redirect_uri from the Apple Developer console.
3. Set up login routes: Socialite::driver('apple') is used to redirect the user to the Apple login page and handle the callback.
4. Handle users: In the callback, we retrieve the user information from Apple, check if they exist, and either log them in or create a new user.
5. Create migration for apple_id: Add the apple_id column to store the user's Apple ID in the users table.

System requirements:

• Laravel version 8.x or 9.x
• socialiteproviders/apple package
• Apple Developer account to retrieve OAuth credentials

Installation instructions:

Use Composer to install Socialite and the Apple Providers package:

composer require laravel/socialite
composer require socialiteproviders/apple

Tips:

• Ensure your application uses HTTPS, as Apple requires the redirect URL to be SSL-secured.
• Double-check the information you get from Apple ID like email and name, as some fields may not be provided depending on the user's privacy settings.

---