Laravel CSP 项目教程

Laravel CSP 项目教程

laravel-cspSet content security policy headers in a Laravel app项目地址:https://gitcode.com/gh_mirrors/la/laravel-csp

项目介绍

Laravel CSP 是一个用于在 Laravel 应用中设置内容安全策略（Content Security Policy, CSP）头部的开源项目。CSP 是一种安全机制，用于防止诸如跨站脚本（XSS）、路径遍历和 SQL 注入等攻击。通过使用 Laravel CSP，开发者可以控制哪些内容可以被加载到网页中，从而增强应用的安全性。

项目快速启动

安装

首先，通过 Composer 安装 spatie/laravel-csp 包：

composer require spatie/laravel-csp

配置

发布配置文件：

php artisan vendor:publish --tag=csp-config

设置默认策略

在 config/csp.php 文件中，可以设置默认的 CSP 策略：

return [
    'policy' => Spatie\Csp\Policies\Basic::class,
];

应用策略

在 app/Providers/AppServiceProvider.php 中注册 CSP 中间件：

use Spatie\Csp\AddCspHeaders;

public function boot()
{
    $this->app->make('router')->aliasMiddleware('csp', AddCspHeaders::class);
}

然后在 app/Http/Kernel.php 中应用中间件：

protected $middlewareGroups = [
    'web' => [
        // 其他中间件
        \App\Http\Middleware\CspMiddleware::class,
    ],
];

应用案例和最佳实践

自定义策略

创建一个自定义的 CSP 策略类：

namespace App\Csp\Policies;

use Spatie\Csp\Policies\Policy;

class MyCustomPolicy extends Policy
{
    public function configure()
    {
        $this->addDirective(Directive::SCRIPT, 'self');
        $this->addDirective(Directive::STYLE, 'self');
        // 其他自定义配置
    }
}

然后在 config/csp.php 中使用这个自定义策略：

return [
    'policy' => App\Csp\Policies\MyCustomPolicy::class,
];

使用 nonce

在 Laravel 中使用 Vite 生成 nonce：

namespace App\Support;

use Illuminate\Support\Str;
use Illuminate\Support\Facades\Vite;
use Spatie\Csp\Nonce\NonceGenerator;

class LaravelViteNonceGenerator implements NonceGenerator
{
    public function generate(): string
    {
        return Vite::useCspNonce();
    }
}

在 config/csp.php 中指定 nonce 生成器：

return [
    'nonce_generator' => App\Support\LaravelViteNonceGenerator::class,
];

典型生态项目

Laravel CSP 是 spatie 组织下的一个项目，该组织还提供了许多其他高质量的 Laravel 扩展包，如 laravel-medialibrary、laravel-backup 等。这些项目共同构成了一个丰富的 Laravel 生态系统，为开发者提供了全面的解决方案。

通过使用这些生态项目，开发者可以更高效地构建安全、可靠的 Laravel 应用。

laravel-cspSet content security policy headers in a Laravel app项目地址:https://gitcode.com/gh_mirrors/la/laravel-csp