CREATE USER - ClickHouse Documentation

사용자 계정을 생성합니다. 구문:

CREATE USER [IF NOT EXISTS | OR REPLACE] name1 [, name2 [,...]] [ON CLUSTER cluster_name]
    [NOT IDENTIFIED | IDENTIFIED {[WITH {plaintext_password | sha256_password | sha256_hash | double_sha1_password | double_sha1_hash}] BY {'password' | 'hash'}} | WITH NO_PASSWORD | {WITH ldap SERVER 'server_name'} | {WITH kerberos [REALM 'realm']} | {WITH ssl_certificate CN 'common_name' | SAN 'TYPE:subject_alt_name'} | {WITH ssh_key BY KEY 'public_key' TYPE 'ssh-rsa|...'} | {WITH http SERVER 'server_name' [SCHEME 'Basic']} [VALID UNTIL datetime] 
    [, {[{plaintext_password | sha256_password | sha256_hash | ...}] BY {'password' | 'hash'}} | {ldap SERVER 'server_name'} | {...} | ... [,...]]]
    [HOST {LOCAL | NAME 'name' | REGEXP 'name_regexp' | IP 'address' | LIKE 'pattern'} [,...] | ANY | NONE]
    [VALID UNTIL datetime]
    [IN access_storage_type]
    [ROLE role [,...]]
    [DEFAULT ROLE role [,...]]
    [DEFAULT DATABASE database | NONE]
    [GRANTEES {user | role | ANY | NONE} [,...] [EXCEPT {user | role} [,...]]]
    [SETTINGS variable [= value] [MIN [=] min_value] [MAX [=] max_value] [READONLY | WRITABLE] | PROFILE 'profile_name'] [,...]

ON CLUSTER 절을 사용하면 클러스터 전체에 사용자를 생성할 수 있습니다. 자세한 내용은 분산 DDL을 참조하십시오.

식별

사용자를 식별하는 방법은 여러 가지입니다:

IDENTIFIED WITH no_password
IDENTIFIED WITH plaintext_password BY 'qwerty'
IDENTIFIED WITH sha256_password BY 'qwerty' or IDENTIFIED BY 'password'
IDENTIFIED WITH sha256_hash BY 'hash' or IDENTIFIED WITH sha256_hash BY 'hash' SALT 'salt'
IDENTIFIED WITH double_sha1_password BY 'qwerty'
IDENTIFIED WITH double_sha1_hash BY 'hash'
IDENTIFIED WITH bcrypt_password BY 'qwerty'
IDENTIFIED WITH bcrypt_hash BY 'hash'
IDENTIFIED WITH ldap SERVER 'server_name'
IDENTIFIED WITH kerberos or IDENTIFIED WITH kerberos REALM 'realm'
IDENTIFIED WITH ssl_certificate CN 'mysite.com:user'
IDENTIFIED WITH ssh_key BY KEY 'public_key' TYPE 'ssh-rsa', KEY 'another_public_key' TYPE 'ssh-ed25519'
IDENTIFIED WITH http SERVER 'http_server' or IDENTIFIED WITH http SERVER 'http_server' SCHEME 'basic'
IDENTIFIED BY 'qwerty'

비밀번호 복잡성 요구 사항은 config.xml에서 수정할 수 있습니다. 아래는 비밀번호가 최소 12자 이상이고 숫자 1개를 포함해야 하도록 설정하는 구성 예시입니다. 각 비밀번호 복잡성 규칙에는 비밀번호와 매칭할 정규식과 해당 규칙에 대한 설명이 필요합니다.

<clickhouse>
    <password_complexity>
        <rule>
            <pattern>.{12}</pattern>
            <message>be at least 12 characters long</message>
        </rule>
        <rule>
            <pattern>\p{N}</pattern>
            <message>contain at least 1 numeric character</message>
        </rule>
    </password_complexity>
</clickhouse>

ClickHouse Cloud에서는 기본적으로 비밀번호가 다음 복잡성 요구 사항을 충족해야 합니다.

