Passport を使用した Laravel 認(rèn)証のマスター: ステップバイステップガイド

認(rèn)証は最新の Web アプリケーションの基礎(chǔ)です。 Laravel では、Passport が完全な OAuth2 サーバー実裝を提供し、API 認(rèn)証をシームレスに有効にします。このガイドでは、インストールから API の保護(hù)とテストまで、Laravel Passport をセットアップするプロセス全體を説明します。

---

はじめに

Laravelパスポートを使用する理由?

Laravel Passport は、OAuth2 認(rèn)証を Laravel のエコシステムと緊密に統(tǒng)合することで、複雑な OAuth2 認(rèn)証を簡(jiǎn)素化します。パスポートを使用すると、次のことができます:

• API ユーザーを安全に認(rèn)証します。
• モバイルおよび Web クライアント用の個(gè)人アクセス トークンを生成します。
• トークンの有効期限と失効を簡(jiǎn)単に管理します。

---

前提條件

実際に始める前に、次のことを確認(rèn)してください。

1. Laravel の基本的な理解。
2. Laravel プロジェクト (v10.x 以降を推奨) がインストールされ、データベースが構(gòu)成されている。
3. PHP 8.0 以降がインストールされている。

プロジェクトが設(shè)定されていない場(chǎng)合は、次のコマンドを使用してプロジェクトを作成します。

composer create-project --prefer-dist laravel/laravel passport-auth
cd passport-auth

---

ステップ 1: Laravel Passport をインストールする

パッケージをインストールする

次のコマンドを?qū)g行して、Passport をプロジェクトに追加します:

composer require laravel/passport

パスポート ファイルの公開と移行

パスポートの移行と構(gòu)成ファイルを公開します:

php artisan vendor:publish --tag=passport-migrations
php artisan migrate

---

ステップ 2: Laravel パスポートを構(gòu)成する

暗號(hào)化キーとクライアントのインストール

インストール コマンドを?qū)g行します:

php artisan passport:install

これにより、暗號(hào)化キーが生成され、データベース內(nèi)に OAuth クライアントが作成されます。出力、特にクライアント ID とシークレットをメモします。

オプション: Personal Access Client を作成する

個(gè)人用アクセス クライアントを明示的に作成するには、次のコマンドを?qū)g行します。

php artisan passport:client --personal

---

ステップ 3: モデルを更新する

HasApiTokens トレイトをユーザー モデルに追加します。

use Laravel\Passport\HasApiTokens;

class User extends Authenticatable
{
    use HasApiTokens, Notifiable;

    // Other properties...
}

---

ステップ 4: 認(rèn)証構(gòu)成を更新する

config/auth.php で API ガードのドライバーとして Passport を構(gòu)成します:

'guards' => [
    'api' => [
        'driver' => 'passport',
        'provider' => 'users',
    ],
],

---

ステップ 5: パスポートのルートを登録する

AppProvidersAppServiceProvider で、Passport のルートを読み込みます:

use Laravel\Passport\Passport;

public function boot(): void
{
    Passport::routes();
    Passport::tokensExpireIn(now()->addDays(15));
    Passport::refreshTokensExpireIn(now()->addDays(30));
    Passport::personalAccessTokensExpireIn(now()->addMonths(6));
}

---

ステップ 6: 認(rèn)証 API エンドポイントを構(gòu)築する

ルートの追加

routes/api.php で API ルートを定義します:

use App\Http\Controllers\AuthController;

Route::post('/register', [AuthController::class, 'register']);
Route::post('/login', [AuthController::class, 'login']);
Route::middleware('auth:api')->get('/user', [AuthController::class, 'user']);

認(rèn)証コントローラーを作成する

認(rèn)証方法の実裝:

composer create-project --prefer-dist laravel/laravel passport-auth
cd passport-auth

---

ステップ 7: 暗號(hào)化キーの権限を設(shè)定する

パスポート キーへの安全なアクセスを確保します:

composer require laravel/passport

権限を確認(rèn)します:

php artisan vendor:publish --tag=passport-migrations
php artisan migrate

期待される出力:

php artisan passport:install

---

ステップ 8: API をテストする

Postman または任意の API クライアントを使用してエンドポイントをテストします:

1. 登録: 名前、電子メール、パスワードを指定して POST リクエストを /register に送信します。
2. ログイン: 電子メールとパスワードを使用して POST リクエストを /login に送信します。
3. ユーザー データの取得: Authorization ヘッダーのトークンを使用して GET リクエストを /user に送信します。

---

ベストプラクティス

• 本番環(huán)境では HTTPS を使用します。
• 暗號(hào)化キーを定期的にローテーションします。
• 入力を徹底的に検証します。
• セキュリティを向上させるためにトークンのスコープを制限します。

---

結(jié)論

おめでとうございます! Laravel Passport を使用して API 認(rèn)証を?qū)g裝することができました。この設(shè)定は、API を保護(hù)するための堅(jiān)牢な基盤を提供します。スコープ、トークン取り消し、クライアント認(rèn)証情報(bào)などの高度な Passport 機(jī)能を探索して、アプリケーションのセキュリティをさらに強(qiáng)化します。

---

以上がパスポートを使用したLaravel認(rèn)証の詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語(yǔ) Web サイトの他の関連記事を參照してください。