권한 승인

시작하기

별다른 설정없이도 인증 기능을 제공하는 것에 더하여, 라라벨은 간단한 방법으로 주어진 리소스에 대한 사용자 액션의 권한을 승인하는 방법을 제공합니다. 사용자 인증과 같이 권한 승인에 대한 라라벨의 접근 방식은 간단하며, 액션에 대한 승인을 위한 두가지 기본 방법이 있습니다: Gate 와 Policy 입니다.

gate 와 policy은 라우트와 컨트롤러와 같다고 생각됩니다. gate는 간단한, 클로저 기반의 권한 승인에 대한 접근방식을 제공하고, 컨트롤러와 같은 역할을 하는 policy는 특정 모델이나 리소스에 대한 로직을 정리 한 것입니다. 먼저 gate를 설명하고, policy에 대해서 확인해보겠습니다.

gate와 policy는 애플리케이션에서 서로 반대되는 기능이라고 보지 않는 것이 중요합니다. 대부분의 애플리케이션에서 gate와 policy를 혼합하여 사용되며, 이것은 아무런 문제가 없습니다. 관리자 대시보드와 같이 모델과 리소스에 관련되지 않은 작업들이 주로 gate에 정합합니다. 이에 반해, policy는 특정 모델이나 리소스에 대한 작업을 승인하고자 하는 경우 사용해야합니다.

Gate

Gates 작성하기

Gate는 사용자가 주어진 액션에 대해서 수행할 수 있는 권한이 있는지 없는지 확인하는 클로저로, 일반적으로 App\Providers\AuthServiceProvider 클래스에 Gate 파사드를 사용하여 정의되어 있습니다. Gate는 항상 사용자 인스턴스를 첫번째 인자로 받고, 관련된 Eloquent 모델과 같은 추가적인 인자들을 선택적으로 전달 받습니다:

/**
 * Register any authentication / authorization services.
 *
 * @return void
 */
public function boot()
{
    $this->registerPolicies();

    Gate::define('update-post', function ($user, $post) {
        return $user->id == $post->user_id;
    });
}

Gate는 또한 컨트롤러와 같이 Class@method 스타일의 콜백 문자열으로도 정의할 수 있습니다:

/**
 * Register any authentication / authorization services.
 *
 * @return void
 */
public function boot()
{
    $this->registerPolicies();

    Gate::define('update-post', 'PostPolicy@update');
}

리소스 Gate

resource 메소드를 사용하여 여러개의 Gate 액션을 정의할 수도 있습니다:

Gate::resource('posts', 'PostPolicy');

이렇게 정의하면 직접 다음의 Gate 정의 한것과 동일하게 적용됩니다:

Gate::define('posts.view', 'PostPolicy@view');
Gate::define('posts.create', 'PostPolicy@create');
Gate::define('posts.update', 'PostPolicy@update');
Gate::define('posts.delete', 'PostPolicy@delete');

기본적으로 view, create, update 그리고 delete 이 정의됩니다. resource 메소드에 세번째 인자로 배열을 전달하여 기본 속성들을 재정의할 수 있습니다. 배열의 키는 Gate 엑션의 이름을, 값은 메소드를 정의합니다:

Gate::resource('posts', 'PostPolicy', [
    'photo' => 'updatePhoto',
    'image' => 'updateImage',
]);

액션 권한 승인하기

gate를 사용하여 액션에 대한 권한을 승인하려면, allows 메소드를 사용해야 합니다. 현재 인증된 사용자를 allow 메소드에 전달할 필요는 없습니다. 라라벨이 자동으로 Gate 클로저에 사용자를 전달합니다:

if (Gate::allows('update-post', $post)) {
    // The current user can update the post...
}

특정 사용자가 액션을 수행 할 수 있는 권한이 있는지 확인하려는 경우, Gate 파사드의 forUser 메소드를 사용할 수 있습니다:

if (Gate::forUser($user)->allows('update-post', $post)) {
    // The user can update the post...
}

Policy 생성하기

