security
为 affolterNET.Web.Api 配置安全标头、CORS 和 IConfigurableOptions 模式。在设置 CSP、HSTS、CORS 策略或自定义选项时使用。
📖 中文导读:为 affolterNET.Web.Api 配置安全标头、CORS 和 IConfigurableOptions 模式。在设置 CSP、HSTS、CORS 策略或自定义选项时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: security description: Configure security headers, CORS, and the IConfigurableOptions pattern for affolterNET.Web.Api. Use when setting up CSP, HSTS, CORS policies, or custom options.
Security Configuration
Configure security headers, CORS, and the options pattern.
For complete reference, see Library Guide.
Security Headers
appsettings.json
{
"affolterNET": {
"Web": {
"SecurityHeaders": {
"EnableHsts": true,
"EnableXFrameOptions": true,
"EnableXContentTypeOptions": true,
"EnableReferrerPolicy": true,
"ContentSecurityPolicy": "default-src 'self'"
}
}
}
}
Program.cs
var options = builder.Services.AddApiServices(isDev, config, opts => {
opts.EnableSecurityHeaders = true;
});
CORS Configuration
appsettings.json
{
"affolterNET": {
"Web": {
"Cors": {
"AllowedOrigins": ["https://app.example.com", "https://admin.example.com"],
"AllowedMethods": ["GET", "POST", "PUT", "DELETE"],
"AllowedHeaders": ["Content-Type", "Authorization"],
"AllowCredentials": true,
"MaxAge": 3600
}
}
}
}
IConfigurableOptions Pattern
All options follow a three-tier configuration pattern:
// 1. Defaults are set in constructor
// 2. appsettings.json values override defaults
// 3. Lambda configuration overrides appsettings
var options = builder.Services.AddApiServices(isDev, config, opts => {
// This lambda is tier 3 - highest priority
opts.ConfigureApi = api => {
api.AuthMode = AuthenticationMode.Authorize;
};
});
Configuration Sections
| Section | Options Class |
|---|---|
affolterNET:Web:SecurityHeaders |
SecurityHeadersOptions |
affolterNET:Web:Cors |
AffolterNetCorsOptions |
affolterNET:Web:Auth:Provider |
AuthProviderOptions |
Common Patterns
Development-specific CORS
// CORS is typically more permissive in development
// The isDev flag passed to AddApiServices handles this
var options = builder.Services.AddApiServices(
builder.Environment.IsDevelopment(),
builder.Configuration);
Custom CSP for APIs
{
"affolterNET": {
"Web": {
"SecurityHeaders": {
"ContentSecurityPolicy": "default-src 'none'; frame-ancestors 'none'"
}
}
}
}
Troubleshooting
CORS preflight fails
- Ensure
AllowedOriginsincludes the exact origin (including protocol and port) - Check that
AllowedMethodsincludes the HTTP method being used - Verify
AllowCredentialsis true if sending cookies/auth headers
CSP blocks resources
- Review browser console for CSP violation reports
- Add required sources to the appropriate CSP directive
- Consider using
report-uridirective for monitoring