Laravelアプリケーションにログイン機能を追加

このガイドでは、Auth0 Laravel SDK を使用して、新規または既存の Laravel アプリケーションに Auth0 を統合する方法を説明します。

AI を使って Auth0 を統合する

Claude Code、Cursor、GitHub Copilot などのAIコーディングアシスタントを使っている場合は、Agent Skills を使って、数分で Auth0 認証を自動的に追加できます。

インストール:

npx skills add auth0/agent-skills --skill auth0

次に、AI アシスタントにこう依頼します。

Add Auth0 authentication to my Laravel app

AI アシスタントが、Auth0 アプリケーションの作成、資格情報の取得、auth0/login のインストール、環境変数の設定、認証ルートの登録を自動的に行います。Agent Skills の完全なドキュメント →

前提条件: 開始する前に、以下がインストールされていることを確認してください。

• PHP 8.2 以降
• Composer 2.x
• Laravel 11、12、または 13

インストール確認: php --version && composer --version

​

はじめに

このクイックスタートでは、LaravelアプリケーションにAuth0認証を追加する方法を説明します。Auth0 Laravel SDK を使用して、安全なログイン、ログアウト、保護されたルート、ユーザープロファイルへのアクセスを設定します。

1. 新しいLaravelプロジェクトを作成

   すでに Laravel アプリケーションがある場合は、手順 2 に進んでください。

   新しい Laravel プロジェクトを作成します:

   composer create-project laravel/laravel auth0-laravel-app
   

   プロジェクトディレクトリを開きます:

   cd auth0-laravel-app
   
2. Auth0 Laravel SDKをインストールする

   Auth0 Laravel SDK をインストールするには、プロジェクトのディレクトリで次のコマンドを実行してください。

   composer require auth0/login:^7 --update-with-all-dependencies
   

   次に、SDK の設定ファイルを公開します:

   php artisan vendor:publish --tag auth0
   
3. Auth0の資格情報を設定する

   Auth0 アプリケーションを作成し、資格情報をプロジェクトに追加する必要があります。次のいずれかの方法を選択してください。

   クイック設定（推奨）

   Auth0 App を作成し、適切な設定値があらかじめ入力された .env 用の資格情報をコピーします。

   これらの値をプロジェクトの .env ファイルに追加します。

   CLI

   プロジェクトのルートディレクトリで次のコマンドを実行し、Auth0 アプリを作成して .env ファイルを生成します。

   Mac

   # Auth0 CLI をインストール（まだインストールしていない場合）
   brew tap auth0/auth0-cli && brew install auth0
   
   # Auth0 アプリを設定し、.env ファイルを生成
   auth0 qs setup --app --type regular --framework laravel --build-tool composer --name "My Laravel App" --port 8000
   

   このコマンドは次の処理を行います:

   1. 認証済みかどうかを確認します (必要に応じてログインを促します)
   2. http://localhost:8000 用に設定された Auth0 Regular Web Application を作成します
   3. Auth0 の資格情報を含む .env ファイルを生成します

   Dashboard

   1. Auth0 Dashboard → アプリケーション > アプリケーション に移動します
   2. Create Application をクリックし、名前を入力して Regular Web Application を選択し、Create をクリックします
   3. 設定 タブに移動し、Domain、Client ID、Client Secret をコピーします

   アプリケーションの 設定 タブで、次の URL を設定します。

   Field	Value
   Allowed Callback URLs	http://localhost:8000/callback
   Allowed Logout URLs	http://localhost:8000

   変更を保存 をクリックします。

   次に、資格情報をプロジェクトの .env ファイルに追加します。

   .env

   AUTH0_DOMAIN=YOUR_AUTH0_DOMAIN
   AUTH0_CLIENT_ID=YOUR_AUTH0_CLIENT_ID
   AUTH0_CLIENT_SECRET=YOUR_AUTH0_CLIENT_SECRET
   

   AUTH0_CLIENT_SECRET は絶対にバージョン管理にコミットしないでください。.env に保存し、.env が .gitignore に含まれていることを確認してください。