Policies 파일 생성하기

Policy는 특정 모델 또는 리소스에 대한 권한 승인 로직을 구성한 클래스 입니다. 예를 들어 블로그 애플리케이션의 경우, Post 모델과 해당 포스트를 생성하거나 수정할 수 있는 액션을 허용하는 PostPolicy가 있을 수 있습니다.

make:policy 아티즌 명령어를 사용하여 policy 클래스를 생성할 수 있습니다. 생성된 policy는 app/Policies 디렉토리에 있습니다. 만약 애플리케이션에서 이 디렉토리가 존재하지 않더라도, 라라벨이 디렉토리를 생성해줍니다:

php artisan make:policy PostPolicy

make:policy 명령어는 비어 있는 policy 클래스를 생성합니다. 기본적인 "CRUD"에 해당하는 policy 메소드를 새로 생성하는 클래스에 포함시키려면, 명령어를 실행할 때 --model을 지정하십시오.

php artisan make:policy PostPolicy --model=Post

{tip} 모든 policy는 라라벨의 서비스 컨테이너에 의해서 의존성이 해결되기 때문에, policy의 생성자에 필요한 의존성을 타입 힌트 하기만 하면, 자동으로 주입됩니다.

Policy 등록하기

policy를 생성하고 나면, 이를 등록해야 합니다. 새롭게 설치한 라라벨 애플리케이션에 포함되어 있는 AuthServiceProviderpolicies 속성은 Eloquent 모델과 해당 모델에 대한 policy의 맵핑 내역입니다. policy를 등록하면 라라벨은 특정 모델에 대한 액션을 승인 할 때 어떤 policy를 활용할 것인지 알려주게 됩니다:

<?php

namespace App\Providers;

use App\Post;
use App\Policies\PostPolicy;
use Illuminate\Support\Facades\Gate;
use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider;

class AuthServiceProvider extends ServiceProvider
{
    /**
     * The policy mappings for the application.
     *
     * @var array
     */
    protected $policies = [
        Post::class => PostPolicy::class,
    ];

    /**
     * Register any application authentication / authorization services.
     *
     * @return void
     */
    public function boot()
    {
        $this->registerPolicies();

        //
    }
}

Policy 작성하기

Policy 메소드

Policy를 등록하고 나면, 각각의 권한을 승인하려는 액션에 관련된 메소드를 추가해야합니다. 예를 들어, 주어진 UserPost 인스턴스를 수정할 수 있는지 확인하는 PostPolicy 클래스의 update 메소드를 정의해 보겠습니다.

update 메소드는 한개의 User 와 한개의 Post 인스턴스를 인자로 받고, 해당 사용자가 주어진 Post 를 수정할 수 있는 권한이 있는지에 대한 결과로 true 또는 false 를 반환해야합니다. 따라서 이 예제에서는 포스트의 user_id가 사용자의 id 와 일치하는지 확인하도록 해보겠습니다:

<?php

namespace App\Policies;

use App\User;
use App\Post;

class PostPolicy
{
    /**
     * Determine if the given post can be updated by the user.
     *
     * @param  \App\User  $user
     * @param  \App\Post  $post
     * @return bool
     */
    public function update(User $user, Post $post)
    {
        return $user->id === $post->user_id;
    }
}

계속해서 권한 승인이 필요한 다양한 액션에 대한 추가적인 메소드를 정의할 수 있습니다. 예를 들어 Post 에 대한 다양한 액션을 승인하기 위해서 viewdelete 메소드를 정의할 수도 있습니다. policy의 이름은 여러분이 원하는 대로 자유롭게 구성할 수 있습니다.

{tip} 만약 아티즌 명령어를 통해서 Policy 클래스를 생성할 때 --model 옵션을 사용하였다면, 이미 view, create, update 그리고 delete 액션에 해당하는 메소드가 포함되어 있습니다.

모델없는 메소드