최소 12자 이상이어야 합니다
숫자를 최소 1개 포함해야 합니다
대문자를 최소 1개 포함해야 합니다
소문자를 최소 1개 포함해야 합니다
특수 문자를 최소 1개 포함해야 합니다

예시

다음 사용자 이름은 name1이며 비밀번호가 필요하지 않습니다. 당연히 보안상 그다지 안전하지 않습니다:
```
CREATE USER name1 NOT IDENTIFIED
```

plaintext 비밀번호를 지정하려면 다음과 같이 합니다:

CREATE USER name2 IDENTIFIED WITH plaintext_password BY 'my_password'

비밀번호는 /var/lib/clickhouse/access의 SQL 텍스트 파일에 저장되므로 plaintext_password를 사용하는 것은 바람직하지 않습니다. 대신 다음 예시와 같이 sha256_password를 사용하십시오…

가장 일반적인 방법은 SHA-256으로 해시된 비밀번호를 사용하는 것입니다. IDENTIFIED WITH sha256_password를 지정하면 ClickHouse가 비밀번호를 대신 해시합니다. 예시는 다음과 같습니다:
```
CREATE USER name3 IDENTIFIED WITH sha256_password BY 'my_password'
```
이제 name3 사용자는 my_password로 로그인할 수 있지만, 비밀번호는 위의 해시값으로 저장됩니다. 다음 SQL 파일이 /var/lib/clickhouse/access에 생성되며 서버 시작 시 실행됩니다:
```
/var/lib/clickhouse/access $ cat 3843f510-6ebd-a52d-72ac-e021686d8a93.sql
ATTACH USER name3 IDENTIFIED WITH sha256_hash BY '0C268556C1680BEF0640AAC1E7187566704208398DA31F03D18C74F5C5BE5053' SALT '4FB16307F5E10048196966DD7E6876AE53DE6A1D1F625488482C75F14A5097C7';
```

사용자 이름에 대한 해시값과 해당 salt 값을 이미 생성한 경우 IDENTIFIED WITH sha256_hash BY 'hash' 또는 IDENTIFIED WITH sha256_hash BY 'hash' SALT 'salt'를 사용할 수 있습니다. SALT를 사용해 sha256_hash로 식별하는 경우 해시는 ‘password’와 ‘salt’를 이어 붙인 값으로 계산해야 합니다.

double_sha1_password는 일반적으로 필요하지 않지만, 이를 요구하는 클라이언트(MySQL interface 등)와 함께 작업할 때 유용합니다:
```
CREATE USER name4 IDENTIFIED WITH double_sha1_password BY 'my_password'
```
ClickHouse는 다음 쿼리를 생성하고 실행합니다:
```
CREATE USER name4 IDENTIFIED WITH double_sha1_hash BY 'CCD3A959D6A004B9C3807B728BC2E55B67E10518'
```
bcrypt_password는 비밀번호 저장에 가장 안전한 옵션입니다. 이 방식은 bcrypt 알고리즘을 사용하며, 비밀번호 해시가 유출되더라도 무차별 대입 공격에 강합니다.
```
CREATE USER name5 IDENTIFIED WITH bcrypt_password BY 'my_password'
```
이 방법에서는 비밀번호 길이가 72자로 제한됩니다. 해시 계산과 비밀번호 검증에 필요한 연산량과 시간을 정의하는 bcrypt work factor 매개변수는 서버 구성에서 수정할 수 있습니다:
```
<bcrypt_workfactor>12</bcrypt_workfactor>
```
work factor는 4에서 31 사이여야 하며, 기본값은 12입니다.

인증 빈도가 높은 애플리케이션의 경우, 더 높은 work factor에서 발생하는 bcrypt의 계산 오버헤드를 고려하여 다른 인증 방식을 검토하십시오.

비밀번호 타입은 생략할 수도 있습니다:
```
CREATE USER name6 IDENTIFIED BY 'my_password'
```
이 경우 ClickHouse는 서버 구성에 지정된 기본 비밀번호 타입을 사용합니다:
```
<default_password_type>sha256_password</default_password_type>
```
사용 가능한 비밀번호 타입은 다음과 같습니다: plaintext_password, sha256_password, double_sha1_password.

여러 인증 방식을 지정할 수 있습니다:

CREATE USER user1 IDENTIFIED WITH plaintext_password by '1', bcrypt_password by '2', plaintext_password by '3''

참고:

이전 버전의 ClickHouse는 여러 인증 방식 구문을 지원하지 않을 수 있습니다. 따라서 ClickHouse 서버에 이러한 사용자가 있는 상태에서 이를 지원하지 않는 버전으로 다운그레이드하면, 해당 사용자를 사용할 수 없게 되고 일부 사용자 관련 작업도 정상적으로 동작하지 않게 됩니다. 문제 없이 다운그레이드하려면, 다운그레이드 전에 모든 사용자가 하나의 인증 방식만 사용하도록 설정해야 합니다. 또는 적절한 절차 없이 서버를 다운그레이드했다면, 문제가 있는 사용자는 삭제해야 합니다.
보안상의 이유로 no_password는 다른 인증 방식과 함께 사용할 수 없습니다. 따라서 no_password는 쿼리에서 유일한 인증 방식일 때만 지정할 수 있습니다.

사용자 호스트

사용자 호스트는 ClickHouse 서버에 연결을 설정할 수 있는 호스트입니다. 호스트는 HOST 쿼리 섹션에서 다음과 같은 방식으로 지정할 수 있습니다.

HOST IP 'ip_address_or_subnetwork' — 사용자는 지정된 IP 주소 또는 서브넷에서만 ClickHouse 서버에 연결할 수 있습니다. 예시: HOST IP '192.168.0.0/16', HOST IP '2001:DB8::/32'. 프로덕션 환경에서는 host 및 host_regexp를 사용하면 추가 지연 시간이 발생할 수 있으므로 HOST IP 요소(IP 주소 및 해당 마스크)만 지정하십시오.
HOST ANY — 사용자는 어디서나 연결할 수 있습니다. 기본 옵션입니다.
HOST LOCAL — 사용자는 로컬에서만 연결할 수 있습니다.
HOST NAME 'fqdn' — 사용자 호스트를 FQDN으로 지정할 수 있습니다. 예를 들어 HOST NAME 'mysite.com'입니다.
HOST REGEXP 'regexp' — 사용자 호스트를 지정할 때 pcre 정규식을 사용할 수 있습니다. 예를 들어 HOST REGEXP '.*\.mysite\.com'입니다.
HOST LIKE 'template' — LIKE 연산자를 사용해 사용자 호스트를 필터링할 수 있습니다. 예를 들어 HOST LIKE '%'는 HOST ANY와 같고, HOST LIKE '%.mysite.com'는 mysite.com 도메인의 모든 호스트를 필터링합니다.

호스트를 지정하는 또 다른 방법은 사용자 이름 뒤에 @ 구문을 사용하는 것입니다. 예시는 다음과 같습니다.

CREATE USER mira@'127.0.0.1' — HOST IP 구문과 동일합니다.
CREATE USER mira@'localhost' — HOST LOCAL 구문과 동일합니다.
CREATE USER mira@'192.168.%.%' — HOST LIKE 구문과 동일합니다.

ClickHouse는 user_name@'address' 전체를 하나의 사용자 이름으로 처리합니다. 따라서 기술적으로는 동일한 user_name에 대해 @ 뒤의 구성이 다른 여러 사용자를 만들 수 있습니다. 그러나 이렇게 하는 것은 권장하지 않습니다.

VALID UNTIL 절

