Database V3 참조
Teleport v18.11요약
Kind: db Version: v3 db 리소스는 Teleport에 동적으로 등록된 데이터베이스를 나타냅니다. Teleport Database Service를 동적 리소스 감시자로 구성하면, 해당 서비스는 구성된 필터와 일치하는 db 리소스를 Teleport 백엔드에서 조회합니다.
Kind: db
Version: v3
db 리소스는 Teleport에 동적으로 등록된 데이터베이스를 나타냅니다.
Teleport Database Service를 동적 리소스 감시자로 구성하면, 해당 서비스는 구성된 필터와 일치하는 db 리소스를 Teleport 백엔드에서 조회합니다. 일치하는 각 db에 대해 Database Service는 대상 데이터베이스를 프록시하도록 구성된 db_server 리소스를 생성합니다.
db 리소스 사용에 대한 자세한 내용은 동적 데이터베이스 등록을 참조하십시오.
db_server 리소스에 대한 자세한 내용은 레퍼런스 가이드를 참조하십시오.
최상위 필드#
예시:
kind: "string"
sub_kind: "string"
version: "string"
metadata: # [...]
spec: # [...]
status: # [...]
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| kind | 데이터베이스 리소스 종류입니다. | string |
| metadata | 데이터베이스 메타데이터입니다. | Metadata |
| spec | 데이터베이스 스펙입니다. | Database Spec V3 |
| status | 데이터베이스 런타임 정보입니다. | Database Status V3 |
| sub_kind | 선택적 리소스 서브 종류입니다. | string |
| version | 리소스 버전입니다. 반드시 지정해야 합니다. 지원 값: v3. |
string |
AD#
Active Directory 관련 데이터베이스 구성을 포함합니다.
예시:
keytab_file: "string"
krb5_file: "string"
domain: "string"
spn: "string"
ldap_cert: "string"
kdc_host_name: "string"
ldap_service_account_name: "string"
ldap_service_account_sid: "string"
pki_domain: "string"
ldap_host: "string"
ldap_tls_server_name: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| domain | 데이터베이스가 속한 Active Directory 도메인입니다. | string |
| kdc_host_name | x509 인증에 사용하는 KDC의 호스트 이름입니다. | string |
| keytab_file | Kerberos keytab 파일의 경로입니다. | string |
| krb5_file | Kerberos 구성 파일의 경로입니다. 기본값은 /etc/krb5.conf입니다. | string |
| ldap_cert | Windows LDAP/AD의 인증서입니다. 선택 사항이며 x509 인증에만 사용합니다. | string |
| ldap_host | LDAP 쿼리에 사용하는 호스트이며, 포트를 포함할 수 있습니다. (선택 사항이며 기본값은 KDCHostName입니다. LDAP 서버와 KDC가 서로 다른 이름으로 접근되는 경우에 유용합니다.) | string |
| ldap_service_account_name | LDAP 쿼리를 수행하는 서비스 계정의 이름입니다. x509 인증/PKINIT에 필요합니다. | string |
| ldap_service_account_sid | LDAP 쿼리를 수행하는 서비스 계정의 SID입니다. x509 인증/PKINIT에 필요합니다. | string |
| ldap_tls_server_name | LDAP 서버와의 TLS 핸드셰이크에 사용하는 서버 이름입니다. (선택 사항이며 기본값은 LDAPHost의 호스트 부분이고, 없으면 KDCHostName을 사용합니다.) | string |
| pki_domain | CRL이 게시되는 Active Directory 도메인입니다. (선택 사항이며 기본값은 Domain입니다. PKI가 루트 도메인에 있지만 Teleport가 하위 도메인의 리소스에 접근하는 경우에 유용합니다.) | string |
| spn | 데이터베이스의 서비스 주체 이름입니다. | string |
AWS#
데이터베이스에 대한 AWS 메타데이터를 포함합니다.
예시:
region: "string"
redshift: # [...]
rds: # [...]
account_id: "string"
elasticache: # [...]
secret_store: # [...]
memorydb: # [...]
rdsproxy: # [...]
redshift_serverless: # [...]
external_id: "string"
assume_role_arn: "string"
opensearch: # [...]
iam_policy_status: # [...]
session_tags:
"string": "string"
"string": "string"
"string": "string"
docdb: # [...]
elasticache_serverless: # [...]
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| account_id | 이 데이터베이스가 속한 AWS 계정 ID입니다. | string |
| assume_role_arn | 데이터베이스에 접근할 때 수임할 AWS 역할 ARN입니다. 선택 사항입니다. 이 필드와 ExternalID를 설정하면 AWS 계정 간 접근을 활성화할 수 있습니다. | string |
| docdb | Amazon DocumentDB 관련 메타데이터를 포함합니다. | DocumentDB |
| elasticache | Amazon ElastiCache Redis 관련 메타데이터를 포함합니다. | ElastiCache |
| elasticache_serverless | Amazon ElastiCache Serverless 메타데이터를 포함합니다. | ElastiCache Serverless |
| external_id | AWS 계정 간에 AWS 역할을 수임할 수 있도록 하는 AWS External ID입니다. 선택 사항입니다. | string |
| iam_policy_status | 데이터베이스 접근을 위한 IAM 정책이 올바르게 구성되었는지 나타냅니다. 그렇지 않으면 사용자가 AWS 프로파일 ID를 업데이트하여 데이터베이스 접근을 허용해야 합니다. 예를 들어 RDS 데이터베이스의 경우 기반 AWS 프로파일이 해당 데이터베이스에 대해 rds-db:connect를 허용해야 합니다. |
IAM Policy Status |
| memorydb | AWS MemoryDB 관련 메타데이터를 포함합니다. | MemoryDB |
| opensearch | AWS OpenSearch 관련 메타데이터를 포함합니다. | OpenSearch |
| rds | RDS 관련 메타데이터를 포함합니다. | RDS |
| rdsproxy | AWS Proxy 관련 메타데이터를 포함합니다. | RDS Proxy |
| redshift | Redshift 관련 메타데이터를 포함합니다. | Redshift |
| redshift_serverless | Amazon Redshift Serverless 관련 메타데이터를 포함합니다. | Redshift Serverless |
| region | AWS 클라우드 리전입니다. | string |
| secret_store | 시크릿 저장소 구성을 포함합니다. | Secret Store |
| session_tags | AWS STS 세션 태그 목록입니다. | map[string]string |
AlloyDB#
AlloyDB 관련 구성 요소를 포함합니다.
예시:
endpoint_type: "string"
endpoint_override: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| endpoint_override | 사용할 엔드포인트 주소를 재정의하는 값입니다. | string |
| endpoint_type | 사용할 데이터베이스 엔드포인트 유형입니다. "private", "public", "psc" 중 하나여야 합니다. | string |
Azure#
Azure 관련 데이터베이스 메타데이터를 포함합니다.
예시:
name: "string"
resource_id: "string"
redis: # [...]
is_flexi_server: true
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| is_flexi_server | 데이터베이스가 Azure Flexible 서버이면 true입니다. | Boolean |
| name | Azure 데이터베이스 서버 이름입니다. | string |
| redis | Azure Cache for Redis 관련 데이터베이스 메타데이터를 포함합니다. | Azure Redis |
| resource_id | 리소스의 Azure 정규화 ID입니다. | string |
Azure Redis#
Azure Cache for Redis 관련 데이터베이스 메타데이터를 포함합니다.
예시:
clustering_policy: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| clustering_policy | Redis Enterprise의 클러스터링 정책입니다. | string |
Command Label V2#
hostname과 같은 명령을 실행해 생성된 출력 결과를 값으로 갖는 라벨입니다.
예시:
period: # [...]
command:
- "string"
- "string"
- "string"
result: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| command | 실행할 명령입니다. | []string |
| period | 명령 실행 간격입니다. | Duration |
| result | 표준 출력을 저장합니다. | string |
Database Admin User#
자동 사용자 프로비저닝에 사용하는 권한 있는 데이터베이스 사용자에 대한 정보를 포함합니다.
예시:
name: "string"
default_database: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| default_database | 권한 있는 데이터베이스 사용자가 기본으로 로그인하는 데이터베이스입니다. 데이터베이스 유형에 따라 이 데이터베이스는 데이터베이스 사용자를 관리하기 위한 프로시저나 데이터를 저장하는 데 사용될 수 있습니다. | string |
| name | 권한 있는 데이터베이스 사용자의 사용자 이름입니다. | string |
Database Spec V3#
데이터베이스 스펙입니다.
예시:
protocol: "string"
uri: "string"
ca_cert: "string"
dynamic_labels:
"string": # [...]
"string": # [...]
"string": # [...]
aws: # [...]
gcp: # [...]
azure: # [...]
tls: # [...]
ad: # [...]
mysql: # [...]
admin_user: # [...]
mongo_atlas: # [...]
oracle: # [...]
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| ad | 데이터베이스의 Active Directory 구성입니다. | AD |
| admin_user | 자동 사용자 프로비저닝에 사용하는 데이터베이스 관리자 사용자입니다. | Database Admin User |
| aws | RDS/Aurora/Redshift 데이터베이스에 대한 AWS 관련 설정을 포함합니다. | AWS |
| azure | Azure 관련 데이터베이스 메타데이터를 포함합니다. | Azure |
| ca_cert | PEM 인코딩된 데이터베이스 CA 인증서입니다. 더 이상 사용되지 않습니다. TLS.CACert로 이동했습니다. 10.0에서 삭제 예정입니다. | string |
| dynamic_labels | 데이터베이스 동적 라벨입니다. | map[string]Command Label V2 |
| gcp | GCP Cloud SQL 데이터베이스 관련 매개변수를 포함합니다. | GCP Cloud SQL |
| mongo_atlas | 데이터베이스에 대한 Atlas 메타데이터를 포함합니다. | Mongo Atlas |
| mysql | MySQL 데이터베이스 옵션을 담은 추가 섹션입니다. | MySQL Options |
| oracle | Oracle 구성 옵션을 담은 추가 섹션입니다. | Oracle Options |
| protocol | 데이터베이스 프로토콜입니다. postgres, mysql, mongodb 등이 있습니다. | string |
| tls | 대상 데이터베이스에 연결할 때 사용하는 TLS 구성입니다. 사용자 지정 CA 인증서를 제공하거나 서버 이름을 재정의할 수 있습니다. | Database TLS |
| uri | 데이터베이스 연결 엔드포인트입니다. | string |
Database Status V3#
데이터베이스에 대한 런타임 정보를 포함합니다.
예시:
ca_cert: "string"
aws: # [...]
mysql: # [...]
managed_users:
- "string"
- "string"
- "string"
azure: # [...]
vnet_dns_name: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| aws | 자동 검색된 AWS 클라우드 데이터베이스 메타데이터입니다. | AWS |
| azure | 자동 검색된 Azure 클라우드 데이터베이스 메타데이터입니다. | Azure |
| ca_cert | 자동으로 다운로드된 클라우드 데이터베이스 CA 인증서입니다. | string |
| managed_users | Teleport가 관리하는 데이터베이스 사용자 목록입니다. | []string |
| mysql | MySQL 런타임 데이터베이스 정보를 담은 추가 섹션입니다. | MySQL Options |
| vnet_dns_name | VNet이 데이터베이스 FQDN을 확인할 때 사용하는, 데이터베이스 이름의 DNS 안전 결정적 해시입니다. | string |
Database TLS#
TLS 구성 옵션을 포함합니다.
예시:
mode: # [...]
ca_cert: "string"
server_name: "string"
trust_system_cert_pool: true
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| ca_cert | 데이터베이스 TLS 연결을 검증하는 데 사용하는, 사용자가 제공한 선택적 CA 인증서입니다. | string |
| mode | TLS 연결 모드입니다. 0은 "verify-full", 1은 "verify-ca", 2는 "insecure"입니다. | Database TLS Mode |
| server_name | 사용자 지정 호스트 이름을 제공할 수 있습니다. 이 값은 검증 중에 인증서의 서버 이름/호스트 이름을 재정의합니다. | string |
| trust_system_cert_pool | Teleport가 호스트 시스템에서 사용 가능한 인증 기관을 신뢰하도록 허용합니다. 설정하지 않으면(기본값) Teleport는 Teleport의 Database Server CA 또는 이 TLS 설정에 지정된 ca_cert로 서명된 TLS 인증서를 가진 자체 서명 데이터베이스만 신뢰합니다. 클라우드에서 호스팅되는 데이터베이스의 경우 Teleport가 검증에 필요한 해당 CA를 다운로드합니다. | Boolean |
Database TLS Mode#
DB 에이전트가 데이터베이스에 연결할 때 수행하는 TLS 검증 수준을 나타냅니다.
DocumentDB#
Amazon DocumentDB 관련 메타데이터를 포함합니다.
예시:
cluster_id: "string"
instance_id: "string"
endpoint_type: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| cluster_id | 클러스터 식별자입니다. | string |
| endpoint_type | 엔드포인트 유형입니다. | string |
| instance_id | 인스턴스 식별자입니다. | string |
Duration#
사용자 지정 마샬/언마샬을 설정하기 위한 duration 래퍼입니다.
ElastiCache#
Amazon ElastiCache Redis 관련 메타데이터를 포함합니다.
예시:
replication_group_id: "string"
user_group_ids:
- "string"
- "string"
- "string"
transit_encryption_enabled: true
endpoint_type: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| endpoint_type | 엔드포인트 유형입니다. | string |
| replication_group_id | Redis 복제 그룹 ID입니다. | string |
| transit_encryption_enabled | 전송 중 암호화(TLS)가 활성화되어 있는지 나타냅니다. | Boolean |
| user_group_ids | 사용자 그룹 ID 목록입니다. | []string |
ElastiCache Serverless#
Amazon ElastiCache Serverless 메타데이터를 포함합니다.
예시:
cache_name: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| cache_name | ElastiCache Serverless 캐시 이름입니다. | string |
GCP Cloud SQL#
GCP 데이터베이스 관련 매개변수를 포함합니다. "GCPCloudSQL"이라는 이름은 GCP Cloud SQL만 지원하던 시절의 유산입니다.
예시:
project_id: "string"
instance_id: "string"
alloydb: # [...]
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| alloydb | AlloyDB 관련 구성 요소를 포함합니다. | AlloyDB |
| instance_id | Cloud SQL 인스턴스 ID입니다. | string |
| project_id | Cloud SQL 인스턴스가 속한 GCP 프로젝트 ID입니다. | string |
IAM Policy Status#
AWS 데이터베이스의 IAM 정책이 올바르게 구성되었는지 여부를 설명하는 상태를 나타냅니다. 이 열거형은 IAM 정책의 유효성을 확인하는 IAM 작업 중에 Sync.Map에 설정되며, 데이터베이스는 하트비트 중에 이 맵의 값으로 업데이트됩니다.
MemoryDB#
AWS MemoryDB 관련 메타데이터를 포함합니다.
예시:
cluster_name: "string"
acl_name: "string"
tls_enabled: true
endpoint_type: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| acl_name | 클러스터에 연결된 ACL의 이름입니다. | string |
| cluster_name | MemoryDB 클러스터의 이름입니다. | string |
| endpoint_type | 엔드포인트 유형입니다. | string |
| tls_enabled | 전송 중 암호화(TLS)가 활성화되어 있는지 나타냅니다. | Boolean |
Metadata#
리소스 메타데이터입니다.
예시:
name: "string"
description: "string"
labels:
"string": "string"
"string": "string"
"string": "string"
expires: # See description
revision: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| description | 오브젝트 설명입니다. | string |
| expires | 시스템의 모든 리소스에 설정할 수 있는 전역 만료 시간 헤더입니다. | |
| labels | 라벨 집합입니다. | map[string]string |
| name | 오브젝트 이름입니다. | string |
| revision | 시간에 따른 리소스의 버전을 추적하는 불투명 식별자입니다. 클라이언트는 이 값을 무시하고 변경해서는 안 되며, 리소스를 업데이트할 때는 반드시 이 revision을 그대로 반환해야 합니다. | string |
Mongo Atlas#
데이터베이스에 대한 Atlas 메타데이터를 포함합니다.
예시:
name: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| name | Atlas 데이터베이스 인스턴스 이름입니다. | string |
MySQL Options#
추가 MySQL 데이터베이스 옵션입니다.
예시:
server_version: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| server_version | 런타임 정보를 사용할 수 없을 때 DB 프록시가 보고하는 서버 버전입니다. | string |
OpenSearch#
AWS OpenSearch 관련 메타데이터를 포함합니다.
예시:
domain_name: "string"
domain_id: "string"
endpoint_type: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| domain_id | 도메인 ID입니다. | string |
| domain_name | 도메인 이름입니다. | string |
| endpoint_type | 엔드포인트 유형입니다. | string |
Oracle Options#
Oracle 관련 구성 옵션을 포함합니다.
예시:
audit_user: "string"
retry_count: 1
shuffle_hostnames: true
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| audit_user | 내부 감사 추적에 접근할 때 사용하는 Oracle 데이터베이스 사용자의 이름입니다. | string |
| retry_count | 실패 시 호스트에 연결을 다시 시도하는 최대 횟수입니다. 지정하지 않으면 기본값은 2이며, 총 3번 연결을 시도합니다. | number |
| shuffle_hostnames | true이면 제공된 목록에서 연결할 호스트의 순서를 무작위로 섞습니다. | Boolean |
RDS#
AWS RDS 관련 데이터베이스 메타데이터를 포함합니다.
예시:
instance_id: "string"
cluster_id: "string"
resource_id: "string"
iam_auth: true
subnets:
- "string"
- "string"
- "string"
vpc_id: "string"
security_groups:
- "string"
- "string"
- "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| cluster_id | RDS 클러스터(Aurora) 식별자입니다. | string |
| iam_auth | 데이터베이스 IAM 인증이 활성화되어 있는지 나타냅니다. | Boolean |
| instance_id | RDS 인스턴스 식별자입니다. | string |
| resource_id | RDS 인스턴스 리소스 식별자(db-xxx)입니다. | string |
| security_groups | RDS 인스턴스에 연결된 보안 그룹 목록입니다. | []string |
| subnets | RDS 인스턴스의 서브넷 목록입니다. | []string |
| vpc_id | RDS가 실행 중인 VPC입니다. | string |
RDS Proxy#
AWS RDS Proxy 관련 데이터베이스 메타데이터를 포함합니다.
예시:
name: "string"
custom_endpoint_name: "string"
resource_id: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| custom_endpoint_name | RDS Proxy 사용자 지정 엔드포인트의 식별자입니다. | string |
| name | RDS Proxy의 식별자입니다. | string |
| resource_id | RDS 인스턴스 리소스 식별자(prx-xxx)입니다. | string |
Redshift#
Amazon Redshift 관련 메타데이터를 포함합니다.
예시:
cluster_id: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| cluster_id | Redshift 클러스터 식별자입니다. | string |
Redshift Serverless#
Amazon Redshift Serverless 관련 메타데이터를 포함합니다.
예시:
workgroup_name: "string"
endpoint_name: "string"
workgroup_id: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| endpoint_name | VPC 엔드포인트 이름입니다. | string |
| workgroup_id | 워크그룹 ID입니다. | string |
| workgroup_name | 워크그룹 이름입니다. | string |
Secret Store#
시크릿 저장소 구성을 포함합니다.
예시:
key_prefix: "string"
kms_key_id: "string"
| 필드 이름 | 설명 | 타입 |
|---|---|---|
| key_prefix | 시크릿 키 접두사를 지정합니다. | string |
| kms_key_id | 암호화에 사용할 AWS KMS 키를 지정합니다. | string |