X.509 클라이언트 인증서는 데이터베이스 사용자에게 프로젝트의 데이터베이스 배포에 대한 액세스를 제공합니다. Atlas Kubernetes Operator를 사용하여 AtlasProject 사용자 지정 리소스 및 AtlasDatabaseUser 사용자 지정 리소스에 대해 X.509 인증을 활성화할 수 있습니다.
Options for X.509 authentication include Atlas-managed X.509 authentication and self-managed X.509 authentication. To learn more about self-managed X.509 authentication, see Set Up Self-Managed X.509 Certificates.
X.509 인증을 설정하려면 다음을 수행합니다.
X.509 인증서를 생성합니다.
인증서를 사용하도록
AtlasProject사용자 지정 리소스 를 구성합니다.Atlas managed 또는 자체 managed X.509 인증을 사용하도록
AtlasDatabaseUser사용자 지정 리소스 를 구성합니다.
전제 조건
참고
자체 관리형 X.509 인증서를 사용하려면 MongoDB Atlas와 통합할 공개 키 인프라가 있어야 합니다.
Atlas에 대한 Atlas Kubernetes Operator 액세스 권한을 구성하려면 다음의 공개 API 키, 비공개 API 키 및 조직 ID 정보가 필요합니다.
Atlas Kubernetes Operator 가 새 Atlas 프로젝트 를 생성하도록 하려면Grant Programmatic Access to an Organization(조직에 프로그래밍 방식 액세스 권한을 부여합니다)을 클릭합니다. 조직 에서 Atlas 관리 API 에 대한 IP 액세스 목록 이 필요한 경우 API 액세스 목록도 구성해야 합니다.
중요
API 키를 Organization Project Creator 조직 역할 이상으로 할당해야 합니다.
기존 Atlas 프로젝트 로 작업하려면 프로젝트에서 프로젝트액세스를 추가합니다. 조직 에서 Atlas 관리 API 에 대한 IP 액세스 목록 이 필요한 경우 API 액세스 목록도 구성해야 합니다.
중요
API 키에 Project Owner 프로젝트 역할을 할당해야 합니다.
자세히 알아보려면 Atlas에 대한 액세스 구성을 참조하세요.
Generate an X.509 certificate with cert-manager or the create_X.509.go script.
cert-manager를 사용하여 X.509 인증서 생성
cert-manager를 사용하여 X.509 인증서를 생성하려면 다음 단계를 수행합니다.
사용자 지정 스크립트로 X.509 인증서 생성
create_X..go를509 사용하여 X.509 인증서를 생성하려면 스크립트 에서 다음 단계를 수행합니다.
사용자 지정 스크립트를 실행합니다.
create_X.509.go 를 실행합니다. 스크립트:
go run scripts/create_x509.go --path={pem-file-path}
예시:
go run scripts/create_x509.go --path=tmp/x509/
시크릿에 인증서를 추가합니다.
kubectl create secret generic {secret-name} --from-file={pem-file-directory}
kubectl label secret {secret-name} atlas.mongodb.com/type=credentials
예시:
kubectl create secret generic my-x509-cert --from-file=./tmp/x509/cert.pem
kubectl label secret my-x509-cert atlas.mongodb.com/type=credentials
절차
인증서를 사용하도록 프로젝트를 구성합니다.
사용자 지정 리소스 에 대한 spec.x509CertRef.name 매개변수 AtlasProject 내에 시크릿 을 지정합니다.
예시:
cat <<EOF | kubectl apply -f - apiVersion: atlas.mongodb.com/v1 kind: AtlasProject metadata: name: my-project spec: name: Test Project projectIpAccessList: - ipAddress: "192.0.2.15" comment: "IP address for Application Server A" - cidrBlock: "203.0.113.0/24" comment: "CIDR block for Application Servers B - D" x509CertRef: name: my-x509-cert EOF
X.509 인증을 사용하는 데이터베이스 사용자를 추가합니다.
AtlasDatabaseUser 사용자 지정 리소스에 대한 x509Type 매개 변수를 지정합니다.
이 매개 변수는 다음을 허용합니다.
none | X.509 인증을 사용하지 않는 사용자입니다. |
MANAGED | Atlas managed X.509를 사용하는 사용자입니다.
|
CUSTOMER | 자체 관리형 X.509를 사용하는 사용자입니다. 이
|
To learn more about the configuration parameters available from the API, see the Atlas Database Users API.
예시:
cat <<EOF | kubectl apply -f - apiVersion: atlas.mongodb.com/v1 kind: AtlasDatabaseUser metadata: name: my-database-user spec: username: CN=my-x509-authenticated-user,OU=organizationalunit,O=organization databaseName: "\$external" x509Type: "CUSTOMER" roles: - roleName: "readWriteAnyDatabase" databaseName: "admin" projectRef: name: my-project EOF