diff --git a/src/pages/current/security.mdx b/src/pages/current/security.mdx index d6db7f7..0a78cf1 100644 --- a/src/pages/current/security.mdx +++ b/src/pages/current/security.mdx @@ -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 @@ -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 по модели приложения.