4. 認証用ルートを追加

   Auth0 SDK は、アプリケーションに対して次のルートを自動的に登録します。追加のルート設定は不要です。

   Route	Purpose
   /login	Auth0 のログインフローを開始します
   /logout	ユーザーをログアウトし、Auth0 にリダイレクトします
   /callback	Auth0 認証のコールバックを処理します

   アプリケーションで Laravel Breeze、Fortify、または Jetstream を使用している場合、SDK の /login、/logout、/callback ルートが、それらのパッケージによって登録されたルートと競合する可能性があります。手動でルートを登録する手順については、SDK README を参照してください。

   routes/web.php を更新して、ホームルートを追加します。

   routes/web.php

   <?php
   
   use Illuminate\Support\Facades\Route;
   
   Route::get('/', function () {
       if (! auth()->check()) {
           return response('You are not logged in. <a href="/login">Log in</a>');
       }
   
       $user = auth()->user();
       $name = $user->name ?? 'User';
       $email = $user->email ?? '';
   
       return response("Hello {$name}! Your email address is {$email}.");
   });
   
5. ミドルウェアを使ってルートを保護する

   Laravel’s auth ミドルウェアを使用すると、任意のルートで認証を必須にできます。can ミドルウェアを使用して、特定の権限を必須にすることもできます:

   routes/web.php

   <?php
   
   use Illuminate\Support\Facades\Route;
   
   // 認証済みユーザーであれば誰でもアクセス可能
   Route::get('/private', function () {
       return response('Welcome! You are logged in.');
   })->middleware('auth');
   
   // 認証済みであり、かつ 'read:messages' パーミッションが必要
   Route::get('/scope', function () {
       return response('You have the read:messages permission.');
   })->middleware('auth')->can('read:messages');
   

   権限は Auth0 API の設定で定義され、ロールを通じてユーザーに割り当てられます。詳しくは、ロールベースのアクセス制御を参照してください。

6. アプリケーションを実行する

   php artisan serve
   

   アプリケーションは http://localhost:8000 で実行されます。ポート 8000 がすでに使用されている場合は、php artisan serve --port=8001 を実行し、新しいポートを使用するように Auth0 アプリケーションの Allowed Callback URLs と Allowed Logout URLs を更新してください。

チェックポイント

ブラウザーで http://localhost:8000 を開きます。連携を確認するため、次のルートを試してください。

• http://localhost:8000/login — Auth0のログインフローが開始されます
• http://localhost:8000/private — 未認証の場合はログインにリダイレクトされ、ログイン済みの場合はウェルカムメッセージが表示されます
• http://localhost:8000/logout — ログアウトしてホームページに戻ります

---

​

トラブルシューティング

コールバック URL の不一致エラー

原因: Auth0 に送信されたコールバック URL が、アプリケーションの Allowed Callback URLs に登録されている URL のいずれとも一致していません。

修正方法:

1. Auth0 Dashboard → アプリケーション > アプリケーション → 対象のアプリ → 設定 に移動します
2. Allowed Callback URLs に http://localhost:8000/callback を追加します
3. 変更を保存 をクリックします

末尾にスラッシュが付いていないこと、およびポート番号が実行中のサーバーと一致していることを確認してください。

ログイン後に state / CSRF エラーが発生する

原因: セッションまたは Cookie の設定に問題があります。Laravel のセッションで、ログインのリダイレクトからコールバックまでの間、state が保持されていません。

修正方法:

1. .env の SESSION_DRIVER が file、database、または redis に設定されていることを確認します (array は不可)
2. 設定とキャッシュをクリアします:

php artisan config:clear && php artisan cache:clear

3. 開発サーバーを再起動します

AUTH0_DOMAIN が設定されていない、または資格情報が読み込まれない

原因: SDK が Auth0 の資格情報を見つけられません。

修正方法: プロジェクトのルートに、次のいずれかが存在することを確認してください。

• AUTH0_DOMAIN、AUTH0_CLIENT_ID、AUTH0_CLIENT_SECRET を含む .env ファイル
• Auth0 CLI で生成された .auth0.app.json ファイル

.env を更新した後、設定キャッシュをクリアしてください:

php artisan config:clear

/login、/logout、または /callback で 404 が発生する

原因: SDK のルートが登録されていません。通常は、サービスプロバイダーが読み込まれていないことが原因です。

修正方法:

1. php artisan vendor:publish --tag auth0 を実行済みであることを確認します
2. パッケージの自動検出が有効になっていることを確認します (composer.json の "dont-discover": [] を確認)
3. php artisan route:list | grep auth0 を実行して、ルートが登録されていることを確認します
4. ルートが見つからない場合は、サービスプロバイダーを手動で登録します。Laravel 11 以降では、bootstrap/providers.php に追加します:

bootstrap/providers.php

return [
    App\Providers\AppServiceProvider::class,
    Auth0\Laravel\Auth0ServiceProvider::class,
];

---

​

高度な使用方法

Management API — ユーザーメタデータの更新

Auth0 Management API を使用して、ユーザー情報を更新できます。Management API のすべてのエンドポイントには、SDK の Auth0::management() メソッドからアクセスできます。

Management API を呼び出す前に、アプリケーションが Management API にアクセスできるよう認可してください。

1. Auth0 Dashboard → アプリケーション > APIs → Auth0 Management API に移動します
2. Machine to Machine アプリケーション タブを選択します
3. Laravel アプリケーションを認可し、read:users と update:users のスコープを付与します

routes/web.php

<?php

use Auth0\Laravel\Facade\Auth0;
use Illuminate\Support\Facades\Route;

Route::get('/colors', function () {
    $colors = ['red', 'blue', 'green', 'black', 'white', 'yellow', 'purple', 'orange'];

    $users = Auth0::management()->users();

    // 認証済みユーザーのメタデータを、ランダムに選んだ好きな色で更新
    $users->update(
        id: auth()->id(),
        body: [
            'user_metadata' => [
                'color' => $colors[random_int(0, count($colors) - 1)],
            ],
        ]
    );

    // 更新後のメタデータを取得して表示
    $metadata = Auth0::json($users->get(auth()->id()));
    $color = $metadata['user_metadata']['color'] ?? 'unknown';
    $name = auth()->user()->name;

    return response("Hello {$name}! Your favorite color is {$color}.");
})->middleware('auth');

Management API の全メソッドのリファレンスは、SDK ドキュメントで確認できます。

カスタムユーザーモデルとリポジトリ

SDK はカスタムユーザーモデルとリポジトリをサポートしており、Auth0 をアイデンティティプロバイダーとして利用しながら、独自のデータベースでユーザーの保存と取得を行えます。

実装ガイドの詳細は、User Repositories and Models を参照してください。

SDK イベントの監視

SDK は、認証ライフサイクルの重要なタイミングでイベントを発生させます。ログイン、ログアウト、トークンの更新などに応じてイベントが発生するため、SDK のコアコードを変更せずに動作を柔軟にカスタマイズできます。

イベントの一覧と実装例については、Hooking Events を参照してください。

ロールベースのアクセス制御 (RBAC)

Auth0 の RBAC を使用すると、ロールを通じてユーザーに権限を割り当て、Laravel では can ミドルウェアを使ってその権限を適用できます。

routes/web.php

<?php

use Illuminate\Support\Facades\Route;

Route::get('/admin', function () {
    return response('Admin area.');
})->middleware('auth')->can('admin:dashboard');

RBAC を設定するには:

1. Auth0 Dashboard → アプリケーション > APIs → 対象の API → Permissions に移動します
2. アプリケーションに必要な権限を追加します (例: admin:dashboard、read:messages)
3. User Management > Roles に移動し、ロールを作成して権限を割り当てます
4. ユーザーのプロファイルページからロールを割り当てます

詳細は、Role-Based Access Control を参照してください。

---

​

次のステップ

Laravel アプリケーションで認証が動作するようになったので、Auth0 のさらに多くの機能を見ていきましょう。

• Auth0 Dashboard — Auth0 テナントとアプリケーションの設定と管理
• laravel-auth0 SDK — SDK の完全なドキュメントと高度な連携
• ロールベースのアクセス制御 — ロールを使用してユーザーに権限を割り当てる
• Auth0 Marketplace — 連携を見つけて Auth0 の機能を拡張する