Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/GaProgMan/OwaspHeaders.Core
Inject OWASP recommended HTTP Headers for increased security in a single line
https://github.com/GaProgMan/OwaspHeaders.Core
aspnetcore http-header middleware nuget owasp security
Last synced: 18 days ago
JSON representation
Inject OWASP recommended HTTP Headers for increased security in a single line
- Host: GitHub
- URL: https://github.com/GaProgMan/OwaspHeaders.Core
- Owner: GaProgMan
- License: mit
- Created: 2017-06-06T23:06:42.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2024-10-19T22:45:31.000Z (25 days ago)
- Last Synced: 2024-10-20T07:17:17.657Z (25 days ago)
- Topics: aspnetcore, http-header, middleware, nuget, owasp, security
- Language: C#
- Homepage: https://www.nuget.org/packages/OwaspHeaders.Core/
- Size: 623 KB
- Stars: 278
- Watchers: 12
- Forks: 35
- Open Issues: 7
-
Metadata Files:
- Readme: README-NuGet.md
- Changelog: changelog.md
- License: LICENSE.txt
- Code of conduct: Code-of-Conduct.md
Awesome Lists containing this project
README
# OwaspHeaders.Core
An ASP .NET Core middleware for injection [OWASP](https://www.owasp.org/index.php/Main_Page) recommended HTTP Headers for increased security. This project is designed against the [OWASP Secure Headers Project](https://owasp.org/www-project-secure-headers/).
## Quick Starts
1. Create a .NET (either Framework, Core, or 5+) project which uses ASP .NET Core
Example;
```bash
dotnet new webapi -n exampleProject
```2. Add a reference to the OwaspHeaders.Core NuGet package.
Example:
```bash
dotnet add package OwaspHeaders.Core
```3. Alter the Startup (pre .NET 6) or program (post .NET 6) class to include the following:
```csharp
app.UseSecureHeadersMiddleware();
```This will add a number of default HTTP headers to all responses from your server component.
The following is an example of the response headers from version 6.0.2 (taken on May 15th, 2023)
``` plaintext
cache-control: max-age=31536000, private
strict-transport-security: max-age=63072000;includeSubDomains
x-frame-options: DENY
x-xss-protection: 0
x-content-type-options: nosniff
content-security-policy: script-src 'self';object-src 'self';block-all-mixed-content;upgrade-insecure-requests;
x-permitted-cross-domain-policies: none;
referrer-policy: no-referrer
```Please note: The above example contains only the headers added by the Middleware.
## Source Code Repo
The source code for this NuGet package can be found at: [https://github.com/GaProgMan/OwaspHeaders.Core](https://github.com/GaProgMan/OwaspHeaders.Core).
## Issues and Bugs
Please raise any issues and bugs at the above mentioned source code repo.
## Server Header: A Warning
The default configuration for this middleware removes the `X-Powered-By` header, as this can help malicious users to use targeted attacks for specific server infrastructure. However, since the `Server` header is added by the reverse proxy used when hosting an ASP .NET Core application, removing this header is out of scope for this middleware.
In order to remove this header, a `web.config` file is required, and the following should be added to it:
```xml
```
The above XML is taken from [this answer on ServerFault](https://serverfault.com/a/1020784).
The `web.config` file will need to be copied to the server when the application is deployed.