mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-04 21:42:39 +00:00
35 lines
2.6 KiB
Markdown
35 lines
2.6 KiB
Markdown
---
|
||
slug: /ru/operations/external-authenticators/ssl-x509
|
||
---
|
||
# Аутентификация по сертификату SSL X.509 {#ssl-external-authentication}
|
||
|
||
[Опция 'strict'](../server-configuration-parameters/settings.md#server_configuration_parameters-openssl) включает обязательную проверку сертификатов входящих соединений в библиотеке `SSL`. В этом случае могут быть установлены только соединения, представившие действительный сертификат. Соединения с недоверенными сертификатами будут отвергнуты. Таким образом, проверка сертификата позволяет однозначно аутентифицировать входящее соединение. Идентификация пользователя осуществляется по полю `Common Name` или `subjectAltName` сертификата. Это позволяет ассоциировать несколько сертификатов с одним и тем же пользователем. Дополнительно, перевыпуск и отзыв сертификата не требуют изменения конфигурации ClickHouse.
|
||
|
||
Для включения аутентификации по SSL сертификату, необходимо указать список `Common Name` или `subjectAltName` для каждого пользователя ClickHouse в файле настройки `config.xml`:
|
||
|
||
**Example**
|
||
```xml
|
||
<clickhouse>
|
||
<!- ... -->
|
||
<users>
|
||
<user_name_1>
|
||
<ssl_certificates>
|
||
<common_name>host.domain.com:example_user</common_name>
|
||
<common_name>host.domain.com:example_user_dev</common_name>
|
||
<!-- More names -->
|
||
</ssl_certificates>
|
||
<!-- Other settings -->
|
||
</user_name_1>
|
||
<user_name_2>
|
||
<ssl_certificates>
|
||
<subject_alt_name>DNS:host.domain.com</subject_alt_name>
|
||
<!-- More names -->
|
||
</ssl_certificates>
|
||
<!-- Other settings -->
|
||
</user_name_2>
|
||
</users>
|
||
</clickhouse>
|
||
```
|
||
|
||
Для правильной работы SSL [`chain of trust`](https://en.wikipedia.org/wiki/Chain_of_trust) важно также убедиться в правильной настройке параметра [`caConfig`](../server-configuration-parameters/settings.md#server_configuration_parameters-openssl)
|