어떤 Policy 메소드는 단지 권한 승인이 필요한 모델 인스턴스가 아닌, 현재 인승된 사용자만을 전달 받습니다. 이런 상황은 대부분, create 액션에 대한 권한을 승인하고자 할 때 일반적으로 나타납니다. 예를 들어 블로그를 만드는 경우, 사용자가 게시물을 생성할 수 있는 권한이 있는지 확인할 수 있습니다.

create 메소드와 같은 policy 메소드를 정의할 때는, 모델 인스턴스를 전달 받지 않습니다. 대신에, 인증된 사용자를 받는 메소드를 정의해야 합니다:

/**
 * Determine if the given user can create posts.
 *
 * @param  \App\User  $user
 * @return bool
 */
public function create(User $user)
{
    //
}

Policy 필터

특정 사용자를 위해서, 주어진 Policy 안에서 모든 액션에 대한 권한을 승인하고자 할 수 있습니다. 이렇게 하기 위해서는, policy에 before 메소드를 정의하면 됩니다. before 메소드는 policy에서 다른 메소드가 호출 되기 전에 실행되는 메소드로, 액션에 대한 권한을 승인할 수 있게 해줍니다. 이 기능은 애플리케이션의 관리자에게 모든 액션을 수행하도록 권한을 부여하는 데 가장 일반적으로 사용됩니다:

public function before($user, $ability)
{
    if ($user->isSuperAdmin()) {
        return true;
    }
}

특정 한 사용자에게 모든 권한을 허용하지 않으려면, before 메소드에서 false 를 반환해야 합니다. 만약 null이 반환되면, policy 메소드에 대한 권한 확인이 실패해버립니다.

Policy 를 사용하여 액션의 권한승인하기

User 모델을 통해서

라라벨 애플리케이션에 기본적으로 포함되어 있는 User 모델에는 cancant 액션에 대해 권한을 승인할 수 있는 두개의 헬퍼 메소드를 포함하고 있습니다. can 메소드는 권한을 승인하고자 하는 액션과 연관된 모델을 인자로 받습니다. 예를 들어 주어진 Post 모델을 수정할 수 있는 권한이 있는지 확인한다고 해보겠습니다:

if ($user->can('update', $post)) {
    //
}

만약 주어진 모델을 위한 Policy 가 등록되어있다면, can 메소드는 자동으로 적절한 policy를 호출하고 불리언(boolean: true or false)형태의 결과를 반환합니다. 모델을 위한 policy가 등록되지 않은 경우, can 메소드는 주어진 액션 이름과 매칭되는 클로저 기반의 Gate 호출을 시도합니다.

모델을 필요로 하지 않는 액션

create와 같은 몇몇 액션은 모델 인스턴스를 필요로 하지 않는 다는 것을 기억하십시오. 이러한 경우에는 can 메소드에 클래스 이름을 전달하면 됩니다. 클래스 이름은 액션을 승인할 때 어떤 policy가 사용될지 결정하는데 이용됩니다:

use App\Post;

if ($user->can('create', Post::class)) {
    // Executes the "create" method on the relevant policy...
}

미들웨어를 통해서

라라벨에는 유입되는 request가 라우트나 컨트롤러에 도달하기 전에 액션을 승인할 수 있는 미들웨어가 포함되어 있습니다. 기본적으로 App\Http\Kernel 클래스의 can 키에는 Illuminate\Auth\Middleware\Authorize 미들웨어가 할당되어 있습니다. 사용자가 블로그 포스트를 수정할 수 있는지 권한을 승인하는 can 미들웨어를 사용하는 예제를 살펴보겠습니다:

use App\Post;

Route::put('/post/{post}', function (Post $post) {
    // The current user may update the post...
})->middleware('can:update,post');

이 예제에서, can 미들웨어에 두개의 인자를 전달합니다. 첫번째는 승인하고자 하는 액션의 이름이고, 두번째는 policy 메소드에 전달하고자 하는 라우트 파라미터 입니다. 이 경우, 묵시적(implicit) 모델 바인딩을 사용하고 있기 때문에, 하나의 Post 모델이 policy 메소드에 전달됩니다. 만약 사용자가 주어진 액션을 수행할 권한이 없다면, 미들웨어에 의해서 403 상태코드를 가지는 HTTP response-응답이 생성됩니다.

