ClickHouse/docs/zh/operations/settings/settings-users.md

165 lines
5.3 KiB
Markdown
Raw Normal View History

2020-04-03 13:23:32 +00:00
---
machine_translated: true
machine_translated_rev: 72537a2d527c63c07aa5d2361a8829f3895cf2bd
toc_priority: 63
toc_title: "\u7528\u6237\u8BBE\u7F6E"
2020-04-03 13:23:32 +00:00
---
# 用户设置 {#user-settings}
2020-04-03 13:23:32 +00:00
`users` 一节 `user.xml` 配置文件包含用户设置。
2020-04-03 13:23:32 +00:00
!!! note "信息"
ClickHouse还支持 [SQL驱动的工作流](../access-rights.md#access-control) 用于管理用户。 我们建议使用它。
的结构 `users` 科:
2020-04-03 13:23:32 +00:00
``` xml
<users>
<!-- If user name was not specified, 'default' user is used. -->
<user_name>
<password></password>
<!-- Or -->
<password_sha256_hex></password_sha256_hex>
<access_management>0|1</access_management>
2020-04-03 13:23:32 +00:00
<networks incl="networks" replace="replace">
</networks>
<profile>profile_name</profile>
<quota>default</quota>
<databases>
<database_name>
<table_name>
<filter>expression</filter>
<table_name>
</database_name>
</databases>
</user_name>
<!-- Other users settings -->
</users>
```
### 用户名称/密码 {#user-namepassword}
2020-04-03 13:23:32 +00:00
密码可以以明文或SHA256十六进制格式指定。
2020-04-03 13:23:32 +00:00
- 以明文形式分配密码 (**不推荐**),把它放在一个 `password` 元素。
2020-04-03 13:23:32 +00:00
例如, `<password>qwerty</password>`. 密码可以留空。
2020-04-03 13:23:32 +00:00
<a id="password_sha256_hex"></a>
- 要使用其SHA256散列分配密码请将其放置在 `password_sha256_hex` 元素。
2020-04-03 13:23:32 +00:00
例如, `<password_sha256_hex>65e84be33532fb784c48129675f9eff3a682b27168c0ea744b2cf58ee02337c5</password_sha256_hex>`.
2020-04-03 13:23:32 +00:00
如何从shell生成密码的示例:
2020-04-03 13:23:32 +00:00
PASSWORD=$(base64 < /dev/urandom | head -c8); echo "$PASSWORD"; echo -n "$PASSWORD" | sha256sum | tr -d '-'
结果的第一行是密码。 第二行是相应的SHA256哈希。
2020-04-03 13:23:32 +00:00
<a id="password_double_sha1_hex"></a>
- 为了与MySQL客户端兼容密码可以在双SHA1哈希中指定。 放进去 `password_double_sha1_hex` 元素。
2020-04-03 13:23:32 +00:00
例如, `<password_double_sha1_hex>08b4a0f1de6ad37da17359e592c8d74788a83eb0</password_double_sha1_hex>`.
2020-04-03 13:23:32 +00:00
如何从shell生成密码的示例:
2020-04-03 13:23:32 +00:00
PASSWORD=$(base64 < /dev/urandom | head -c8); echo "$PASSWORD"; echo -n "$PASSWORD" | sha1sum | tr -d '-' | xxd -r -p | sha1sum | tr -d '-'
结果的第一行是密码。 第二行是相应的双SHA1哈希。
2020-04-03 13:23:32 +00:00
### 访问管理 {#access_management-user-setting}
此设置启用禁用使用SQL驱动 [访问控制和帐户管理](../access-rights.md#access-control) 对于用户。
可能的值:
- 0 — Disabled.
- 1 — Enabled.
默认值0。
### 用户名称/网络 {#user-namenetworks}
2020-04-03 13:23:32 +00:00
用户可以从中连接到ClickHouse服务器的网络列表。
2020-04-03 13:23:32 +00:00
列表中的每个元素都可以具有以下形式之一:
2020-04-03 13:23:32 +00:00
- `<ip>` — IP address or network mask.
例: `213.180.204.3`, `10.0.0.1/8`, `10.0.0.1/255.255.255.0`, `2a02:6b8::3`, `2a02:6b8::3/64`, `2a02:6b8::3/ffff:ffff:ffff:ffff::`.
2020-04-03 13:23:32 +00:00
- `<host>` — Hostname.
示例: `example01.host.ru`.
2020-04-03 13:23:32 +00:00
要检查访问将执行DNS查询并将所有返回的IP地址与对等地址进行比较。
2020-04-03 13:23:32 +00:00
- `<host_regexp>` — Regular expression for hostnames.
示例, `^example\d\d-\d\d-\d\.host\.ru$`
2020-04-03 13:23:32 +00:00
要检查访问a [DNS PTR查询](https://en.wikipedia.org/wiki/Reverse_DNS_lookup) 对对等体地址执行,然后应用指定的正则表达式。 然后对PTR查询的结果执行另一个DNS查询并将所有接收到的地址与对等地址进行比较。 我们强烈建议正则表达式以$结尾。
2020-04-03 13:23:32 +00:00
DNS请求的所有结果都将被缓存直到服务器重新启动。
2020-04-03 13:23:32 +00:00
**例**
2020-04-03 13:23:32 +00:00
要从任何网络打开用户的访问权限,请指定:
2020-04-03 13:23:32 +00:00
``` xml
<ip>::/0</ip>
```
!!! warning "警告"
从任何网络开放访问是不安全的,除非你有一个防火墙正确配置或服务器没有直接连接到互联网。
2020-04-03 13:23:32 +00:00
若要仅从本地主机打开访问权限,请指定:
2020-04-03 13:23:32 +00:00
``` xml
<ip>::1</ip>
<ip>127.0.0.1</ip>
```
2020-10-13 17:23:29 +00:00
### user_name/profile {#user-nameprofile}
2020-04-03 13:23:32 +00:00
您可以为用户分配设置配置文件。 设置配置文件在单独的部分配置 `users.xml` 文件 有关详细信息,请参阅 [设置配置文件](settings-profiles.md).
2020-04-03 13:23:32 +00:00
### 用户名称/配额 {#user-namequota}
2020-04-03 13:23:32 +00:00
配额允许您在一段时间内跟踪或限制资源使用情况。 配额在配置 `quotas`
一节 `users.xml` 配置文件。
2020-04-03 13:23:32 +00:00
您可以为用户分配配额。 有关配额配置的详细说明,请参阅 [配额](../quotas.md#quotas).
2020-04-03 13:23:32 +00:00
### 用户名/数据库 {#user-namedatabases}
2020-04-03 13:23:32 +00:00
在本节中您可以限制ClickHouse返回的行 `SELECT` 由当前用户进行的查询,从而实现基本的行级安全性。
2020-04-03 13:23:32 +00:00
**示例**
2020-04-03 13:23:32 +00:00
以下配置强制该用户 `user1` 只能看到的行 `table1` 作为结果 `SELECT` 查询,其中的值 `id` 场是1000。
2020-04-03 13:23:32 +00:00
``` xml
<user1>
<databases>
<database_name>
<table1>
<filter>id = 1000</filter>
</table1>
</database_name>
</databases>
</user1>
```
`filter` 可以是导致任何表达式 [UInt8](../../sql-reference/data-types/int-uint.md)-键入值。 它通常包含比较和逻辑运算符。 从行 `database_name.table1` 其中不会为此用户返回为0的筛选结果。 过滤是不兼容的 `PREWHERE` 操作和禁用 `WHERE→PREWHERE` 优化。
2020-04-03 13:23:32 +00:00
[原始文章](https://clickhouse.tech/docs/en/operations/settings/settings_users/) <!--hide-->