🌐 실제 프로젝트에 적용하기

지금까지 배운 내용을 바탕으로 실제 프로젝트에 Passport를 적용하는 예제를 살펴볼게요. 재능넷과 같은 재능 공유 플랫폼을 예로 들어볼게요!

이 플랫폼에서는 다음과 같은 기능이 필요해요:

1. 사용자 인증 (로그인/회원가입)
2. 재능 판매자를 위한 API 액세스
3. 모바일 앱을 위한 API 인증
4. 외부 서비스와의 통합

이제 각 기능을 구현해볼게요!

1. 사용자 인증 API 구현하기

먼저 사용자 인증을 위한 API를 만들어볼게요. AuthController.php 파일을 생성해주세요:

namespace App\Http\Controllers;

use App\Models\User;
use Carbon\Carbon;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Facades\Validator;

class AuthController extends Controller
{
    /**
     * 회원가입
     */
    public function register(Request $request)
    {
        $validator = Validator::make($request->all(), [
            'name' => 'required|string|max:255',
            'email' => 'required|string|email|max:255|unique:users',
            'password' => 'required|string|min:8|confirmed',
        ]);

        if ($validator->fails()) {
            return response()->json(['errors' => $validator->errors()], 422);
        }

        $user = User::create([
            'name' => $request->name,
            'email' => $request->email,
            'password' => Hash::make($request->password),
        ]);

        $tokenResult = $user->createToken('Personal Access Token');
        $token = $tokenResult->token;
        $token->expires_at = Carbon::now()->addWeeks(1);
        $token->save();

        return response()->json([
            'message' => '회원가입이 완료되었습니다!',
            'access_token' => $tokenResult->accessToken,
            'token_type' => 'Bearer',
            'expires_at' => Carbon::parse($token->expires_at)->toDateTimeString()
        ], 201);
    }

    /**
     * 로그인
     */
    public function login(Request $request)
    {
        $validator = Validator::make($request->all(), [
            'email' => 'required|string|email',
            'password' => 'required|string',
            'remember_me' => 'boolean'
        ]);

        if ($validator->fails()) {
            return response()->json(['errors' => $validator->errors()], 422);
        }

        $credentials = request(['email', 'password']);
        if (!Auth::attempt($credentials)) {
            return response()->json([
                'message' => '이메일 또는 비밀번호가 올바르지 않습니다.'
            ], 401);
        }

        $user = $request->user();
        $tokenResult = $user->createToken('Personal Access Token');
        $token = $tokenResult->token;
        
        if ($request->remember_me) {
            $token->expires_at = Carbon::now()->addWeeks(1);
        }
        
        $token->save();

        return response()->json([
            'access_token' => $tokenResult->accessToken,
            'token_type' => 'Bearer',
            'expires_at' => Carbon::parse($token->expires_at)->toDateTimeString()
        ]);
    }

    /**
     * 로그아웃
     */
    public function logout(Request $request)
    {
        $request->user()->token()->revoke();
        return response()->json([
            'message' => '로그아웃 되었습니다!'
        ]);
    }

    /**
     * 사용자 정보 조회
     */
    public function user(Request $request)
    {
        return response()->json($request->user());
    }
}

그리고 라우트를 등록해주세요 (routes/api.php):

Route::group(['prefix' => 'auth'], function () {
    Route::post('register', [AuthController::class, 'register']);
    Route::post('login', [AuthController::class, 'login']);
    
    Route::group(['middleware' => 'auth:api'], function() {
        Route::get('logout', [AuthController::class, 'logout']);
        Route::get('user', [AuthController::class, 'user']);
    });
});

2. 재능 관련 API 구현하기

이제 재능 관련 API를 구현해볼게요. 먼저 Talent 모델을 만들어주세요:

php artisan make:model Talent -m

마이그레이션 파일을 수정해주세요:

public function up()
{
    Schema::create('talents', function (Blueprint $table) {
        $table->id();
        $table->foreignId('user_id')->constrained()->onDelete('cascade');
        $table->string('title');
        $table->text('description');
        $table->decimal('price', 10, 2);
        $table->string('category');
        $table->timestamps();
    });
}

그리고 TalentController를 만들어주세요:

namespace App\Http\Controllers;

use App\Models\Talent;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Validator;

class TalentController extends Controller
{
    /**
     * 재능 목록 조회
     */
    public function index()
    {
        $talents = Talent::with('user')->paginate(10);
        return response()->json($talents);
    }

