⚡ zappzarapp/security

व्यापक PHP सुरक्षा लाइब्रेरी जो CSP, सुरक्षा हेडर, CSRF सुरक्षा, सुरक्षित कुकीज़, पासवर्ड सत्यापन, इनपुट सैनिटाइज़ेशन, रेट लिमिटिंग, SRI, सीक्रेट लोडिंग, एन्क्रिप्शन, सत्र सुरक्षा, TOTP दो-कारक प्रमाणीकरण, हस्ताक्षरित URL और सुरक्षा इवेंट लॉगिंग प्रदान करती है।

मुख्य विशेषताएं

• ऑल-इन-वन — एक ही, संयोजनीय पैकेज में 17 सुरक्षा मॉड्यूल
• डिफ़ॉल्ट रूप से सुरक्षित — सख्त CSP, कोई unsafe-* नहीं, HTTPS-प्रथम
• फ्रेमवर्क-अज्ञेय — किसी भी PHP 8.4+ एप्लिकेशन के साथ काम करता है
• अपरिवर्तनीय और टाइप-सुरक्षित — readonly क्लासेस, enums, with*() API
• गुणवत्ता-समर्थित — PHPStan Level 8, Psalm Level 1, 100% Mutation Score, Deptrac आर्किटेक्चर प्रवर्तन
• PSR-संगत — PSR-3 (लॉगिंग), PSR-15 (मिडलवेयर), PSR-18 (HTTP क्लाइंट)

मॉड्यूल

मॉड्यूल	विवरण	मुख्य क्लासेस
CSP	कंटेंट सिक्योरिटी पॉलिसी हेडर निर्माण और उल्लंघन रिपोर्टिंग	CspDirectives, HeaderBuilder, NonceGenerator, CspReportParser
Headers	सुरक्षा हेडर (HSTS, Permissions-Policy, आदि.)	SecurityHeaders, SecurityHeadersBuilder
CSRF	क्रॉस-साइट रिक्वेस्ट फोर्जरी सुरक्षा	CsrfProtection, CsrfConfig
Cookie	सुरक्षित कुकी हैंडलिंग	SecureCookie, CookieBuilder, CookieOptions
Encryption	XChaCha20-Poly1305 प्रमाणित एन्क्रिप्शन	SymmetricEncryptor, EnvelopeEncryptor, EncryptionKey, KeyRingEncryptor
Password	पासवर्ड सत्यापन और हैशिंग	PasswordPolicy, PwnedPasswordChecker, PepperedPasswordHasher
Sanitization	इनपुट सैनिटाइज़ेशन (HTML, SQL, URI, Path) और फ़ाइल अपलोड सत्यापन	HtmlSanitizer, UriSanitizer, PathValidator, UploadValidator
RateLimiting	कई एल्गोरिदम के साथ रेट लिमिटिंग	DefaultRateLimiter, RateLimitConfig
SRI	सबरिसोर्स इंटीग्रिटी हैश जनरेशन	SriHashGenerator, IntegrityAttribute
Secrets	Docker/फ़ाइल-आधारित सीक्रेट लोडिंग	SecretLoader, SecretValue, FileSecretSource
Session	सत्र सख्तीकरण और फिक्सेशन सुरक्षा	SessionGuard, SessionConfig, SessionConfigurator
SignedUrl	अनिवार्य समाप्ति के साथ HMAC-हस्ताक्षरित URL	UrlSigner, SigningKey
TOTP	समय-आधारित वन-टाइम पासवर्ड (RFC 6238)	TotpAuthenticator, TotpSecret, ProvisioningUri, RecoveryCodeGenerator
Analyzer	सुरक्षा हेडर विश्लेषण और ऑडिटिंग	SecurityHeaderAnalyzer, AnalysisResult
Scanner	CLI सुरक्षा हेडर स्कैनर	ScanCommand, StreamHeaderFetcher
Middleware	ड्रॉप-इन फ्रेमवर्क एकीकरण के लिए PSR-15 मिडलवेयर	SecurityHeadersMiddleware, CspMiddleware, CspReportHandler, CsrfMiddleware, DoubleSubmitCsrfMiddleware, RateLimitMiddleware, CorsMiddleware
Logging	सुरक्षा इवेंट लॉगिंग	SecurityAuditLogger, SecurityEvent

आवश्यकताएँ

• PHP ^8.4
• ext-dom
• ext-libxml
• ext-sodium

स्थापना

composer require zappzarapp/security

त्वरित प्रारंभ

सुरक्षा हेडर

use Zappzarapp\Security\Headers\Builder\SecurityHeadersBuilder;

$headers = SecurityHeadersBuilder::recommended()->build();
foreach ($headers as $name => $value) {
    header("{$name}: {$value}");
}

नॉन्स के साथ CSP

use Zappzarapp\Security\Csp\HeaderBuilder;
use Zappzarapp\Security\Csp\Directive\CspDirectives;
use Zappzarapp\Security\Csp\Nonce\NonceGenerator;

$generator = new NonceGenerator();
$csp = HeaderBuilder::build(CspDirectives::strict(), $generator);
header("Content-Security-Policy: {$csp}");

$nonce = $generator->get();
echo "<script nonce=\"{$nonce}\">console.log('Safe!');</script>";

CSRF सुरक्षा

use Zappzarapp\Security\Csrf\CsrfProtection;
use Zappzarapp\Security\Csrf\Storage\SessionCsrfStorage;

$csrf = new CsrfProtection(new SessionCsrfStorage());

// फॉर्म के लिए टोकन जनरेट करें
$token = $csrf->generateToken();
echo '<input type="hidden" name="_token" value="' . $token->value() . '">';

// सबमिशन पर सत्यापित करें
if (!$csrf->validateToken($_POST['_token'])) {
    throw new Exception('CSRF validation failed');
}

इनपुट सैनिटाइज़ेशन

use Zappzarapp\Security\Sanitization\Html\HtmlSanitizer;
use Zappzarapp\Security\Sanitization\Path\PathValidationConfig;
use Zappzarapp\Security\Sanitization\Path\PathValidator;

// HTML सैनिटाइज़ करें (खतरनाक टैग/एट्रिब्यूट हटाता है)
$sanitizer = new HtmlSanitizer();
$safe = $sanitizer->sanitize($userInput);

// फ़ाइल पथ सत्यापित करें (डायरेक्टरी ट्रैवर्सल रोकें)
$validator = new PathValidator(new PathValidationConfig(basePath: '/var/www/uploads'));
if (!$validator->isSafe($userPath)) {
    throw new Exception('Invalid path');
}