⚡ Esora Документация

Безопасность

Назначение и когда использовать

Защищайте каждый state-changing endpoint middleware, authorization и validation. Секреты находятся в .env, а public document root — только public/.

Middleware и настройка

CsrfMiddleware(?Session $session, array $except = []) пропускает GET/HEAD/OPTIONS, принимает _token, X-CSRF-TOKEN или X-XSRF-TOKEN, при ошибке возвращает 419. Исключения задаются точным path или /* prefix.

RateLimitMiddleware(CacheInterface $cache, int $maxAttempts = 60, int $decaySeconds = 60, string $prefix = 'rate_limit:') ограничивает IP+path и возвращает 429 с Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining.

CorsMiddleware(array $config = []) поддерживает allowed_origins, allowed_methods, allowed_headers, exposed_headers, max_age, supports_credentials. Для credentialed requests не оставляйте wildcard origins без понимания последствий.

Криптография и authorization

$encrypter = new Esora\Security\Encrypter($key); // ровно 32 bytes
$payload = $encrypter->encrypt($secret);
$secret = $encrypter->decrypt($payload);

$hasher = new Esora\Security\PasswordHasher();
$hash = $hasher->make($password);
if ($hasher->check($password, $hash)) { /* login */ }

PasswordHasher::needsRehash() проверяет обновление параметров. Gate регистрирует setUserResolver, define, policy; проверяет allows, denies, а authorize выбрасывает AuthorizationException.

Lifecycle и troubleshooting

Request → middleware pipeline → CSRF/rate/CORS → controller authorization → validation → response. 419 означает missing/invalid CSRF; 429 — лимит; 403 — authorization. Не отключайте CSRF глобально, не логируйте passwords/keys, экранируйте HTML через htmlspecialchars, держите APP_DEBUG=false в production.