    /**
     * 재능 등록
     */
    public function store(Request $request)
    {
        $validator = Validator::make($request->all(), [
            'title' => 'required|string|max:255',
            'description' => 'required|string',
            'price' => 'required|numeric|min:0',
            'category' => 'required|string|max:100',
        ]);

        if ($validator->fails()) {
            return response()->json(['errors' => $validator->errors()], 422);
        }

        $talent = Talent::create([
            'user_id' => $request->user()->id,
            'title' => $request->title,
            'description' => $request->description,
            'price' => $request->price,
            'category' => $request->category,
        ]);

        return response()->json($talent, 201);
    }

    /**
     * 재능 상세 조회
     */
    public function show($id)
    {
        $talent = Talent::with('user')->findOrFail($id);
        return response()->json($talent);
    }

    /**
     * 재능 수정
     */
    public function update(Request $request, $id)
    {
        $talent = Talent::findOrFail($id);
        
        // 권한 확인
        if ($request->user()->id !== $talent->user_id) {
            return response()->json(['error' => '권한이 없습니다.'], 403);
        }

        $validator = Validator::make($request->all(), [
            'title' => 'string|max:255',
            'description' => 'string',
            'price' => 'numeric|min:0',
            'category' => 'string|max:100',
        ]);

        if ($validator->fails()) {
            return response()->json(['errors' => $validator->errors()], 422);
        }

        $talent->update($request->all());
        return response()->json($talent);
    }

    /**
     * 재능 삭제
     */
    public function destroy(Request $request, $id)
    {
        $talent = Talent::findOrFail($id);
        
        // 권한 확인
        if ($request->user()->id !== $talent->user_id) {
            return response()->json(['error' => '권한이 없습니다.'], 403);
        }

        $talent->delete();
        return response()->json(['message' => '재능이 삭제되었습니다.']);
    }
}

라우트를 등록해주세요:

Route::group(['prefix' => 'talents', 'middleware' => 'auth:api'], function () {
    Route::get('/', [TalentController::class, 'index']);
    Route::post('/', [TalentController::class, 'store']);
    Route::get('/{id}', [TalentController::class, 'show']);
    Route::put('/{id}', [TalentController::class, 'update']);
    Route::delete('/{id}', [TalentController::class, 'destroy']);
});

3. 스코프를 활용한 권한 관리

이제 스코프를 활용해 권한을 관리해볼게요. AuthServiceProvider.php 파일에 다음 코드를 추가해주세요:

Passport::tokensCan([
    'read-talent' => '재능 정보 읽기',
    'create-talent' => '재능 등록',
    'update-talent' => '재능 수정',
    'delete-talent' => '재능 삭제',
    'read-user' => '사용자 정보 읽기',
    'update-user' => '사용자 정보 수정',
]);

그리고 라우트에 스코프 미들웨어를 적용해주세요:

Route::group(['prefix' => 'talents', 'middleware' => 'auth:api'], function () {
    Route::get('/', [TalentController::class, 'index'])->middleware('scopes:read-talent');
    Route::post('/', [TalentController::class, 'store'])->middleware('scopes:create-talent');
    Route::get('/{id}', [TalentController::class, 'show'])->middleware('scopes:read-talent');
    Route::put('/{id}', [TalentController::class, 'update'])->middleware('scopes:update-talent');
    Route::delete('/{id}', [TalentController::class, 'destroy'])->middleware('scopes:delete-talent');
});

이제 클라이언트에서 토큰을 요청할 때 필요한 스코프를 지정할 수 있어요:

POST /oauth/token
{
    "grant_type": "password",
    "client_id": "client-id",
    "client_secret": "client-secret",
    "username": "user@example.com",
    "password": "password",
    "scope": "read-talent create-talent update-talent"
}

이렇게 스코프를 활용하면 사용자마다 다른 권한을 부여할 수 있어요! 예를 들어, 일반 사용자는 'read-talent' 스코프만 가지고, 판매자는 'create-talent', 'update-talent' 스코프도 가질 수 있죠. 😊

이제 재능넷과 같은 재능 공유 플랫폼의 기본적인 API 인증 시스템이 완성되었어요! 사용자는 안전하게 로그인하고, 자신의 재능을 등록하고 관리할 수 있게 되었죠. 🎉