PHPackages offline/laravel-csp - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Security](/categories/security) 4. / 5. offline/laravel-csp ActiveLibrary[Security](/categories/security) offline/laravel-csp =================== Add CSP headers to the responses of a Laravel app (Fork) v4.0.0(4y ago)15.3k21MITPHPPHP >=7.1 Since Feb 17Pushed 3y agoCompare [ Source](https://github.com/OFFLINE-GmbH/laravel-csp)[ Packagist](https://packagist.org/packages/offline/laravel-csp)[ Docs](https://github.com/OFFLINE-GmbH/laravel-csp)[ RSS](/packages/offline-laravel-csp/feed)WikiDiscussions master Synced today READMEChangelog (1)Dependencies (1)Versions (40)Used By (1) Set content security policy headers in a Laravel app ==================================================== [](#set-content-security-policy-headers-in-a-laravel-app) [![Latest Version on Packagist](https://camo.githubusercontent.com/24c1214b93810700d885a8c383bda0718a488aa6078128f7dd4c050d7cf2e65a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f4f46464c494e452f6c61726176656c2d6373702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/OFFLINE/laravel-csp)[![GitHub Workflow Status](https://camo.githubusercontent.com/efd8edfd085f29363b2e7066436407b83f99783dea649cc11befa1cc4e254533/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f4f46464c494e452f6c61726176656c2d6373702f72756e2d74657374733f6c6162656c3d7465737473)](https://camo.githubusercontent.com/efd8edfd085f29363b2e7066436407b83f99783dea649cc11befa1cc4e254533/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f4f46464c494e452f6c61726176656c2d6373702f72756e2d74657374733f6c6162656c3d7465737473)[![StyleCI](https://camo.githubusercontent.com/5f7670a6a27f58bc3e1da7a95b7ed38f193554661496e35c1988e941dcddc3ce/68747470733a2f2f7374796c6563692e696f2f7265706f732f3131393935383236342f736869656c643f6272616e63683d6d6173746572)](https://styleci.io/repos/119958264)[![Quality Score](https://camo.githubusercontent.com/b7578f58b00f7d656923e83af6edebe45b38bc1511a3d9163147f0cb648dfd0c/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f4f46464c494e452f6c61726176656c2d6373702e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/OFFLINE/laravel-csp)[![Total Downloads](https://camo.githubusercontent.com/37f609c66ccb022877d25283e4e999b031c515825d75b5fb5cc684e0513a4c89/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f4f46464c494e452f6c61726176656c2d6373702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/OFFLINE/laravel-csp) By default all scripts on a webpage are allowed to send and fetch data to any site they want. This can be a security problem. Imagine one of your JavaScript dependencies sends all keystrokes, including passwords, to a third party website. It's very easy for someone to hide this malicious behaviour, making it nearly impossible for you to detect it (unless you manually read all the JavaScript code on your site). For a better idea of why you really need to set content security policy headers read [this excellent blog post](https://hackernoon.com/im-harvesting-credit-card-numbers-and-passwords-from-your-site-here-s-how-9a8cb347c5b5) by [David Gilbertson](https://twitter.com/D__Gilbertson). Setting Content Security Policy headers helps solve this problem. These headers dictate which sites your site is allowed to contact. This package makes it easy for you to set the right headers. This readme does not aim to fully explain all the possible usages of CSP and it's directives. We highly recommend that you read [Mozilla's documentation on the Content Security Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP)) before using this package. If you're an audio visual learner you should check out this video on how to use this package. Support us ---------- [](#support-us) We invest a lot of resources into creating [best in class open source packages](https://OFFLINE.be/open-source). You can support us by [buying one of our paid products](https://OFFLINE.be/open-source/support-us). We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on [our contact page](https://OFFLINE.be/about-us). We publish all received postcards on [our virtual postcard wall](https://OFFLINE.be/open-source/postcards). Installation ------------ [](#installation) You can install the package via composer: ``` composer require OFFLINE/laravel-csp ``` You can publish the config-file with: ``` php artisan vendor:publish --provider="OFFLINE\LaravelCSP\CspServiceProvider" --tag="config" ``` This is the contents of the file which will be published at `config/csp.php`: ``` return [ /* * A policy will determine which CSP headers will be set. A valid CSP policy is * any class that extends `OFFLINE\LaravelCSP\Policies\Policy` */ 'policy' => OFFLINE\LaravelCSP\Policies\Basic::class, /* * This policy which will be put in report only mode. This is great for testing out * a new policy or changes to existing csp policy without breaking anything. */ 'report_only_policy' => '', /* * All violations against the policy will be reported to this url. * A great service you could use for this is https://report-uri.com/ * * You can override this setting by calling `reportTo` on your policy. */ 'report_uri' => env('CSP_REPORT_URI', ''), /* * Headers will only be added if this setting is set to true. */ 'enabled' => env('CSP_ENABLED', true), /* * The class responsible for generating the nonces used in inline tags and headers. */ 'nonce_generator' => OFFLINE\LaravelCSP\Nonce\RandomString::class, ]; ``` You can add CSP headers to all responses of your app by registering `OFFLINE\LaravelCSP\AddCspHeaders::class` in the http kernel. ``` // app/Http/Kernel.php ... protected $middlewareGroups = [ 'web' => [ ... \OFFLINE\LaravelCSP\AddCspHeaders::class, ], ``` Alternatively you can apply the middleware on the route or route group level. ``` // in a routes file Route::get('my-page', 'MyController')->middleware(OFFLINE\LaravelCSP\AddCspHeaders::class); ``` You can also pass a policy class as a parameter to the middleware: ``` // in a routes file Route::get('my-page', 'MyController')->middleware(OFFLINE\LaravelCSP\AddCspHeaders::class . ':' . MyPolicy::class); ``` The given policy will override the one configured in the config file for that specific route or group of routes. Usage ----- [](#usage) This package allows you to define CSP policies. A CSP policy determines which CSP directives will be set in the headers of the response. An example of a CSP directive is `script-src`. If this has the value `'self' www.google.com` then your site can only load scripts from it's own domain or `www.google.com`. You'll find [a list with all CSP directives](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/#Directives) at Mozilla's excellent developer site. According to the spec certain directive values need to be surrounded by quotes. Examples of this are `'self'`, `'none'` and `'unsafe-inline'`. When using `addDirective` function you're not required to surround the directive value with quotes manually. We will automatically add quotes. Script/style hashes, as well, will be auto-detected and surrounded with quotes. ``` // in a policy ... ->addDirective(Directive::SCRIPT, Keyword::SELF) // will output `'self'` when outputting headers ->addDirective(Directive::STYLE, 'sha256-hash') // will output `'sha256-hash'` when outputting headers ... ``` You can add multiple policy options in the same directive giving an array as second parameter to `addDirective` or a single string in which every option is separated by one or more spaces. ``` // in a policy ... ->addDirective(Directive::SCRIPT, [ Keyword::STRICT_DYNAMIC, Keyword::SELF, 'www.google.com', ]) ->addDirective(Directive::SCRIPT, 'strict-dynamic self www.google.com') // will both output `'strict_dynamic' 'self' www.google.com` when outputting headers ... ``` There are also a few cases where you don't have to or don't need to specify a value, eg. upgrade-insecure-requests, block-all-mixed-content, ... In this case you can use the following value: ``` // in a policy ... ->addDirective(Directive::UPGRADE_INSECURE_REQUESTS, Value::NO_VALUE) ->addDirective(Directive::BLOCK_ALL_MIXED_CONTENT, Value::NO_VALUE); ... ``` This will output a CSP like this: ``` Content-Security-Policy: upgrade-insecure-requests;block-all-mixed-content ``` ### Creating policies [](#creating-policies) In the `policy` key of the `csp` config file is set to `\OFFLINE\LaravelCSP\Policies\Basic::class` by default. This class allows your site to only use images, scripts, form actions of your own site. This is how the class looks like. ``` namespace OFFLINE\LaravelCSP\Policies; use OFFLINE\LaravelCSP\Directive; use OFFLINE\LaravelCSP\Value; class Basic extends Policy { public function configure() { $this ->addDirective(Directive::BASE, Keyword::SELF) ->addDirective(Directive::CONNECT, Keyword::SELF) ->addDirective(Directive::DEFAULT, Keyword::SELF) ->addDirective(Directive::FORM_ACTION, Keyword::SELF) ->addDirective(Directive::IMG, Keyword::SELF) ->addDirective(Directive::MEDIA, Keyword::SELF) ->addDirective(Directive::OBJECT, Keyword::NONE) ->addDirective(Directive::SCRIPT, Keyword::SELF) ->addDirective(Directive::STYLE, Keyword::SELF) ->addNonceForDirective(Directive::SCRIPT) ->addNonceForDirective(Directive::STYLE); } } ``` You can allow fetching scripts from `www.google.com` by extending this class: ``` namespace App\Services\Csp\Policies; use OFFLINE\LaravelCSP\Directive; use OFFLINE\LaravelCSP\Policies\Basic; class MyCustomPolicy extends Basic { public function configure() { parent::configure(); $this->addDirective(Directive::SCRIPT, 'www.google.com'); } } ``` Don't forget to set the `policy` key in the `csp` config file to the class name of your policy (in this case it would be `App\Services\Csp\Policies\MyCustomPolicy`). ### Using inline scripts and styles [](#using-inline-scripts-and-styles) When using CSP you must specifically allow the use of inline scripts or styles. The recommended way of doing that with this package is to use a `nonce`. A nonce is a number that is unique per request. The nonce must be specified in the CSP headers and in an attribute on the html tag. This way an attacker has no way of injecting malicious scripts or styles. First you must add the nonce to the right directives in your policy: ``` // in a policy public function configure() { $this ->addDirective(Directive::SCRIPT, 'self') ->addDirective(Directive::STYLE, 'self') ->addNonceForDirective(Directive::SCRIPT) ->addNonceForDirective(Directive::STYLE) ... } ``` Next you must add the nonce to the html: ``` {{-- in a view --}} ... ... ``` There are few other options to use inline styles and scripts. Take a look at the [CSP docs on the Mozilla developer site](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/script-src) to know more. ### Reporting CSP errors [](#reporting-csp-errors) #### In the browser [](#in-the-browser) Instead of outright blocking all violations you can put a policy in report only mode. In this case all requests will be made, but all violations will display in your favourite browser's console. To put a policy in report only mode just call `reportOnly()` in the `configure()` function of a report: ``` public function configure() { parent::configure(); $this->reportOnly(); } ``` #### To an external url [](#to-an-external-url) Any violations against to the policy can be reported to a given url. You can set that url in the `report_uri` key of the `csp` config file. A great service that is specifically built for handling these violation reports is . #### Using multiple policies [](#using-multiple-policies) To test changes to your CSP policy you can specify a second policy in the `report_only_policy` in the `csp` config key. The policy specified in `policy` will be enforced, the one in `report_only_policy` will not. This is great for testing a new policy or changes to existing CSP policy without breaking anything. ### Using whoops [](#using-whoops) Laravel comes with [whoops](https://github.com/filp/whoops), an error handling framework that helps you debug your application with a pretty visualization of exceptions. Whoops uses inline scripts and styles because it can't make any assumptions about the environment it is being used in, so it won't work unless you allow `unsafe-inline` for scripts and styles. One approach to this problem is to check `config('app.debug')` when setting your policy. Unfortunately this bears the risk of forgetting to test your code with all CSP rules enabled and having your app break at deployment. Alternatively, you could allow `unsafe-inline` only on error pages by adding this to the `render` method of your exception handler (usually in `app/Exceptions/Handler.php`): ``` $this->container->singleton(AppPolicy::class, function ($app) { return new AppPolicy(); }); app(AppPolicy::class)->addDirective(Directive::SCRIPT, Keyword::UNSAFE_INLINE); app(AppPolicy::class)->addDirective(Directive::STYLE, Keyword::UNSAFE_INLINE); ``` where `AppPolicy` is the name of your CSP policy. This also works in every other situation to change the policy at runtime, in which case the singleton registration should be done in a service provider instead of the exception handler. Note that `unsafe-inline` only works if you're not also sending a nonce or a `strict-dynamic` directive, so to be able to use this workaround, you have to specify all your inline scripts' and styles' hashes in the CSP header. ### Testing [](#testing) You can run all the tests with: ``` composer test ``` ### Changelog [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. ### Security [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Freek Van der Herten](https://github.com/freekmurze) - [Thomas Verhelst](https://github.com/TVke) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 37 — LowBetter than 81% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity24 Limited adoption so far Community22 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 58.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~40 days Recently: every ~179 days Total 39 Last Release 1521d ago Major Versions 0.0.6 → 1.0.02018-02-20 v1.x-dev → 2.0.02018-11-05 2.5.1 → v3.0.02020-05-17 v3.0.4 → v4.0.02022-05-04 PHP version history (4 changes)0.0.1PHP ^7.1 1.0.5PHP ^7.0 2.2.0PHP ^7.2 v3.0.0PHP >=7.1 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/8600029?v=4)[Tobias Kündig](/maintainers/tobias-kuendig)[@tobias-kuendig](https://github.com/tobias-kuendig) --- Top Contributors [![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (74 commits)")[![TVke](https://avatars.githubusercontent.com/u/15680337?v=4)](https://github.com/TVke "TVke (11 commits)")[![tobias-kuendig](https://avatars.githubusercontent.com/u/8600029?v=4)](https://github.com/tobias-kuendig "tobias-kuendig (10 commits)")[![moebrowne](https://avatars.githubusercontent.com/u/8448512?v=4)](https://github.com/moebrowne "moebrowne (9 commits)")[![Gummibeer](https://avatars.githubusercontent.com/u/6187884?v=4)](https://github.com/Gummibeer "Gummibeer (4 commits)")[![nathan818fr](https://avatars.githubusercontent.com/u/10061173?v=4)](https://github.com/nathan818fr "nathan818fr (2 commits)")[![IlCallo](https://avatars.githubusercontent.com/u/10036108?v=4)](https://github.com/IlCallo "IlCallo (2 commits)")[![jpmaga](https://avatars.githubusercontent.com/u/31849900?v=4)](https://github.com/jpmaga "jpmaga (1 commits)")[![Lloople](https://avatars.githubusercontent.com/u/5665466?v=4)](https://github.com/Lloople "Lloople (1 commits)")[![matthewsuan](https://avatars.githubusercontent.com/u/3340447?v=4)](https://github.com/matthewsuan "matthewsuan (1 commits)")[![MaxGiting](https://avatars.githubusercontent.com/u/9828591?v=4)](https://github.com/MaxGiting "MaxGiting (1 commits)")[![olafnorge](https://avatars.githubusercontent.com/u/1435932?v=4)](https://github.com/olafnorge "olafnorge (1 commits)")[![swapnilsarwe](https://avatars.githubusercontent.com/u/166912?v=4)](https://github.com/swapnilsarwe "swapnilsarwe (1 commits)")[![tomhatzer](https://avatars.githubusercontent.com/u/3952168?v=4)](https://github.com/tomhatzer "tomhatzer (1 commits)")[![blueclock](https://avatars.githubusercontent.com/u/586174?v=4)](https://github.com/blueclock "blueclock (1 commits)")[![vanbrabantf](https://avatars.githubusercontent.com/u/12281411?v=4)](https://github.com/vanbrabantf "vanbrabantf (1 commits)")[![brendt](https://avatars.githubusercontent.com/u/6905297?v=4)](https://github.com/brendt "brendt (1 commits)")[![djallits](https://avatars.githubusercontent.com/u/10674226?v=4)](https://github.com/djallits "djallits (1 commits)")[![Elhebert](https://avatars.githubusercontent.com/u/3165079?v=4)](https://github.com/Elhebert "Elhebert (1 commits)")[![gbuckingham89](https://avatars.githubusercontent.com/u/1455253?v=4)](https://github.com/gbuckingham89 "gbuckingham89 (1 commits)") --- Tags spatielaravelsecurityheaderscspcontent-security-policylaravel-csp ### Embed Badge ![Health badge](/badges/offline-laravel-csp/health.svg) ``` [![Health](https://phpackages.com/badges/offline-laravel-csp/health.svg)](https://phpackages.com/packages/offline-laravel-csp) ``` ### Alternatives [spatie/laravel-csp Add CSP headers to the responses of a Laravel app 86611.1M25](/packages/spatie-laravel-csp)[dgtlss/warden A Laravel package that proactively monitors your dependencies for security vulnerabilities by running automated composer audits and sending notifications via webhooks and email 9062.1k](/packages/dgtlss-warden)[mazedlx/laravel-feature-policy Add Feature-Policy headers to the responses of a Laravel app 17200.7k](/packages/mazedlx-laravel-feature-policy)[laravel-chronicle/core Tamper-evident audit ledger for Laravel applications. 1213.1k3](/packages/laravel-chronicle-core) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)