Laravel Passport
업데이트됨번역일: 2026년 10월 20일
이 페이지는 원문이 업데이트되어 번역이 갱신되었습니다.
- 원문 수정
- 2026년 10월 13일
- 번역 갱신
- 2026년 10월 20일
Laravel Passport
- 소개
- 설치
- 설정
- 인가 코드 그랜트
- PKCE를 사용하는 인가 코드 그랜트
- 기기 인가 그랜트
- 비밀번호 그랜트
- 암시적 그랜트
- 클라이언트 자격 증명 그랜트
- 개인 액세스 토큰
- 라우트 보호
- 토큰 스코프
- SPA 인증
- 이벤트
- 테스트
소개
Laravel Passport는 Laravel 애플리케이션에 완전한 OAuth2 서버 구현을 빠르게 제공합니다. Andy Millington과 Simon Hamp가 관리하는 League OAuth2 server를 기반으로 만들어졌습니다.
NOTE
이 문서는 OAuth2에 익숙하다고 가정합니다. OAuth2를 처음 접한다면 먼저 일반적인 용어와 기능을 익히는 것이 좋습니다.
Passport와 Sanctum 중 무엇을 선택할까요?
시작하기 전에 애플리케이션에 Passport와 Laravel Sanctum 중 무엇이 더 적합한지 판단하세요. OAuth2 지원이 반드시 필요하다면 Passport를 사용해야 합니다.
SPA나 모바일 애플리케이션을 인증하거나 API 토큰을 발급하려는 목적이라면 Laravel Sanctum을 사용하세요. Sanctum은 OAuth2를 지원하지 않지만 API 인증을 훨씬 간단하게 구현할 수 있습니다.
설치
install:api Artisan 명령어로 Passport를 설치할 수 있습니다.
php artisan install:api --passport이 명령어는 OAuth2 클라이언트와 액세스 토큰을 저장할 테이블에 필요한 마이그레이션을 게시하고 실행합니다. 안전한 액세스 토큰 생성에 필요한 암호화 키도 생성합니다.
실행 후 App\Models\User 모델에 Laravel\Passport\HasApiTokens 트레이트와 Laravel\Passport\Contracts\OAuthenticatable 인터페이스를 추가합니다. 트레이트는 인증된 사용자의 토큰과 스코프를 확인할 수 있는 헬퍼 메서드를 제공합니다.
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Laravel\Passport\Contracts\OAuthenticatable;
use Laravel\Passport\HasApiTokens;
class User extends Authenticatable implements OAuthenticatable
{
use HasApiTokens, HasFactory, Notifiable;
}마지막으로 config/auth.php에서 api 인증 가드를 정의하고 driver를 passport로 설정합니다. 그러면 들어오는 API 요청을 인증할 때 Passport의 TokenGuard를 사용합니다.
'guards' => [
'web' => [
'driver' => 'session',
'provider' => 'users',
],
'api' => [
'driver' => 'passport',
'provider' => 'users',
],
],Passport 배포
서버에 Passport를 처음 배포할 때는 보통 passport:keys 명령어를 실행해야 합니다. 액세스 토큰 생성에 필요한 암호화 키를 만드는 명령어입니다. 생성된 키는 일반적으로 소스 관리에 포함하지 않습니다.
php artisan passport:keys키를 불러올 경로는 Passport::loadKeysFrom으로 지정할 수 있습니다. 일반적으로 App\Providers\AppServiceProvider의 boot 메서드에서 호출합니다.
/**
* Bootstrap any application services.
*/
public function boot(): void
{
Passport::loadKeysFrom(__DIR__.'/../secrets/oauth');
}환경 변수에서 키 불러오기
또는 vendor:publish Artisan 명령어로 Passport 설정 파일을 게시할 수 있습니다.
php artisan vendor:publish --tag=passport-config게시 후 환경 변수를 정의하여 애플리케이션의 암호화 키를 불러올 수 있습니다.
PASSPORT_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----
<private key here>
-----END RSA PRIVATE KEY-----"
PASSPORT_PUBLIC_KEY="-----BEGIN PUBLIC KEY-----
<public key here>
-----END PUBLIC KEY-----"Passport 업그레이드
새 메이저 버전으로 업그레이드할 때는 업그레이드 가이드를 꼼꼼히 확인해야 합니다.
설정
토큰 유효 기간
Passport는 기본적으로 1년 후 만료되는 장기 액세스 토큰을 발급합니다. 유효 기간을 늘리거나 줄이려면 tokensExpireIn, refreshTokensExpireIn, personalAccessTokensExpireIn 메서드를 사용합니다. App\Providers\AppServiceProvider의 boot 메서드에서 호출해야 합니다.
use Carbon\CarbonInterval;
/**
* Bootstrap any application services.
*/
public function boot(): void
{
Passport::tokensExpireIn(CarbonInterval::days(15));
Passport::refreshTokensExpireIn(CarbonInterval::days(30));
Passport::personalAccessTokensExpireIn(CarbonInterval::months(6));
}WARNING
Passport 데이터베이스 테이블의 expires_at 열은 표시 용도의 읽기 전용 값입니다. 토큰을 발급할 때 만료 정보는 서명되고 암호화된 토큰 안에 저장됩니다. 토큰을 무효화하려면 폐기해야 합니다.
기본 모델 재정의
자체 모델을 정의하고 해당 Passport 모델을 상속하여 Passport 내부 모델을 확장할 수 있습니다.
use Laravel\Passport\Client as PassportClient;
class Client extends PassportClient
{
// ...
}모델을 정의한 뒤 Laravel\Passport\Passport 클래스로 사용자 정의 모델을 사용하도록 지정합니다. 일반적으로 App\Providers\AppServiceProvider의 boot 메서드에서 설정합니다.
use App\Models\Passport\AuthCode;
use App\Models\Passport\Client;
use App\Models\Passport\DeviceCode;
use App\Models\Passport\RefreshToken;
use App\Models\Passport\Token;
use Laravel\Passport\Passport;
/**
* Bootstrap any application services.
*/
public function boot(): void
{
Passport::useTokenModel(Token::class);
Passport::useRefreshTokenModel(RefreshToken::class);
Passport::useAuthCodeModel(AuthCode::class);
Passport::useClientModel(Client::class);
Passport::useDeviceCodeModel(DeviceCode::class);
}라우트 재정의
Passport의 라우트를 변경하려면 먼저 AppServiceProvider의 register 메서드에서 Passport::ignoreRoutes를 호출하여 기본 라우트 등록을 비활성화합니다.
use Laravel\Passport\Passport;
/**
* Register any application services.
*/
public function register(): void
{
Passport::ignoreRoutes();
}그런 다음 Passport의 라우트 파일에 정의된 라우트를 애플리케이션의 routes/web.php에 복사하여 수정할 수 있습니다.
Route::group([
'as' => 'passport.',
'prefix' => config('passport.path', 'oauth'),
'namespace' => '\Laravel\Passport\Http\Controllers',
], function () {
// Passport routes...
});인가 코드 그랜트
인가 코드를 사용하는 방식은 많은 개발자에게 익숙한 OAuth2 흐름입니다. 클라이언트 애플리케이션은 사용자를 서버로 리다이렉트하고, 사용자는 클라이언트에 액세스 토큰 발급을 허용하거나 거부합니다.
먼저 Passport에 인가 뷰를 반환하는 방법을 지정해야 합니다.
인가 뷰 렌더링은 Laravel\Passport\Passport 클래스의 해당 메서드로 커스터마이징할 수 있습니다. 일반적으로 App\Providers\AppServiceProvider의 boot 메서드에서 호출합니다.
use Inertia\Inertia;
use Laravel\Passport\Passport;
/**
* Bootstrap any application services.
*/
public function boot(): void
{
// By providing a view name...
Passport::authorizationView('auth.oauth.authorize');
// By providing a closure...
Passport::authorizationView(
fn ($parameters) => Inertia::render('Auth/OAuth/Authorize', [
'request' => $parameters['request'],
'authToken' => $parameters['authToken'],
'client' => $parameters['client'],
'user' => $parameters['user'],
'scopes' => $parameters['scopes'],
])
);
}Passport는 이 뷰를 반환하는 /oauth/authorize 라우트를 자동 정의합니다. auth.oauth.authorize 템플릿에는 승인을 위해 passport.authorizations.approve로 POST 요청을 보내는 폼과, 거부를 위해 passport.authorizations.deny로 DELETE 요청을 보내는 폼이 있어야 합니다. 두 라우트에는 state, client_id, auth_token 필드를 전달해야 합니다.
클라이언트 관리
애플리케이션의 API를 사용하는 외부 애플리케이션 개발자는 “클라이언트”를 생성하여 자신의 애플리케이션을 등록해야 합니다. 일반적으로 애플리케이션 이름과, 사용자가 접근을 승인한 뒤 돌아갈 URI를 제공합니다.
자체 클라이언트
가장 간단한 클라이언트 생성 방법은 passport:client Artisan 명령어입니다. 자체 클라이언트를 만들거나 OAuth2 기능을 테스트할 때 사용할 수 있습니다. 실행하면 필요한 정보를 질문하고 클라이언트 ID와 시크릿을 제공합니다.
php artisan passport:client여러 리다이렉트 URI를 허용하려면 passport:client가 URI를 물을 때 쉼표로 구분한 목록을 입력합니다. URI 자체에 쉼표가 포함되어 있다면 해당 쉼표를 URI 인코딩해야 합니다.
https://third-party-app.com/callback,https://example.com/oauth/redirect외부 클라이언트
애플리케이션 사용자는 passport:client 명령어를 실행할 수 없으므로, Laravel\Passport\ClientRepository의 createAuthorizationCodeGrantClient 메서드로 특정 사용자에게 클라이언트를 등록할 수 있습니다.
use App\Models\User;
use Laravel\Passport\ClientRepository;
$user = User::find($userId);
// Creating an OAuth app client that belongs to the given user...
$client = app(ClientRepository::class)->createAuthorizationCodeGrantClient(
user: $user,
name: 'Example App',
redirectUris: ['https://third-party-app.com/callback'],
confidential: false,
enableDeviceFlow: true
);
// Retrieving all the OAuth app clients that belong to the user...
$clients = $user->oauthApps()->get();이 메서드는 Laravel\Passport\Client 인스턴스를 반환합니다. 사용자에게 $client->id를 클라이언트 ID로, $client->plainSecret을 클라이언트 시크릿으로 표시할 수 있습니다.
토큰 요청
인가를 위한 리다이렉트
클라이언트를 생성한 뒤에는 클라이언트 ID와 시크릿을 사용해 인가 코드와 액세스 토큰을 요청할 수 있습니다. 먼저 API를 사용하는 애플리케이션에서 서버의 /oauth/authorize 라우트로 다음과 같이 리다이렉트합니다.
use Illuminate\Http\Request;
use Illuminate\Support\Str;
Route::get('/redirect', function (Request $request) {
$request->session()->put('state', $state = Str::random(40));
$query = http_build_query([
'client_id' => 'your-client-id',
'redirect_uri' => 'https://third-party-app.com/callback',
'response_type' => 'code',
'scope' => 'user:read orders:create',
'state' => $state,
// 'prompt' => '', // "none", "consent", or "login"
]);
return redirect('https://passport-app.test/oauth/authorize?'.$query);
});prompt 매개변수는 Passport 애플리케이션의 인증 동작을 지정합니다.
none이면 사용자가 Passport 애플리케이션에 이미 로그인한 상태가 아닐 때 항상 인증 오류가 발생합니다. consent이면 요청한 모든 스코프를 이미 허용했더라도 인가 승인 화면을 항상 표시합니다. login이면 기존 세션이 있어도 사용자에게 다시 로그인하도록 요구합니다.
prompt를 전달하지 않으면, 해당 클라이언트에 요청한 스코프의 접근을 이전에 승인하지 않은 경우에만 인가를 요청합니다.
NOTE
/oauth/authorize 라우트는 Passport가 이미 정의하므로 직접 정의할 필요가 없습니다.
요청 승인
인가 요청을 받으면 Passport는 prompt 값이 있는 경우 그에 따라 응답하며, 사용자가 요청을 승인하거나 거부할 수 있는 템플릿을 표시할 수 있습니다. 승인하면 클라이언트가 지정한 redirect_uri로 돌아갑니다. 이 URI는 클라이언트 생성 시 지정한 redirect URL과 일치해야 합니다.
자체 클라이언트에 인가할 때처럼 승인 화면을 생략하고 싶을 수 있습니다. Client 모델을 확장하고 skipsAuthorization 메서드를 정의하면 됩니다. 이 메서드가 true를 반환하면 클라이언트를 승인하고 즉시 redirect_uri로 이동합니다. 단, 클라이언트가 인가 리다이렉트 시 prompt를 명시했다면 예외입니다.
<?php
namespace App\Models\Passport;
use Illuminate\Contracts\Auth\Authenticatable;
use Laravel\Passport\Client as BaseClient;
class Client extends BaseClient
{
/**
* Determine if the client should skip the authorization prompt.
*
* @param \Laravel\Passport\Scope[] $scopes
*/
public function skipsAuthorization(Authenticatable $user, array $scopes): bool
{
return $this->firstParty();
}
}인가 코드를 액세스 토큰으로 교환
사용자가 인가 요청을 승인하면 클라이언트 애플리케이션으로 돌아갑니다. 클라이언트는 먼저 state가 리다이렉트 전에 저장한 값과 일치하는지 검증해야 합니다. 일치하면 서버에 POST 요청을 보내 액세스 토큰을 요청합니다. 요청에는 사용자가 승인할 때 서버가 발급한 인가 코드가 포함되어야 합니다.
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Http;
Route::get('/callback', function (Request $request) {
$state = $request->session()->pull('state');
throw_unless(
strlen($state) > 0 && $state === $request->state,
InvalidArgumentException::class,
'Invalid state value.'
);
$response = Http::asForm()->post('https://passport-app.test/oauth/token', [
'grant_type' => 'authorization_code',
'client_id' => 'your-client-id',
'client_secret' => 'your-client-secret',
'redirect_uri' => 'https://third-party-app.com/callback',
'code' => $request->code,
]);
return $response->json();
});/oauth/token은 access_token, refresh_token, expires_in 속성이 담긴 JSON 응답을 반환합니다. expires_in은 액세스 토큰 만료까지 남은 초입니다.
NOTE
/oauth/authorize와 마찬가지로 /oauth/token도 Passport가 정의하므로 직접 정의할 필요가 없습니다.
토큰 관리
Laravel\Passport\HasApiTokens 트레이트의 tokens 메서드로 사용자가 승인한 토큰을 조회할 수 있습니다. 예를 들어 외부 애플리케이션 연결을 관리하는 사용자 대시보드를 만들 때 사용할 수 있습니다.
use App\Models\User;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Support\Facades\Date;
use Laravel\Passport\Token;
$user = User::find($userId);
// Retrieving all of the valid tokens for the user...
$tokens = $user->tokens()
->where('revoked', false)
->where('expires_at', '>', Date::now())
->get();
// Retrieving all the user's connections to third-party OAuth app clients...
$connections = $tokens->load('client')
->reject(fn (Token $token) => $token->client->firstParty())
->groupBy('client_id')
->map(fn (Collection $tokens) => [
'client' => $tokens->first()->client,
'scopes' => $tokens->pluck('scopes')->flatten()->unique()->values()->all(),
'tokens_count' => $tokens->count(),
])
->values();토큰 갱신
유효 기간이 짧은 액세스 토큰을 발급한다면, 사용자는 발급 시 함께 받은 리프레시 토큰으로 액세스 토큰을 갱신해야 합니다.
use Illuminate\Support\Facades\Http;
$response = Http::asForm()->post('https://passport-app.test/oauth/token', [
'grant_type' => 'refresh_token',
'refresh_token' => 'the-refresh-token',
'client_id' => 'your-client-id',
'client_secret' => 'your-client-secret', // Required for confidential clients only...
'scope' => 'user:read orders:create',
]);
return $response->json();/oauth/token은 access_token, refresh_token, expires_in 속성이 담긴 JSON 응답을 반환합니다. expires_in은 액세스 토큰 만료까지 남은 초입니다.
토큰 폐기
Laravel\Passport\Token 모델의 revoke 메서드로 액세스 토큰을 폐기할 수 있습니다. 리프레시 토큰은 Laravel\Passport\RefreshToken 모델의 revoke 메서드로 폐기합니다.
use Laravel\Passport\Passport;
use Laravel\Passport\Token;
$token = Passport::token()->find($tokenId);
// Revoke an access token...
$token->revoke();
// Revoke the token's refresh token...
$token->refreshToken?->revoke();
// Revoke all of the user's tokens...
User::find($userId)->tokens()->each(function (Token $token) {
$token->revoke();
$token->refreshToken?->revoke();
});토큰 정리
폐기되거나 만료된 토큰을 데이터베이스에서 제거하려면 Passport의 passport:purge Artisan 명령어를 사용할 수 있습니다.
# Purge revoked and expired tokens, auth codes, and device codes...php artisan passport:purge# Only purge tokens expired for more than 6 hours...php artisan passport:purge --expired --hours=6# Only purge revoked tokens, auth codes, and device codes...php artisan passport:purge --revoked# Only purge expired tokens, auth codes, and device codes...php artisan passport:purge --expiredroutes/console.php에 예약 작업을 정의하여 주기적으로 토큰을 자동 정리할 수도 있습니다.
use Illuminate\Support\Facades\Schedule;
Schedule::command('passport:purge')->hourly();PKCE를 사용하는 인가 코드 그랜트
PKCE(Proof Key for Code Exchange)를 적용한 인가 코드 그랜트는 SPA나 모바일 애플리케이션이 API에 안전하게 접근하도록 인증하는 방식입니다. 클라이언트 시크릿을 비밀로 보관할 수 없거나 공격자의 인가 코드 가로채기 위협을 줄여야 할 때 사용해야 합니다. 인가 코드를 액세스 토큰으로 교환할 때 “코드 검증자(code verifier)”와 “코드 챌린지(code challenge)”의 조합이 클라이언트 시크릿을 대신합니다.
클라이언트 생성
PKCE 인가 코드 그랜트로 토큰을 발급하려면 먼저 PKCE를 지원하는 클라이언트를 만들어야 합니다. passport:client Artisan 명령어에 --public 옵션을 사용합니다.
php artisan passport:client --public토큰 요청
코드 검증자와 코드 챌린지
이 그랜트에는 클라이언트 시크릿이 없으므로 토큰 요청을 위해 코드 검증자와 코드 챌린지를 생성해야 합니다.
코드 검증자는 RFC 7636 명세에 따라 영문자, 숫자, "-", ".", "_", "~"로 이루어진 43~128자의 무작위 문자열이어야 합니다.
코드 챌린지는 URL과 파일 이름에 안전한 문자를 사용하는 Base64 인코딩 문자열이어야 합니다. 끝의 '=' 문자는 제거하고 줄바꿈, 공백, 그 밖의 추가 문자를 포함해서는 안 됩니다.
$encoded = base64_encode(hash('sha256', $codeVerifier, true));
$codeChallenge = strtr(rtrim($encoded, '='), '+/', '-_');인가를 위한 리다이렉트
클라이언트를 생성했다면 클라이언트 ID와 생성한 코드 검증자·코드 챌린지로 인가 코드와 액세스 토큰을 요청할 수 있습니다. 먼저 클라이언트 애플리케이션에서 서버의 /oauth/authorize 라우트로 리다이렉트합니다.
use Illuminate\Http\Request;
use Illuminate\Support\Str;
Route::get('/redirect', function (Request $request) {
$request->session()->put('state', $state = Str::random(40));
$request->session()->put(
'code_verifier', $codeVerifier = Str::random(128)
);
$codeChallenge = strtr(rtrim(
base64_encode(hash('sha256', $codeVerifier, true))
, '='), '+/', '-_');
$query = http_build_query([
'client_id' => 'your-client-id',
'redirect_uri' => 'https://third-party-app.com/callback',
'response_type' => 'code',
'scope' => 'user:read orders:create',
'state' => $state,
'code_challenge' => $codeChallenge,
'code_challenge_method' => 'S256',
// 'prompt' => '', // "none", "consent", or "login"
]);
return redirect('https://passport-app.test/oauth/authorize?'.$query);
});인가 코드를 액세스 토큰으로 교환
사용자가 인가 요청을 승인하면 클라이언트 애플리케이션으로 돌아갑니다. 일반 인가 코드 그랜트와 마찬가지로 state가 리다이렉트 전에 저장한 값과 일치하는지 검증해야 합니다.
일치하면 서버에 POST 요청을 보내 액세스 토큰을 요청합니다. 요청에는 사용자가 승인할 때 서버가 발급한 인가 코드와 처음 생성한 코드 검증자를 함께 포함해야 합니다.
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Http;
Route::get('/callback', function (Request $request) {
$state = $request->session()->pull('state');
$codeVerifier = $request->session()->pull('code_verifier');
throw_unless(
strlen($state) > 0 && $state === $request->state,
InvalidArgumentException::class
);
$response = Http::asForm()->post('https://passport-app.test/oauth/token', [
'grant_type' => 'authorization_code',
'client_id' => 'your-client-id',
'redirect_uri' => 'https://third-party-app.com/callback',
'code_verifier' => $codeVerifier,
'code' => $request->code,
]);
return $response->json();
});기기 인가 그랜트
OAuth2 기기 인가 그랜트는 TV나 게임 콘솔처럼 브라우저가 없거나 입력이 제한된 기기가 “기기 코드(device code)”를 교환해 액세스 토큰을 얻도록 합니다. 이 흐름에서 기기 클라이언트는 사용자에게 컴퓨터나 스마트폰 같은 다른 기기로 서버에 접속하도록 안내합니다. 사용자는 제공된 “사용자 코드(user code)”를 입력하고 접근 요청을 승인하거나 거부합니다.
먼저 Passport에 사용자 코드 입력 뷰와 인가 뷰를 반환하는 방법을 지정해야 합니다.
인가 뷰 렌더링은 Laravel\Passport\Passport 클래스의 해당 메서드로 커스터마이징할 수 있습니다. 일반적으로 App\Providers\AppServiceProvider의 boot 메서드에서 호출합니다.
use Inertia\Inertia;
use Laravel\Passport\Passport;
/**
* Bootstrap any application services.
*/
public function boot(): void
{
// By providing a view name...
Passport::deviceUserCodeView('auth.oauth.device.user-code');
Passport::deviceAuthorizationView('auth.oauth.device.authorize');
// By providing a closure...
Passport::deviceUserCodeView(
fn ($parameters) => Inertia::render('Auth/OAuth/Device/UserCode')
);
Passport::deviceAuthorizationView(
fn ($parameters) => Inertia::render('Auth/OAuth/Device/Authorize', [
'request' => $parameters['request'],
'authToken' => $parameters['authToken'],
'client' => $parameters['client'],
'user' => $parameters['user'],
'scopes' => $parameters['scopes'],
])
);
// ...
}Passport는 이 뷰들을 반환하는 라우트를 자동으로 정의합니다. auth.oauth.device.user-code 템플릿에는 passport.device.authorizations.authorize로 GET 요청을 보내는 폼이 있어야 합니다. 이 라우트는 쿼리 매개변수 user_code를 받습니다.
auth.oauth.device.authorize 템플릿에는 승인을 위해 passport.device.authorizations.approve로 POST 요청을 보내는 폼과, 거부를 위해 passport.device.authorizations.deny로 DELETE 요청을 보내는 폼이 있어야 합니다. 두 라우트는 state, client_id, auth_token 필드를 받습니다.
기기 인가 그랜트 클라이언트 생성
기기 인가 그랜트로 토큰을 발급하려면 먼저 기기 흐름을 지원하는 클라이언트를 생성해야 합니다. passport:client Artisan 명령어에 --device 옵션을 사용하면 자체 기기 클라이언트를 생성하고 클라이언트 ID와 시크릿을 제공합니다.
php artisan passport:client --deviceClientRepository의 createDeviceAuthorizationGrantClient 메서드로 특정 사용자에게 속하는 외부 클라이언트를 등록할 수도 있습니다.
use App\Models\User;
use Laravel\Passport\ClientRepository;
$user = User::find($userId);
$client = app(ClientRepository::class)->createDeviceAuthorizationGrantClient(
user: $user,
name: 'Example Device',
confidential: false,
);토큰 요청
기기 코드 요청
클라이언트를 생성한 뒤 개발자는 클라이언트 ID로 기기 코드를 요청할 수 있습니다. 먼저 기기에서 서버의 /oauth/device/code로 POST 요청을 보냅니다.
use Illuminate\Support\Facades\Http;
$response = Http::asForm()->post('https://passport-app.test/oauth/device/code', [
'client_id' => 'your-client-id',
'scope' => 'user:read orders:create',
]);
return $response->json();응답 JSON에는 device_code, user_code, verification_uri, interval, expires_in 속성이 포함됩니다. expires_in은 기기 코드 만료까지 남은 초입니다. interval은 요청 속도 제한 오류를 피하기 위해 기기가 /oauth/token을 폴링할 때 요청 사이에 기다려야 하는 초입니다.
NOTE
/oauth/device/code 라우트는 Passport가 이미 정의하므로 직접 정의할 필요가 없습니다.
인증 URI와 사용자 코드 표시
기기 코드를 받으면 기기는 사용자에게 다른 기기에서 verification_uri에 접속하고 user_code를 입력하여 인가 요청을 승인하도록 안내해야 합니다.
토큰 요청 폴링
사용자가 별도 기기에서 접근을 승인하거나 거부하므로, 요청 기기는 서버의 /oauth/token을 폴링하여 응답 여부를 확인해야 합니다. 요청 속도 제한 오류를 피하도록 기기 코드 응답 JSON의 최소 폴링 간격 interval을 준수해야 합니다.
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Sleep;
$interval = 5;
do {
Sleep::for($interval)->seconds();
$response = Http::asForm()->post('https://passport-app.test/oauth/token', [
'grant_type' => 'urn:ietf:params:oauth:grant-type:device_code',
'client_id' => 'your-client-id',
'client_secret' => 'your-client-secret', // Required for confidential clients only...
'device_code' => 'the-device-code',
]);
if ($response->json('error') === 'slow_down') {
$interval += 5;
}
} while (in_array($response->json('error'), ['authorization_pending', 'slow_down']));
return $response->json();사용자가 인가 요청을 승인했다면 access_token, refresh_token, expires_in 속성을 가진 JSON 응답을 반환합니다. expires_in은 액세스 토큰 만료까지 남은 초입니다.
비밀번호 그랜트
WARNING
비밀번호 그랜트 토큰은 더 이상 권장하지 않습니다. 대신 OAuth2 Server가 현재 권장하는 그랜트 유형을 선택하세요.
OAuth2 비밀번호 그랜트는 모바일 앱 같은 자체 클라이언트가 이메일 주소 또는 사용자명과 비밀번호로 액세스 토큰을 얻도록 합니다. 사용자가 OAuth2 인가 코드 리다이렉트 흐름 전체를 거치지 않고도 자체 클라이언트에 액세스 토큰을 안전하게 발급할 수 있도록 하는 방식입니다.
활성화하려면 App\Providers\AppServiceProvider의 boot 메서드에서 enablePasswordGrant를 호출합니다.
/**
* Bootstrap any application services.
*/
public function boot(): void
{
Passport::enablePasswordGrant();
}비밀번호 그랜트 클라이언트 생성
비밀번호 그랜트로 토큰을 발급하려면 먼저 해당 클라이언트를 생성해야 합니다. passport:client Artisan 명령어에 --password 옵션을 사용합니다.
php artisan passport:client --password토큰 요청
그랜트를 활성화하고 클라이언트를 생성했다면 사용자의 이메일과 비밀번호를 포함한 POST 요청을 /oauth/token으로 보내 액세스 토큰을 요청할 수 있습니다. 이 라우트는 Passport가 등록하므로 직접 정의할 필요가 없습니다. 성공하면 JSON 응답에 access_token과 refresh_token이 포함됩니다.
use Illuminate\Support\Facades\Http;
$response = Http::asForm()->post('https://passport-app.test/oauth/token', [
'grant_type' => 'password',
'client_id' => 'your-client-id',
'client_secret' => 'your-client-secret', // Required for confidential clients only...
'username' => 'taylor@laravel.com',
'password' => 'my-password',
'scope' => 'user:read orders:create',
]);
return $response->json();NOTE
액세스 토큰은 기본적으로 유효 기간이 깁니다. 필요하다면 최대 유효 기간을 설정할 수 있습니다.
모든 스코프 요청
비밀번호 그랜트나 클라이언트 자격 증명 그랜트에서는 * 스코프를 요청해 애플리케이션의 모든 스코프를 허용할 수 있습니다. 이 스코프를 요청하면 토큰 인스턴스의 can 메서드가 항상 true를 반환합니다. *는 password 또는 client_credentials 그랜트로 발급한 토큰에만 할당할 수 있습니다.
use Illuminate\Support\Facades\Http;
$response = Http::asForm()->post('https://passport-app.test/oauth/token', [
'grant_type' => 'password',
'client_id' => 'your-client-id',
'client_secret' => 'your-client-secret', // Required for confidential clients only...
'username' => 'taylor@laravel.com',
'password' => 'my-password',
'scope' => '*',
]);사용자 프로바이더 커스터마이징
여러 인증 사용자 프로바이더를 사용한다면 artisan passport:client --password로 클라이언트를 생성할 때 --provider 옵션으로 사용할 프로바이더를 지정할 수 있습니다. 이름은 config/auth.php에 정의된 유효한 프로바이더와 일치해야 합니다. 이어서 미들웨어로 라우트를 보호하면 가드에 지정된 프로바이더의 사용자만 접근하도록 할 수 있습니다.
사용자명 필드 커스터마이징
비밀번호 그랜트로 인증할 때 Passport는 인증 가능 모델의 email 속성을 사용자명으로 사용합니다. 모델에 findForPassport 메서드를 정의하면 이를 변경할 수 있습니다.
<?php
namespace App\Models;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Laravel\Passport\Bridge\Client;
use Laravel\Passport\Contracts\OAuthenticatable;
use Laravel\Passport\HasApiTokens;
class User extends Authenticatable implements OAuthenticatable
{
use HasApiTokens, Notifiable;
/**
* Find the user instance for the given username.
*/
public function findForPassport(string $username, Client $client): User
{
return $this->where('username', $username)->first();
}
}비밀번호 검증 커스터마이징
비밀번호 그랜트 인증 시 Passport는 모델의 password 속성으로 전달된 비밀번호를 검증합니다. 모델에 이 속성이 없거나 검증 로직을 변경하려면 validateForPassportPasswordGrant 메서드를 정의할 수 있습니다.
<?php
namespace App\Models;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Illuminate\Support\Facades\Hash;
use Laravel\Passport\Contracts\OAuthenticatable;
use Laravel\Passport\HasApiTokens;
class User extends Authenticatable implements OAuthenticatable
{
use HasApiTokens, Notifiable;
/**
* Validate the password of the user for the Passport password grant.
*/
public function validateForPassportPasswordGrant(string $password): bool
{
return Hash::check($password, $this->password);
}
}암시적 그랜트
WARNING
암시적 그랜트 토큰은 더 이상 권장하지 않습니다. 대신 OAuth2 Server가 현재 권장하는 그랜트 유형을 선택하세요.
암시적 그랜트는 인가 코드 그랜트와 비슷하지만 인가 코드 교환 없이 클라이언트에 토큰을 반환합니다. 클라이언트 자격 증명을 안전하게 저장할 수 없는 JavaScript 또는 모바일 애플리케이션에서 주로 사용되어 온 방식입니다. 활성화하려면 App\Providers\AppServiceProvider의 boot 메서드에서 enableImplicitGrant를 호출합니다.
/**
* Bootstrap any application services.
*/
public function boot(): void
{
Passport::enableImplicitGrant();
}암시적 그랜트로 토큰을 발급하려면 먼저 해당 클라이언트를 만들어야 합니다. passport:client Artisan 명령어에 --implicit 옵션을 사용합니다.
php artisan passport:client --implicit그랜트를 활성화하고 클라이언트를 생성한 뒤 개발자는 클라이언트 ID로 액세스 토큰을 요청할 수 있습니다. 클라이언트 애플리케이션에서 서버의 /oauth/authorize 라우트로 다음과 같이 리다이렉트합니다.
use Illuminate\Http\Request;
Route::get('/redirect', function (Request $request) {
$request->session()->put('state', $state = Str::random(40));
$query = http_build_query([
'client_id' => 'your-client-id',
'redirect_uri' => 'https://third-party-app.com/callback',
'response_type' => 'token',
'scope' => 'user:read orders:create',
'state' => $state,
// 'prompt' => '', // "none", "consent", or "login"
]);
return redirect('https://passport-app.test/oauth/authorize?'.$query);
});NOTE
/oauth/authorize 라우트는 Passport가 이미 정의하므로 직접 정의할 필요가 없습니다.
클라이언트 자격 증명 그랜트
클라이언트 자격 증명 그랜트는 기계 간 인증에 적합합니다. 예를 들어 API를 통해 유지보수하는 예약 작업에 사용할 수 있습니다.
토큰을 발급하려면 먼저 해당 클라이언트를 만들어야 합니다. passport:client Artisan 명령어의 --client 옵션을 사용합니다.
php artisan passport:client --client이어서 라우트에 Laravel\Passport\Http\Middleware\EnsureClientIsResourceOwner 미들웨어를 지정합니다.
use Laravel\Passport\Http\Middleware\EnsureClientIsResourceOwner;
Route::get('/orders', function (Request $request) {
// Access token is valid and the client is resource owner...
})->middleware(EnsureClientIsResourceOwner::class);특정 스코프를 가진 경우로 접근을 제한하려면 using 메서드에 필요한 스코프 목록을 전달합니다.
Route::get('/orders', function (Request $request) {
// Access token is valid, the client is resource owner, and has both "servers:read" and "servers:create" scopes...
})->middleware(EnsureClientIsResourceOwner::using('servers:read', 'servers:create'));WARNING
기반 OAuth2 서버는 클라이언트 자격 증명 토큰의 sub 클레임을 클라이언트 식별자로 설정합니다. Passport는 기본적으로 클라이언트에 UUID를 사용하므로 사용자의 정수 기본 키와 충돌하지 않습니다. 하지만 Passport::$clientUuids를 false로 설정했다면 클라이언트 ID와 같은 ID의 사용자가 의도치 않게 조회될 수 있습니다. 이 경우 이 미들웨어를 사용해도 들어온 토큰이 클라이언트 자격 증명 토큰이라고 보장할 수 없습니다.
토큰 조회
이 그랜트로 토큰을 얻으려면 oauth/token 엔드포인트에 요청합니다.
use Illuminate\Support\Facades\Http;
$response = Http::asForm()->post('https://passport-app.test/oauth/token', [
'grant_type' => 'client_credentials',
'client_id' => 'your-client-id',
'client_secret' => 'your-client-secret',
'scope' => 'servers:read servers:create',
]);
return $response->json()['access_token'];개인 액세스 토큰
사용자는 일반적인 인가 코드 리다이렉트 흐름 없이 자신을 위한 액세스 토큰을 발급하고 싶을 수 있습니다. 애플리케이션 UI에서 직접 토큰을 발급하도록 허용하면 API를 시험하기에 편리하고, 전반적인 토큰 발급 방식도 간단해질 수 있습니다.
NOTE
주로 개인 액세스 토큰 발급을 위해 Passport를 사용한다면, API 액세스 토큰 발급을 위한 Laravel의 경량 자체 라이브러리인 Laravel Sanctum을 고려하세요.
개인 액세스 클라이언트 생성
개인 액세스 토큰을 발급하려면 먼저 개인 액세스 클라이언트를 생성해야 합니다. passport:client Artisan 명령어에 --personal 옵션을 사용합니다. 이미 passport:install을 실행했다면 다시 실행할 필요가 없습니다.
php artisan passport:client --personal사용자 프로바이더 커스터마이징
여러 인증 사용자 프로바이더를 사용한다면 artisan passport:client --personal로 클라이언트를 만들 때 --provider 옵션으로 사용할 프로바이더를 지정할 수 있습니다. 이름은 config/auth.php에 정의된 유효한 프로바이더와 일치해야 합니다. 이어서 미들웨어로 라우트를 보호하면 가드에 지정된 프로바이더의 사용자만 접근하도록 할 수 있습니다.
개인 액세스 토큰 관리
개인 액세스 클라이언트를 만들었다면 App\Models\User 인스턴스의 createToken 메서드로 특정 사용자의 토큰을 발급할 수 있습니다. 첫 번째 인수로 토큰 이름을, 두 번째 인수로 선택 사항인 스코프 배열을 받습니다.
use App\Models\User;
use Illuminate\Support\Facades\Date;
use Laravel\Passport\Token;
$user = User::find($userId);
// Creating a token without scopes...
$token = $user->createToken('My Token')->accessToken;
// Creating a token with scopes...
$token = $user->createToken('My Token', ['user:read', 'orders:create'])->accessToken;
// Creating a token with all scopes...
$token = $user->createToken('My Token', ['*'])->accessToken;
// Retrieving all the valid personal access tokens that belong to the user...
$tokens = $user->tokens()
->with('client')
->where('revoked', false)
->where('expires_at', '>', Date::now())
->get()
->filter(fn (Token $token) => $token->client->hasGrantType('personal_access'));라우트 보호
미들웨어 사용
Passport에는 들어오는 요청의 액세스 토큰을 검증하는 인증 가드가 포함되어 있습니다. api 가드가 passport 드라이버를 사용하도록 설정했다면, 유효한 토큰이 필요한 라우트에 auth:api 미들웨어를 지정하면 됩니다.
Route::get('/user', function () {
// Only API authenticated users may access this route...
})->middleware('auth:api');WARNING
클라이언트 자격 증명 그랜트를 사용한다면 auth:api 대신 Laravel\Passport\Http\Middleware\EnsureClientIsResourceOwner 미들웨어로 라우트를 보호해야 합니다.
여러 인증 가드
서로 다른 Eloquent 모델 등 여러 유형의 사용자를 인증한다면 각 사용자 프로바이더 유형에 대한 가드 설정이 필요할 수 있습니다. 이를 통해 특정 프로바이더를 대상으로 하는 요청을 보호할 수 있습니다. 예를 들어 config/auth.php에 다음과 같이 설정합니다.
'guards' => [
'api' => [
'driver' => 'passport',
'provider' => 'users',
],
'api-customers' => [
'driver' => 'passport',
'provider' => 'customers',
],
],다음 라우트는 customers 프로바이더를 사용하는 api-customers 가드로 요청을 인증합니다.
Route::get('/customer', function () {
// ...
})->middleware('auth:api-customers');NOTE
여러 사용자 프로바이더에 관한 자세한 내용은 개인 액세스 토큰 문서와 비밀번호 그랜트 문서를 참고하세요.
액세스 토큰 전달
Passport가 보호하는 라우트를 호출하는 API 클라이언트는 요청의 Authorization 헤더에 Bearer 토큰으로 액세스 토큰을 지정해야 합니다. Http 파사드에서는 다음과 같이 사용합니다.
use Illuminate\Support\Facades\Http;
$response = Http::withHeaders([
'Accept' => 'application/json',
'Authorization' => "Bearer $accessToken",
])->get('https://passport-app.test/api/user');
return $response->json();토큰 스코프
스코프를 사용하면 API 클라이언트가 계정 접근을 인가받을 때 특정 권한 묶음만 요청할 수 있습니다. 예를 들어 전자상거래 애플리케이션의 모든 API 클라이언트에 주문 생성 권한이 필요한 것은 아닙니다. 주문 배송 상태 조회 권한만 요청하도록 할 수 있습니다. 즉, 사용자가 외부 애플리케이션이 자신을 대신해 수행할 수 있는 작업을 제한할 수 있습니다.
스코프 정의
App\Providers\AppServiceProvider의 boot 메서드에서 Passport::tokensCan으로 API 스코프를 정의할 수 있습니다. 스코프 이름과 설명으로 구성된 배열을 받으며, 설명은 원하는 내용으로 작성할 수 있고 사용자 인가 승인 화면에 표시됩니다.
/**
* Bootstrap any application services.
*/
public function boot(): void
{
Passport::tokensCan([
'user:read' => 'Retrieve the user info',
'orders:create' => 'Place orders',
'orders:read:status' => 'Check order status',
]);
}기본 스코프
클라이언트가 특정 스코프를 요청하지 않았을 때 defaultScopes 메서드로 기본 스코프를 토큰에 할당하도록 설정할 수 있습니다. 일반적으로 App\Providers\AppServiceProvider의 boot 메서드에서 호출합니다.
use Laravel\Passport\Passport;
Passport::tokensCan([
'user:read' => 'Retrieve the user info',
'orders:create' => 'Place orders',
'orders:read:status' => 'Check order status',
]);
Passport::defaultScopes([
'user:read',
'orders:create',
]);토큰에 스코프 할당
인가 코드 요청 시
인가 코드 그랜트로 액세스 토큰을 요청할 때 클라이언트는 원하는 스코프를 쿼리 매개변수 scope에 지정해야 합니다. 여러 스코프는 공백으로 구분합니다.
Route::get('/redirect', function () {
$query = http_build_query([
'client_id' => 'your-client-id',
'redirect_uri' => 'https://third-party-app.com/callback',
'response_type' => 'code',
'scope' => 'user:read orders:create',
]);
return redirect('https://passport-app.test/oauth/authorize?'.$query);
});개인 액세스 토큰 발급 시
App\Models\User 모델의 createToken으로 개인 액세스 토큰을 발급한다면 두 번째 인수로 원하는 스코프 배열을 전달합니다.
$token = $user->createToken('My Token', ['orders:create'])->accessToken;스코프 확인
Passport는 들어오는 요청의 인증 토큰에 지정된 스코프가 있는지 검증하는 미들웨어 두 가지를 제공합니다.
모든 스코프 확인
Laravel\Passport\Http\Middleware\CheckToken을 라우트에 지정하면 액세스 토큰에 나열한 모든 스코프가 있는지 검증합니다.
use Laravel\Passport\Http\Middleware\CheckToken;
Route::get('/orders', function () {
// Access token has both "orders:read" and "orders:create" scopes...
})->middleware(['auth:api', CheckToken::using('orders:read', 'orders:create')]);하나 이상의 스코프 확인
Laravel\Passport\Http\Middleware\CheckTokenForAnyScope를 지정하면 나열한 스코프 중 최소 하나가 있는지 검증합니다.
use Laravel\Passport\Http\Middleware\CheckTokenForAnyScope;
Route::get('/orders', function () {
// Access token has either "orders:read" or "orders:create" scope...
})->middleware(['auth:api', CheckTokenForAnyScope::using('orders:read', 'orders:create')]);스코프 속성
컨트롤러 미들웨어 속성을 사용한다면 Laravel\Passport\Attributes\AuthorizeToken 속성으로 Passport 스코프 미들웨어를 간편하게 지정할 수 있습니다.
<?php
namespace App\Http\Controllers;
use Laravel\Passport\Attributes\AuthorizeToken;
#[AuthorizeToken('orders:read')]
#[AuthorizeToken('orders:create', only: ['store'])]
class OrderController
{
#[AuthorizeToken(['orders:read', 'orders:create'], anyScope: true)]
public function index()
{
// Access token has either "orders:read" or "orders:create" scope...
}
public function store()
{
// Access token has both "orders:read" and "orders:create" scopes...
}
}AuthorizeToken은 기본적으로 지정한 모든 스코프를 요구합니다. anyScope: true를 전달하면 토큰에 지정한 스코프 중 하나 이상이 있을 때 요청을 허용합니다.
토큰 인스턴스에서 스코프 확인
액세스 토큰으로 인증된 요청이 애플리케이션에 들어온 뒤에도 인증된 App\Models\User 인스턴스의 tokenCan으로 특정 스코프를 확인할 수 있습니다.
use Illuminate\Http\Request;
Route::get('/orders', function (Request $request) {
if ($request->user()->tokenCan('orders:create')) {
// ...
}
});추가 스코프 메서드
scopeIds는 정의된 모든 ID와 이름의 배열을 반환합니다.
use Laravel\Passport\Passport;
Passport::scopeIds();scopes는 정의된 모든 스코프를 Laravel\Passport\Scope 인스턴스 배열로 반환합니다.
Passport::scopes();scopesFor는 지정한 ID 또는 이름에 해당하는 Laravel\Passport\Scope 인스턴스 배열을 반환합니다.
Passport::scopesFor(['user:read', 'orders:create']);hasScope로 특정 스코프의 정의 여부를 확인할 수 있습니다.
Passport::hasScope('orders:create');SPA 인증
API를 개발할 때 자체 JavaScript 애플리케이션에서도 같은 API를 사용하면 유용합니다. 웹 애플리케이션, 모바일 앱, 외부 애플리케이션, 여러 패키지 관리자에 배포한 SDK가 동일한 API를 사용하도록 구성할 수 있습니다.
일반적으로 JavaScript 애플리케이션에 액세스 토큰을 직접 전달하고 각 요청에 포함해야 하지만, Passport에는 이를 처리하는 미들웨어가 있습니다. bootstrap/app.php에서 web 미들웨어 그룹 마지막에 CreateFreshApiToken을 추가하면 됩니다.
use Laravel\Passport\Http\Middleware\CreateFreshApiToken;
->withMiddleware(function (Middleware $middleware): void {
$middleware->web(append: [
CreateFreshApiToken::class,
]);
})WARNING
CreateFreshApiToken이 미들웨어 스택의 마지막에 위치하도록 해야 합니다.
이 미들웨어는 응답에 laravel_token 쿠키를 추가합니다. 쿠키에는 Passport가 JavaScript 애플리케이션의 API 요청을 인증하는 데 사용하는 암호화된 JWT가 담깁니다. JWT 유효 기간은 session.lifetime 설정과 같습니다. 이후 브라우저가 요청마다 쿠키를 자동 전송하므로 액세스 토큰을 명시적으로 전달하지 않고 API를 호출할 수 있습니다.
axios.get('/api/user')
.then(response => {
console.log(response.data);
});쿠키 이름 커스터마이징
필요하면 Passport::cookie로 laravel_token 쿠키 이름을 변경할 수 있습니다. 일반적으로 App\Providers\AppServiceProvider의 boot 메서드에서 호출합니다.
/**
* Bootstrap any application services.
*/
public function boot(): void
{
Passport::cookie('custom_name');
}CSRF 보호
이 인증 방식을 사용할 때는 요청에 유효한 CSRF 토큰 헤더가 포함되어야 합니다. 기본 애플리케이션과 모든 스타터 키트의 Laravel JavaScript 스캐폴딩에는 Axios 인스턴스가 포함되어 있습니다. 동일 출처 요청에서 암호화된 XSRF-TOKEN 쿠키 값을 자동으로 X-XSRF-TOKEN 헤더에 담아 보냅니다.
NOTE
X-XSRF-TOKEN 대신 X-CSRF-TOKEN 헤더를 보낸다면 csrf_token()이 제공하는 암호화되지 않은 토큰을 사용해야 합니다.
이벤트
Passport는 액세스 토큰과 리프레시 토큰을 발급할 때 이벤트를 발생시킵니다. 이벤트를 수신하여 데이터베이스의 다른 액세스 토큰을 정리하거나 폐기할 수 있습니다.
| 이벤트 이름 |
|---|
Laravel\Passport\Events\AccessTokenCreated |
Laravel\Passport\Events\AccessTokenRevoked |
Laravel\Passport\Events\RefreshTokenCreated |
테스트
Passport의 actingAs 메서드로 현재 인증된 사용자와 스코프를 지정할 수 있습니다. 첫 번째 인수는 사용자 인스턴스이고 두 번째 인수는 해당 사용자 토큰에 부여할 스코프 배열입니다.
Pest
use App\Models\User;
use Laravel\Passport\Passport;
test('orders can be created', function () {
Passport::actingAs(
User::factory()->create(),
['orders:create']
);
$response = $this->post('/api/orders');
$response->assertStatus(201);
});PHPUnit
use App\Models\User;
use Laravel\Passport\Passport;
public function test_orders_can_be_created(): void
{
Passport::actingAs(
User::factory()->create(),
['orders:create']
);
$response = $this->post('/api/orders');
$response->assertStatus(201);
}actingAsClient 메서드로 현재 인증된 클라이언트와 스코프를 지정할 수도 있습니다. 첫 번째 인수는 클라이언트 인스턴스이고 두 번째 인수는 클라이언트 토큰에 부여할 스코프 배열입니다.
Pest
use Laravel\Passport\Client;
use Laravel\Passport\Passport;
test('servers can be retrieved', function () {
Passport::actingAsClient(
Client::factory()->create(),
['servers:read']
);
$response = $this->get('/api/servers');
$response->assertStatus(200);
});PHPUnit
use Laravel\Passport\Client;
use Laravel\Passport\Passport;
public function test_servers_can_be_retrieved(): void
{
Passport::actingAsClient(
Client::factory()->create(),
['servers:read']
);
$response = $this->get('/api/servers');
$response->assertStatus(200);
}