Laravel Sentinel — 라우트 보호 미들웨어 조사

// 기존 방법 (TelescopeServiceProvider 등)
Gate::before(function ($user) {
    return $user->isAdmin() ? true : null;
});

composer require laravel/sentinel

// src/Drivers/Laravel.php
public function authorize(Request $request): bool
{
    if (! $this->app()->environment('local')) {
        return true; // local 이외에는 항상 허가
    }

    // 터널링 서비스 경유의 접근에 경고
    if ($this->isPrivateIp($request->ip())
        && ! $request->isFromTrustedProxy()
        && Str::endsWith($request->host(), ['.sharedwithexpose.com', '.ngrok-free.app', '.ngrok.io'])) {
        throw new RuntimeException(
            'Unable to access "..." using "local" environment, ...'
        );
    }

    // Docker 로컬 환경은 허가
    if ($this->isRunningOnDockerLocally($request)) {
        return true;
    }

    // 리버스 프록시 경유의 접근을 확인
    return $this->authorizeAccessingViaReverseProxies($request);
}

// src/Drivers/Driver.php
protected function isRunningOnDockerLocally(Request $request): bool
{
    return $request->server->get('REMOTE_ADDR') === '127.0.0.1'
        && file_exists(base_path('.dockerenv'));
}

use Laravel\Sentinel\Http\Middleware\SentinelMiddleware;

Route::middleware(SentinelMiddleware::class)->group(function () {
    Route::get('/telescope', function () { /* ... */ });
    Route::get('/horizon', function () { /* ... */ });
    Route::get('/pulse', function () { /* ... */ });
});

Route::middleware([SentinelMiddleware::class . ':custom-driver'])->group(function () {
    // 커스텀 드라이버로 인가
});

// src/Http/Middleware/SentinelMiddleware.php
public function handle(Request $request, Closure $next, ?string $driver = null)
{
    abort_unless(Sentinel::driverOrFallback($driver)->authorize($request), 401);

    return $next($request);
}

use Laravel\Sentinel\Sentinel;
use Laravel\Sentinel\Drivers\Driver;
use Illuminate\Http\Request;

Sentinel::extend('admin-only', function ($app) {
    return new class extends Driver {
        public function authorize(Request $request): bool
        {
            // 인증되어 있고 admin 롤을 가진 사용자만 허가
            $user = $request->user();

            return $user !== null && $user->hasRole('admin');
        }
    };
});

public function authorize(Request $request): bool
{
    // 프로덕션 환경에서는 프라이빗 IP에서만 허가
    if ($this->app()->environment('production')) {
        return $this->isPrivateIp($request->ip());
    }

    // 로컬에서는 Docker나 직접 접근만
    return $this->isRunningOnDockerLocally($request)
        || $this->authorizeAccessingViaReverseProxies($request);
}

// src/SentinelManager.php
class SentinelManager extends Manager
{
    protected function createLaravelDriver()
    {
        return new Laravel(fn () => $this->getContainer());
    }

    public function getDefaultDriver()
    {
        return 'laravel';
    }

    public function driverOrFallback(?string $driver)
    {
        return rescue(
            fn () => $this->driver($driver),
            value(fn () => $this->driver()),
            false  // 로그에 기록하지 않음
        );
    }
}

// src/SentinelServiceProvider.php
public function register(): void
{
    $this->app->scoped(SentinelManager::class, fn ($app) => new SentinelManager($app));
}