모델을 필요로 하지 않는 액션

다시한번 이야기 하지만, create와 같은 몇몇 액션은 모델 인스턴스를 필요로 하지 않습니다. 이러한 경우 미들웨어에 클래스 이름을 전달하면 됩니다. 클래스 이름은 액션을 승인할 때 어떤 policy가 사용될지 결정하는데 이용됩니다:

Route::post('/post', function () {
    // The current user may create posts...
})->middleware('can:create,App\Post');

컨트롤러 헬퍼를 통해서

User 모델이 제공하는 편리함 메소드에 더하여, 라라벨에서는 App\Http\Controllers\Controller 베이스 클래스를 상속받는 컨트롤러가 사용할 수 있는 authorize 메소드를 제공합니다. can 메소드와 같이, 이 메소드는 승인하고자 하는 액션의 이름과, 관련된 모델을 인자로 받습니다. 만약 액션이 허용되지 않는 다면, authorize 메소드는 라라벨의 exception 핸들러에 의해서 403 상태코드를 가진 HTTP 응답-response로 변환되는 Illuminate\Auth\Access\AuthorizationException를 발생시킵니다:

<?php

namespace App\Http\Controllers;

use App\Post;
use Illuminate\Http\Request;
use App\Http\Controllers\Controller;

class PostController extends Controller
{
    /**
     * Update the given blog post.
     *
     * @param  Request  $request
     * @param  Post  $post
     * @return Response
     */
    public function update(Request $request, Post $post)
    {
        $this->authorize('update', $post);

        // The current user can update the blog post...
    }
}

모델을 필요로 하지 않는 액션

앞서 계속해서 이야기한 바와 같이, create와 같은 몇몇 액션은 모델 인스턴스를 필요로 하지 않습니다. 이러한 경우 authorize 메소드에 클래스 이름을 전달하면 됩니다. 클래스 이름은 액션을 승인할 때 어떤 policy가 사용될지 결정하는데 이용됩니다:

/**
 * Create a new blog post.
 *
 * @param  Request  $request
 * @return Response
 */
public function create(Request $request)
{
    $this->authorize('create', Post::class);

    // The current user can create blog posts...
}

블레이드 템플릿을 통해서

블레이드 템플릿을 작성할 때, 사용자가 주어진 액션을 수행 할 권한이 있는 경우에만 페이지를 일부를 보여주고자 할 수 있습니다. 예를 들어, 사용자가 실제로 블로그 포스트를 수정할 권한이 있는 경우에만 업데이트 버튼을 보여주고자 하는 경우가 그렇습니다. 이런 경우, @can@cannot 지시어를 사용할 수 있습니다.

@can('update', $post)
    <!-- The Current User Can Update The Post -->
@elsecan('create', $post)
    <!-- The Current User Can Create New Post -->
@endcan

@cannot('update', $post)
    <!-- The Current User Can't Update The Post -->
@elsecannot('create', $post)
    <!-- The Current User Can't Create New Post -->
@endcannot

이 지시어는 @if@unless 를 작성하는 편리한 단축키와 같습니다. @can and @cant 구문은 다음의 구문으로 변환됩니다:

@if (Auth::user()->can('update', $post))
    <!-- The Current User Can Update The Post -->
@endif

@unless (Auth::user()->can('update', $post))
    <!-- The Current User Can't Update The Post -->
@endunless

모델을 필요로 하지 않는 액션

다른 권한 인증 메소드 대부분과 같이, 액션이 모델을 필요로 하지 않는 경우 @can@cannot 지시어에 클래스 이름을 전달할 수 있습니다:

@can('create', App\Post::class)
    <!-- The Current User Can Create Posts -->
@endcan

@cannot('create', App\Post::class)
    <!-- The Current User Can't Create Posts -->
@endcannot