Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions src/pages/current/security.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ php server.php start

Клиент предъявляет сертификат и ключ во время TLS handshake. Отсутствующий или недоверенный сертификат отклоняется до вызова обработчика приложения. На TLS listener `Server::$onConnect` вызывается только после успешного handshake; для обычного TCP listener он вызывается после принятия соединения. Закрытый ключ сервера должен быть доступен только системной учётной записи сервиса; закрытые ключи клиентов передавайте через управляемое хранилище секретов. Проверка цепочки не устанавливает прикладные права: приложение должно отдельно определять, как проверенный сертификат соотносится с пользователем и его разрешениями.

CI запускает локальную mTLS integration-проверку с краткоживущими тестовыми CA и сертификатами. Она проверяет доверенный, отсутствующий и недоверенный клиентский сертификат, зависший TLS handshake, выбор `http/1.1` через ALPN, отсутствие выбранного протокола без ALPN, вызов `onConnect` только после успешного handshake и доступ только доверенного клиента к HTTP callback-у. Это проверка механизма TLS в тестовом окружении, а не проверка production-конфигурации сертификатов.
CI запускает локальную mTLS integration-проверку с краткоживущими тестовыми CA и сертификатами. Она проверяет доверенный, отсутствующий и недоверенный клиентский сертификат, зависший TLS handshake, выбор `http/1.1` через ALPN, отсутствие выбранного протокола без ALPN, закрытие HTTPS- и WSS-соединений при выбранном `h2` без передачи данных в HTTP/1-кодеки, вызов `onConnect` только после успешного handshake и доступ только доверенного клиента к HTTP callback-у. Это проверка механизма TLS в тестовом окружении, а не проверка production-конфигурации сертификатов.

## TLS, сессии и gateway

Expand All @@ -68,7 +68,7 @@ TLS можно завершать на доверенном edge либо на l
export LOCALZET_SSL_ALPN_PROTOCOLS=http/1.1
```

Объявляйте только протоколы, которые действительно обрабатывает listener. Встроенный HTTP-кодек поддерживает HTTP/1.x: добавление `h2` в ALPN само по себе не включает HTTP/2.
Объявляйте только протоколы, которые действительно обрабатывает listener. Встроенные HTTP- и WebSocket-кодеки поддерживают HTTP/1.x: добавление `h2` в ALPN само по себе не включает HTTP/2. Если TLS выбрал ALPN, отличный от `http/1.1`, соответствующий кодек закрывает соединение без попытки разобрать входящие байты как HTTP/1.x. Listener без ALPN сохраняет совместимость с обычным HTTP/1.x.

По умолчанию session cookie не гарантирует production-политику: задайте `secure`, `httpOnly`, `sameSite`, lifetime и domain по модели приложения.

Expand Down
Loading