인증 기관 재정의
Teleport v18.11요약
인증 기관 재정의(Certificate Authority Overrides)를 사용하면 클러스터 관리자가 자체 서명된 Teleport CA 인증서를 외부 인증 기관이 서명한 인증서로 재정의할 수 있습니다. 인증 기관 재정의는 현재 활발히 개발 중입니다.
인증 기관 재정의(Certificate Authority Overrides)를 사용하면 클러스터 관리자가 자체 서명된 Teleport CA 인증서를 외부 인증 기관이 서명한 인증서로 재정의할 수 있습니다. 실질적으로 해당 Teleport CA는 외부 신뢰 체인의 하위 CA가 됩니다.
인증 기관 재정의는 현재 활발히 개발 중입니다. 릴리즈된 기능 집합은 안정적인 것으로 간주되지만, 이후 릴리즈에서 추가 CA 지원과 사용자 경험 개선이 계획되어 있습니다.
현재 구현에는 다음과 같은 제한 사항이 있습니다.
- 선택된 CA만 지원됩니다.
tctl get cas/windows는 자체 서명된 CA 인증서만 표시합니다.tctl auth export는 자체 서명된 CA 인증서만 내보냅니다.tctl auth rotate는 활성 재정의를 고려하지 않습니다. 관리자는 활성 재정의를 직접 추적하고 교체 과정의 적절한 단계에서 새 재정의를 수동으로 생성해야 합니다.
재정의 데이터를 가져오려면 tctl get ca_overrides를 사용하십시오.
작동 방식#
Teleport는 자체 서명된 인증서와 개인 키를 각각 가진 여러 CA를 유지합니다. CA 재정의는 자체 서명된 CA 인증서를 외부에서 서명한 인증서로 대체합니다.
Teleport는 CA 개인 키를 계속 관리합니다. 재정의 인증서는 기존 CA 공개 키를 대상으로 해야 하므로, 재정의에 사용할 CSR은 Teleport가 생성해야 합니다.
Teleport는 CA 인증서에 활성화된 재정의가 있으면 기존 개인 키로 새로 발급하는 자격 증명에 서명하고 재정의 인증서를 발급 CA 인증서로 사용합니다.
CA 재정의를 생성하려면 먼저 Teleport에서 CSR을 생성하고, 외부 CA로 해당
CSR에 서명한 다음, cert_authority_override 리소스를 생성해야 합니다.
cert_authority_override 리소스는 다음 필드로 대상 CA를 지정합니다.
sub_kind: 재정의할 CA 유형입니다(예:windows,db_client).metadata.name: Teleport 클러스터 이름입니다.
사전 요구사항#
-
실행 중인 Teleport Enterprise (v18.9.0 or higher) 클러스터. Teleport를 시작하려면 무료 체험판에 가입하거나 데모 환경을 구성하세요.
-
tctlandtshclients.Installing `tctl` and `tsh` clients
-
Teleport 클러스터의 버전을 확인합니다.
tctlandtshclients는 Teleport 클러스터 버전보다 최대 한 개의 메이저 버전까지만 뒤처질 수 있습니다. Proxy Service의/v1/webapi/find로 GET 요청을 보내고 JSON 쿼리 도구를 사용하여 클러스터 버전을 확인합니다.teleport.example.com:443를 Teleport Proxy Service의 웹 주소로 바꿉니다:$ TELEPORT_DOMAIN=teleport.example.com:443 $ TELEPORT_VERSION="$(curl -s https://$TELEPORT_DOMAIN/v1/webapi/find | jq -r '.server_version')" -
사용 중인 플랫폼에 대한 지침에 따라
tctlandtshclients를 설치합니다:
-
Mac
`tctl` and `tsh` clients가 포함된, 서명된 Teleport macOS .pkg 설치 프로그램을 다운로드합니다:
```code
$ curl -O https://cdn.teleport.dev/teleport-${TELEPORT_VERSION?}.pkg
```
Finder에서 `pkg` 파일을 더블 클릭하여 설치를 시작합니다.
Homebrew를 사용하여 Teleport를 설치하는 것은 지원되지 않습니다. Homebrew의
Teleport 패키지는 Teleport에서 유지 관리하지 않으므로 신뢰성이나 보안을
보장할 수 없습니다.
Windows - Powershell
```code
$ curl.exe -O https://cdn.teleport.dev/teleport-v${TELEPORT_VERSION?}-windows-amd64-bin.zip
# Unzip the archive and move the `tctl` and `tsh` clients to your %PATH%
# NOTE: Do not place the `tctl` and `tsh` clients in the System32 directory, as this can cause issues when using WinSCP.
# Use %SystemRoot% (C:\Windows) or %USERPROFILE% (C:\Users\<username>) instead.
```
Linux
Linux 설치판의 모든 Teleport 바이너리에는 `tctl` and `tsh` clients가 포함되어 있습니다. RPM/DEB
패키지 및 i386/ARM/ARM64용 다운로드를 포함한 더 많은 옵션은
[설치 페이지](../installation/installation.mdx)를 참조하세요.
```code
$ curl -O https://cdn.teleport.dev/teleport-v${TELEPORT_VERSION?}-linux-amd64-bin.tar.gz
$ tar -xzf teleport-v${TELEPORT_VERSION?}-linux-amd64-bin.tar.gz
$ cd teleport
$ sudo ./install
# Teleport binaries have been copied to /usr/local/bin
```
-
cert_authority_override리소스에 접근할 수 있는 역할을 가진 Teleport 사용자. 사전 설정된editor역할에는 이 접근 권한이 없습니다. 권한을 부여하려면 역할에 다음 규칙을 추가하십시오.kind: role version: v8 metadata: name: ca-override-admin spec: allow: rules: - resources: - cert_authority_override verbs: - create - delete - list - read - update<code>ca-override-admin</code>역할을 CA 재정의를 관리할 사용자에게 할당합니다. -
현재 지원되는 CA는
db_client와windows뿐입니다. -
모든 Auth Service 인스턴스와 Windows Desktop Service, Database Service 인스턴스 같은 관련 서비스는 CA 재정의를 인식하는 동일한 Teleport 버전으로 업그레이드해야 합니다.
-
안전을 위해 시작하기 전에 클러스터 상태를 백업하고, 업그레이드가 완전히 검증될 때까지 자체 서명된 CA 인증서에 대한 다운스트림 신뢰를 유지하십시오.
1/6단계. 재정의 인증서 CSR 준비#
windows CA를 예시로 사용합니다. 대상 CA에 맞게 바꾸십시오.
tctl로 CSR을 준비합니다.
$ tctl auth create-override-csr --type=windows
-----BEGIN CERTIFICATE REQUEST-----
(...)
-----END CERTIFICATE REQUEST-----
HSM 배포나 CA 교체 중처럼 활성 키나 추가 키가 여러 개 있으면 이 명령은
여러 개의 PEM을 출력합니다. --out 플래그를 사용하여 각 CSR을 별도의 파일로 출력할 수 있습니다.
인증서 주체(subject)를 사용자 지정할 수 있습니다.
$ tctl auth create-override-csr --type=windows --subject='OU=My Organization Unit,CN=My Windows CA'
Auth Service 인스턴스가 여러 개이고 인스턴스마다 별도의 HSM 키가 있는 클러스터에서는
create-override-csr 명령을 실행하기 전에 모든 Auth Service 인스턴스가 온라인이며
정상 상태인지 확인하십시오. Teleport는 온라인 상태인 모든 Auth Service 인스턴스에서
CSR을 자동으로 수집합니다.
2/6단계. 외부 CA로 재정의 인증서 발급#
1단계의 CSR을 사용하여 외부 CA로 재정의 인증서를 발급합니다.
인증서는 다음 요구사항을 충족해야 합니다.
- KeyUsage:
keyCertSign및cRLSign. - BasicConstraintsValid:
true. - IsCA:
true. - Subject: Teleport 클러스터 이름이
O필드(첫 번째 요소) 또는 OID1.3.9999.4.1에 있어야 합니다. 1단계의 CSR은 항상 유효한 주체를 가집니다.
3/6단계. 비활성화된 인증서 재정의 생성#
2단계에서 받은 인증서로 각 인증서에 대해 비활성화된 인증서 재정의를 생성합니다.
$ tctl auth create-override --disabled --type=windows cert.pem
인스턴스별 HSM 키를 사용하는 다중 Auth Service 클러스터#
Auth Service 인스턴스가 여러 개이고 인스턴스마다 별도의 HSM 키가 있는 클러스터에서는 각 Auth Service 인스턴스가 자신의 개인 키에만 접근할 수 있을 수 있습니다. 이 경우 모든 Auth Service 인스턴스가 온라인이며 정상 상태인지 확인한 다음 재정의를 비활성화된 상태로 생성합니다. Auth Service 인스턴스는 각자의 키에 대한 CRL에 백그라운드에서 자동으로 서명합니다.
# Create the override. Repeat for each certificate override.
$ tctl auth create-override --disabled --type=windows cert.pem
# Verify that CRLs are present.
$ tctl get ca_overrides/windows
4/6단계. 다운스트림 신뢰 구성#
2단계에서 받은 인증서로 진행하기 전에 다운스트림 신뢰를 구성합니다. 정상적인 클러스터 사용을 확인할 때까지 유예 기간 동안 자체 서명된 Teleport CA에 대한 신뢰를 유지할 것을 권장합니다.
CA별 안내는 아래를 참조하십시오.
db_client#
대부분의 데이터베이스는 외부 루트 CA와 중간 CA만 신뢰하면 됩니다. 재정의 CA 인증서를 직접 신뢰할 필요는 없습니다. 여기에는 MariaDB, MySQL, PostgreSQL, Redis, Oracle이 포함되지만 이에 한정되지 않습니다.
데이터베이스 문서를 확인하고, 통제된 환경에서 CA 재정의를 적용한 뒤 접근을 검증할 것을 권장합니다.
db_client - PKINIT 인증을 사용하는 Microsoft SQL Server#
PKINIT 인증을 사용하는 MSSQL Server를 구성하려면 다음을 수행해야 합니다.
-
도메인에서 요구하는 대로 CA 체인의 신뢰할 수 있는 루트와 중간 CA를 가져옵니다. 여기에는 재정의 CA 인증서가 포함됩니다.
-
재정의 CA 인증서를 NTAuth에 게시합니다.
-
재정의 CA CRL을 게시합니다.
이 단계 전에 CA 재정의가 존재해야 합니다. 각 인증서 재정의는 CRL을 생성해야 하며, 비동기 CRL 생성이 완료되었는지
tctl get ca_overrides/db_client로 확인하십시오.아래 명령을 실행하고 안내에 따르십시오.
$ tctl auth crl --type=db_client --out=./out Writing 2 files with prefix "./out" ./out-db_client-5b7ec7f7.crl ./out-db_client-override-5b7ec7f7.crl To publish CRLs, run the following in Windows: certutil -dspublish ./out-db_client-5b7ec7f7.crl TeleportDB "example.com" certutil -dspublish ./out-db_client-override-5b7ec7f7.crl TeleportDB "B4TK2353F87SEBD6J60P4N4IC8SVE5OH_example.com" -
각 인증서 재정의에 대해 전체 신뢰 체인(리프에서 루트까지)을
cert_authority_override리소스에 기술합니다. 이렇게 하면kinit이 자체 검증 단계를 통과할 수 있습니다.예를 들면 다음과 같습니다.
kind: cert_authority_override sub_kind: db_client version: v1 metadata: name: example.com spec: certificate_overrides: - certificate: |- -----BEGIN CERTIFICATE----- (override certificate) -----END CERTIFICATE----- chain: - |- -----BEGIN CERTIFICATE----- (intermediate 2) -----END CERTIFICATE----- - |- -----BEGIN CERTIFICATE----- (intermediate 1) -----END CERTIFICATE----- - |- -----BEGIN CERTIFICATE----- (root) -----END CERTIFICATE----- disabled: true전용
tctl authCA 재정의 명령 또는tctl edit으로 체인을 제공할 수 있습니다.tctl auth create-override --type=db-client \ --disabled \ cert.pem \ int2.pem \ int1.pem \ root.pem tctl auth update-override --type=db-client \ --public-key='public-key' \ --set-chain=int2.pem \ --set-chain=int1.pem \ --set-chain=root.pem tctl edit ca_overrides/db_client
windows#
구성은 AD 설정을 사용하는지 또는 로컬 설정을 사용하는지에 따라 달라집니다.
AD의 경우 도메인에서 요구하는 대로 CA 체인의 신뢰할 수 있는 루트와 중간 CA를 가져오고, 재정의 CA 인증서를 NTAuth에 직접 게시합니다.
도메인에 가입된 Windows 호스트에서 다음 명령을 실행하여 NTAuth 저장소에 재정의 CA 인증서가 포함되어 있는지 확인합니다.
$ certutil -viewstore -enterprise NTAuth
추가로 재정의 CA 체인을 확인합니다.
$ certutil -verify -urlfetch .\override.cer
로컬 설정의 경우 CA 체인을 로컬 컴퓨터의 "신뢰할 수 있는 루트 인증 기관" 및 "중간 인증 기관" 저장소에 적절히 가져옵니다. 외부에서 서명한 재정의 CA 인증서는 대개 중간 CA입니다.
재정의 CA 체인을 확인합니다.
$ certutil -verify -urlfetch .\override.cer
5/6단계. 인증서 재정의 활성화#
다운스트림 신뢰를 구성한 후 각 인증서 재정의에 대해 아래 명령을 실행하여 활성화합니다.
$ tctl auth update-override --type=windows --public-key=public-key --set-disabled=false
대상 재정의의 공개 키는 tctl auth pub-key-hash 명령으로 찾거나 cert_authority_override
리소스에서 읽어 확인할 수 있습니다.
tctl auth pub-key-hash 사용:
$ tctl auth pub-key-hash --cert=cert.pem
tctl get 사용:
$ tctl get ca_overrides/windows
또는 다음 명령으로 직접 편집할 수 있습니다.
$ tctl edit ca_overrides/windows
6/6단계. CA 재정의 동작 확인#
적절한 프로토콜(windows는 RDP, db_client는 tsh db connect 등)로
연결을 시도하여 재정의를 확인합니다.
windows CA를 예로 들면, Teleport Proxy에서 새 데스크톱 세션을 시작합니다.
다운스트림 신뢰가 올바르게 구성되었다면 세션이 정상적으로 시작되어야 합니다.
재정의가 사용되고 있는지 확인하려면 새 세션의 "Windows Desktop Session
Started" 이벤트를 검사합니다. "active": true와 해당 public_key_hash가 있는
"ca_override" 항목이 표시되어야 합니다. ("Database Session
Started" 이벤트도 비슷하게 변경됩니다.)
Session Started 이벤트 샘플
{
"ca_override": {
"active": true,
"public_key_hash": "f4522365888fdddcf3c854e79e5928447fe1a2388353efb2f0d30db8ba7c81bc"
},
"cluster_name": "mycluster",
"code": "TDP00I",
"desktop_name": "example-desktop",
"ei": 1,
"event": "windows.desktop.session.start",
"success": true
}