인증 방식의 만료 날짜와 선택적으로 시간을 지정할 수 있습니다. 문자열을 매개변수로 받습니다. 날짜/시간 값에는 YYYY-MM-DD [hh:mm:ss] [timezone] 포맷을 사용하는 것이 권장되며, 여기서 [timezone]은 +09:00과 같은 숫자 오프셋이거나 UTC, GMT, Z, MSK, MSD 중 하나여야 합니다. Asia/Tokyo와 같은 이름 기반 IANA 시간대는 인식되지 않습니다(아래 참고). 이 매개변수의 기본값은 'infinity'입니다. VALID UNTIL 절은 인증 방식을 함께 지정할 때만 사용할 수 있으며, 쿼리에서 인증 방식을 전혀 지정하지 않은 경우는 예외입니다. 이 경우 VALID UNTIL 절은 기존의 모든 인증 방식에 적용됩니다. 예시:

CREATE USER name1 VALID UNTIL '2025-01-01'
CREATE USER name1 VALID UNTIL '2025-01-01 12:00:00 UTC'
CREATE USER name1 VALID UNTIL '2025-01-01 12:00:00 +09:00'
CREATE USER name1 VALID UNTIL 'infinity'
CREATE USER name1 IDENTIFIED WITH plaintext_password BY 'no_expiration', bcrypt_password BY 'expiration_set' VALID UNTIL '2025-01-01'

날짜/시간 문자열은 parseDateTimeBestEffort로 파싱되며, 이 함수는 시간대 토큰 UTC, GMT, Z, MSK, MSD와 +09:00 또는 -05:00 같은 숫자 오프셋만 인식합니다. Asia/Tokyo 또는 Europe/London과 같은 이름 기반 IANA 시간대는 지원되지 않으며, 일광 절약 시간제를 적용하는 지역에서는 고정 오프셋이 IANA 시간대와 동일하지 않으므로 인코딩하려는 특정 날짜에 맞는 올바른 오프셋을 직접 계산해야 합니다.

GRANTEES 절

이 사용자에게 GRANT OPTION과 함께 필요한 모든 접근 권한이 부여된 경우, 이 사용자로부터 권한을 받을 수 있는 사용자 또는 역할을 지정합니다. GRANTEES 절의 옵션은 다음과 같습니다.

user — 이 사용자가 권한을 부여할 수 있는 사용자를 지정합니다.
role — 이 사용자가 권한을 부여할 수 있는 역할을 지정합니다.
ANY — 이 사용자는 누구에게나 권한을 부여할 수 있습니다. 기본값입니다.
NONE — 이 사용자는 누구에게도 권한을 부여할 수 없습니다.

EXCEPT 표현식을 사용하면 특정 사용자나 역할을 제외할 수 있습니다. 예를 들어 CREATE USER user1 GRANTEES ANY EXCEPT user2는 user1에 GRANT OPTION과 함께 일부 권한이 부여된 경우, user2를 제외한 누구에게나 해당 권한을 부여할 수 있음을 의미합니다.

예시

비밀번호 qwerty로 보호된 사용자 계정 mira를 생성합니다:

CREATE USER mira HOST IP '127.0.0.1' IDENTIFIED WITH sha256_password BY 'qwerty';

mira는 ClickHouse 서버가 실행 중인 호스트에서 클라이언트 앱을 실행해야 합니다. 사용자 계정 john을 생성하고 역할을 할당합니다:

CREATE USER john ROLE role1, role2;

사용자 계정 john을 생성하고, 역할을 할당한 다음 그중 일부를 기본 역할로 설정합니다:

CREATE USER john ROLE role1, role2 DEFAULT ROLE role1;

또는

CREATE USER john ROLE role1, role2 DEFAULT ROLE ALL EXCEPT role2;

사용자 계정 john을 생성하고, jack 계정 사용자에게 자신의 권한을 부여할 수 있도록 합니다:

CREATE USER john GRANTEES jack;

쿼리 매개변수를 사용해 사용자 계정 john을 생성하세요:

SET param_user=john;
CREATE USER {user:Identifier};

​식별

​예시

​사용자 호스트

​VALID UNTIL 절

​GRANTEES 절

​예시

식별

예시

사용자 호스트

VALID UNTIL 절

GRANTEES 절

예시