ON CLUSTER 절을 사용하면 클러스터 전체에 사용자를 생성할 수 있습니다. 자세한 내용은 분산 DDL을 참조하십시오.
식별
IDENTIFIED WITH no_passwordIDENTIFIED WITH plaintext_password BY 'qwerty'IDENTIFIED WITH sha256_password BY 'qwerty'orIDENTIFIED BY 'password'IDENTIFIED WITH sha256_hash BY 'hash'orIDENTIFIED 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 kerberosorIDENTIFIED 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'orIDENTIFIED WITH http SERVER 'http_server' SCHEME 'basic'IDENTIFIED BY 'qwerty'
ClickHouse Cloud에서는 기본적으로 비밀번호가 다음 복잡성 요구 사항을 충족해야 합니다.
- 최소 12자 이상이어야 합니다
- 숫자를 최소 1개 포함해야 합니다
- 대문자를 최소 1개 포함해야 합니다
- 소문자를 최소 1개 포함해야 합니다
- 특수 문자를 최소 1개 포함해야 합니다
예시
-
다음 사용자 이름은
name1이며 비밀번호가 필요하지 않습니다. 당연히 보안상 그다지 안전하지 않습니다: -
plaintext 비밀번호를 지정하려면 다음과 같이 합니다:
-
가장 일반적인 방법은 SHA-256으로 해시된 비밀번호를 사용하는 것입니다.
IDENTIFIED WITH sha256_password를 지정하면 ClickHouse가 비밀번호를 대신 해시합니다. 예시는 다음과 같습니다:이제name3사용자는my_password로 로그인할 수 있지만, 비밀번호는 위의 해시값으로 저장됩니다. 다음 SQL 파일이/var/lib/clickhouse/access에 생성되며 서버 시작 시 실행됩니다:
-
double_sha1_password는 일반적으로 필요하지 않지만, 이를 요구하는 클라이언트(MySQL interface 등)와 함께 작업할 때 유용합니다:ClickHouse는 다음 쿼리를 생성하고 실행합니다: -
bcrypt_password는 비밀번호 저장에 가장 안전한 옵션입니다. 이 방식은 bcrypt 알고리즘을 사용하며, 비밀번호 해시가 유출되더라도 무차별 대입 공격에 강합니다.이 방법에서는 비밀번호 길이가 72자로 제한됩니다. 해시 계산과 비밀번호 검증에 필요한 연산량과 시간을 정의하는 bcrypt work factor 매개변수는 서버 구성에서 수정할 수 있습니다:work factor는 4에서 31 사이여야 하며, 기본값은 12입니다.
-
비밀번호 타입은 생략할 수도 있습니다:
이 경우 ClickHouse는 서버 구성에 지정된 기본 비밀번호 타입을 사용합니다:사용 가능한 비밀번호 타입은 다음과 같습니다:
plaintext_password,sha256_password,double_sha1_password. -
여러 인증 방법을 지정할 수 있습니다:
- 이전 버전의 ClickHouse는 여러 인증 방법 구문을 지원하지 않을 수 있습니다. 따라서 ClickHouse 서버에 이러한 사용자가 있는 상태에서 이를 지원하지 않는 버전으로 다운그레이드하면, 해당 사용자를 사용할 수 없게 되고 일부 사용자 관련 작업도 정상적으로 동작하지 않게 됩니다. 문제 없이 다운그레이드하려면, 다운그레이드 전에 모든 사용자가 하나의 인증 방법만 사용하도록 설정해야 합니다. 또는 적절한 절차 없이 서버를 다운그레이드했다면, 문제가 있는 사용자는 삭제해야 합니다.
- 보안상의 이유로
no_password는 다른 인증 방법과 함께 사용할 수 없습니다. 따라서no_password는 쿼리에서 유일한 인증 방법일 때만 지정할 수 있습니다.
사용자 호스트
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구문과 동일합니다.
VALID UNTIL 절
YYYY-MM-DD [hh:mm:ss] [timezone] 포맷을 사용하는 것이 좋습니다. 여기서 [timezone]은 +09:00과 같은 숫자 오프셋이거나 UTC, GMT, Z, MSK, MSD 중 하나여야 합니다. Asia/Tokyo와 같은 이름 기반 IANA 시간대는 인식되지 않습니다(아래 참고 참조). 기본적으로 이 매개변수의 값은 'infinity'입니다. 허용되는 마감 시각 범위는 1900-01-01 00:00:00 UTC부터 9999-12-31 09:59:59 UTC까지입니다. 이는 모든 시간대에서 9999년 범위를 벗어나지 않는 가장 늦은 시점이므로, 저장된 시점을 표시할 때 값이 제한되지 않습니다. 과거의 마감 시각은 자격 증명이 이미 만료되었음을 의미합니다. 1970-01-01 00:00:01 UTC 이전의 마감 시각은 “이미 만료됨” 표시로만 허용됩니다. 이 값은 Unix epoch 1초 후(1970-01-01 00:00:01 UTC)인 가장 이른 만료 시점으로 정규화되므로, SHOW CREATE USER는 작성한 마감 시각 대신 해당 시점을 표시합니다. 해당 시점 이후의 마감 시각은 정확하게 저장됩니다.
마감 시각은 절대 시점으로 저장되지만, SHOW CREATE USER 및 system.users는 이를 server 또는 session 시간대로 표시합니다. 따라서 동일한 저장 시점도 구성이 다른 server에서는 서로 다른 현지 시각 텍스트로 나타납니다. 예를 들어 위의 정규화된 만료 시점은 UTC server에서는 1970-01-01 00:00:01로, Pacific/Kiritimati server에서는 1970-01-01 14:00:01로 표시됩니다. 적용 시에는 항상 표시값이 아닌 저장된 시점을 사용합니다.
절의 위치에 따라 적용되는 인증 방법가 결정됩니다.
IDENTIFIED절 앞에 있거나(또는 쿼리에 인증 방법가 전혀 지정되지 않은 경우) 있으면, 마감 시각은 사용자의 모든 인증 방법에 적용되는 사용자 수준의 마감 시각입니다.- 인증 방법 뒤에 있으면 마감 시각은 해당 메서드에만 적용됩니다. 따라서 전체
IDENTIFIED목록 뒤에 작성된 절은 마지막 메서드에만 바인딩되며, 앞선 메서드에는 만료가 적용되지 않습니다.
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 VALID UNTIL '2025-01-01' IDENTIFIED WITH plaintext_password BY 'password_1', bcrypt_password BY 'password_2'— 사용자 수준의 마감 시각은 두 메서드 모두에 적용됩니다.CREATE USER name1 IDENTIFIED WITH plaintext_password BY 'no_expiration', bcrypt_password BY 'expiration_set' VALID UNTIL '2025-01-01'— 마감 시각은bcrypt_password메서드에만 적용되며,plaintext_password는 만료되지 않습니다.
날짜 및 시간 문자열은
parseDateTimeBestEffort로 파싱되며, 이 함수는 UTC, GMT, Z, MSK, MSD 시간대 토큰과 +09:00 또는 -05:00과 같은 숫자 오프셋만 인식합니다. Asia/Tokyo 또는 Europe/London과 같은 이름 기반 IANA 시간대는 지원되지 않습니다. 또한 고정 오프셋은 일광 절약 시간을 적용하는 지역의 IANA 시간대와 동일하지 않으므로, 인코딩하는 특정 날짜에 맞는 올바른 오프셋을 계산해야 합니다.VALID FOR 절
VALID FOR 절은 VALID UNTIL을 간편하게 줄여 쓴 표현입니다. 절대 날짜와 시간 대신 인터벌을 지정할 수 있으며, 쿼리 실행 시점의 현재 시간에 해당 인터벌을 더해 만료 마감 시각을 계산합니다. 결과는 VALID UNTIL 형식으로 저장되므로 SHOW CREATE USER는 항상 해석된 절대 마감 시각을 표시합니다. VALID UNTIL을 사용할 수 있는 모든 위치에서 사용할 수 있으며, 동일한 배치 규칙을 따릅니다. 즉, IDENTIFIED 앞에 있거나 인증 방법이 없는 경우에는 모든 메서드에 적용되는 사용자 수준의 마감 시각이 되며, 인증 방법 뒤에 있으면 해당 메서드에만 적용됩니다. 마감 시각은 초 단위 정밀도로 저장되고 적용되므로 하위 초 단위 인터벌(NANOSECOND, MICROSECOND, MILLISECOND)은 허용되지 않으며, 허용되는 최소 단위는 SECOND입니다. 음수 인터벌은 자격 증명이 이미 만료되었음을 표시하는 용도로 사용할 수 있습니다. 계산된 마감 시각이 1970-01-01 00:00:01 UTC보다 이르면 가장 이른 만료 시점으로 정규화되며, 이후 SHOW CREATE USER는 이를 표시합니다. 이 값은 VALID UNTIL에 설명된 대로 서버 또는 세션 시간대로 표시됩니다.
예시:
CREATE USER name1 VALID FOR INTERVAL 1 DAYCREATE USER name1 VALID FOR INTERVAL 3 MONTHCREATE USER name1 VALID FOR INTERVAL 1 DAY + INTERVAL 12 HOURCREATE USER name1 VALID FOR INTERVAL 30 DAY IDENTIFIED WITH plaintext_password BY 'password_1', bcrypt_password BY 'password_2'— 사용자 수준의 마감 시각은 두 메서드 모두에 적용됩니다.CREATE USER name1 IDENTIFIED WITH plaintext_password BY 'no_expiration', bcrypt_password BY 'expiration_set' VALID FOR INTERVAL 30 DAY— 마감 시각은bcrypt_password메서드에만 적용되며,plaintext_password는 만료되지 않습니다.
GRANTS 절
VALID UNTIL 절이 있으면 그 뒤에) 지정하며 해당 메서드에만 적용됩니다.
사용자가 이러한 인증 방법로 로그인하면 세션의 접근 권한은 사용자의 접근 권한(권한이 부여된 역할의 권한 포함)과 절에 나열된 권한의 교집합이 됩니다. 이 절은 접근 권한을 추가하지 않습니다. 나열된 권한이 사용자에게 부여되지 않았다면 세션에도 해당 권한이 없습니다. 이러한 메서드로 인증된 세션은 권한을 부여할 수도 없으며(GRANT OPTION은 교집합에 포함되지 않음) 역할을 관리할 수도 없습니다. 역할 관리에는 역할 생성, 변경, 삭제, 권한 부여 및 취소뿐 아니라 사용자에게 기본적으로 활성화되는 역할을 변경하는 작업(SET DEFAULT ROLE 및 ALTER USER ... DEFAULT ROLE)도 포함되며, 이 역시 거부됩니다.
EXECUTE AS는 세션의 주체를 전환하므로, 가장하여 실행되는 SQL 문은 로그인한 사용자의 권한이 아니라 대상 사용자의 접근 권한과 나열된 권한의 교집합으로 제한됩니다. 제한 자체는 절대 해제되지 않으며, 가장하려면 사용자에게 IMPERSONATE ON target이 부여되어 있고 절에도 나열되어 있어야 합니다. 따라서 제한된 자격 증명은 동일 사용자의 제한 없는 자격 증명보다 더 많은 권한을 얻을 수 없습니다.
이를 통해 애플리케이션용 토큰을 편리하게 만들 수 있습니다. 즉, 만료일과 제한된 권한 집합을 가진 사용자에 연결된 추가 자격 증명입니다. 이 자격 증명은 system.query_log 및 system.processes에 사용자로 표시되고, 사용자가 삭제되면 작동을 멈추며, 사용자가 권한을 잃으면 접근 권한도 잃습니다.
예시:
CREATE USER name1 IDENTIFIED BY 'qwerty' GRANTS (SELECT ON db.*)ALTER USER name1 ADD IDENTIFIED WITH plaintext_password BY 'app_token' VALID UNTIL '2026-12-31' GRANTS (SELECT ON db.table, INSERT ON db.table)
ALTER USER로 절을 변경하면 새 세션에 영향을 주며, 이미 수립된 세션에는 영향을 주지 않습니다.
READ ON S3('s3://bucket/.*')와 같은 소스 필터가 적용된 권한 부여는 아직 이 절에서 지원되지 않습니다. 교집합은 소스 필터를 불투명한 문자열로 비교하므로 한 필터를 다른 필터로 좁힐 수 없습니다. 따라서 이러한 권한 부여는 액세스 권한이 부여되지 않은 채 조용히 처리되는 대신 거부됩니다.
이 절은 서버가 자격 증명을 순수하게 로컬에서 확인하는 인증 방법에서만 지원됩니다. 확인 과정에서 외부 시스템에 연결하는 메서드(ldap, kerberos, http, jwt의 경우 서명 키를 가져오기 위해 연결할 수 있음)의 경우 이 절은 거부됩니다. 여러 인증 방법가 동일한 자격 증명을 허용하면 다른 메서드에 대해 자격 증명을 다시 확인하여 제한을 적용하는데, 외부 시스템을 추가로 확인하는 것은 안전하지 않습니다. 따라서 동일한 자격 증명을 허용하는 다른 메서드가 제한을 우회할 수 있습니다.
동일한 유효 자격 증명이 둘 이상의 인증 방법에서 허용되면, 로그인은 이들 모두에 의해 실패 시 차단 방식으로 제한됩니다. 세션은 일치하는 모든 메서드의 GRANTS 교집합을 얻고, 해당 VALID UNTIL 중 가장 이른 시점에 만료됩니다. 가장 이른 VALID UNTIL이 이미 지났더라도 우선 적용됩니다. 단일 일치 메서드가 만료된 경우와 정확히 동일하게 로그인이 거부되므로, 토큰의 만료로 공유 자격 증명이 더 광범위한 메서드의 권한이나 유효 기간을 조용히 얻는 일이 없습니다.
이 조합은 위에서 외부 검증 메서드에 이 절 자체가 허용되지 않는 것과 같은 이유로, server가 로컬에서 검증하는 인증 방법 간에만 확인됩니다. 외부 검증 메서드에서 자격 증명을 다시 확인하려면 외부 시스템에 안전하지 않은 추가 probe를 수행해야 하기 때문입니다. 따라서 동일한 사용자의 외부 검증 메서드(ldap, kerberos, http, jwt)에서도 같은 자격 증명이 허용되더라도, 해당 메서드의 VALID UNTIL은 이 조합에 포함되지 않으며, 그 메서드에 구성된 더 이른 만료 시점이 로컬 검증 메서드를 통해 획득한 세션을 단축하지 않습니다.
GRANTEES 절
GRANTEES 절의 옵션은 다음과 같습니다.
user— 이 사용자가 권한을 부여할 수 있는 사용자를 지정합니다.role— 이 사용자가 권한을 부여할 수 있는 역할을 지정합니다.ANY— 이 사용자는 누구에게나 권한을 부여할 수 있습니다. 기본값입니다.NONE— 이 사용자는 누구에게도 권한을 부여할 수 없습니다.
EXCEPT 표현식을 사용하면 특정 사용자나 역할을 제외할 수 있습니다. 예를 들어 CREATE USER user1 GRANTEES ANY EXCEPT user2는 user1에 GRANT OPTION과 함께 일부 권한이 부여된 경우, user2를 제외한 누구에게나 해당 권한을 부여할 수 있음을 의미합니다.
예시
qwerty로 보호된 사용자 계정 mira를 생성합니다:
mira는 ClickHouse 서버가 실행 중인 호스트에서 클라이언트 앱을 실행해야 합니다.
사용자 계정 john을 생성하고 역할을 할당합니다:
john을 생성하고, 역할을 할당한 다음 그중 일부를 기본 역할로 설정합니다:
john을 생성하고, jack 계정 사용자에게 자신의 권한을 부여할 수 있도록 합니다:
john을 생성하세요: