MongoDB Enterprise 는 다음을 지원합니다.
인증 요청을 LDAP(Lightweight Directory Access Protocol) 서비스로 프록시합니다.
LDAP 서버에 대한 단순 및 SASL 바인딩. MongoDB Enterprise는
saslauthd또는 운영 체제 라이브러리를 통해 LDAP 서버에 바인딩할 수 있습니다.
자세한 내용은 MongoDB Server 설명서의 LDAP 프록시 인증 및 LDAP 권한 부여 섹션을 참조하세요.
Kubernetes 연산자를 사용하여 MongoDB 배포에 연결하는 클라이언트 애플리케이션을 인증하도록 LDAP를 구성할 수 있습니다. 이 가이드에서는 클라이언트 애플리케이션에서 MongoDB 배포로 LDAP 인증을 구성하는 방법을 설명합니다.
참고
Kubernetes cluster에서 MongoDB의 독립형 인스턴스를 보호할 수 없습니다.
고려 사항
CustomResourceDefinitions에서 LDAP 구성하려면 Kubernetes Operator MongoDB 리소스 사양의
spec.security.authentication.ldap및 MongoDB Agent 와 관련된 기타 보안 LDAP 설정 아래의 매개변수를 사용합니다. 이 섹션의 절차에서는 필요한 설정을 설명하고 LDAP 구성의 예를 제공합니다.보안을 강화하려면 TLS 암호화된 복제본 세트 또는 TLS 암호화된 샤딩된 클러스터를 배포하는 것이 좋습니다. TLS를 사용한 암호화는 선택 사항입니다. 기본값으로 LDAP 트래픽은 평문으로 전송됩니다. 이는 사용자 이름과 비밀번호가 네트워크 위협에 노출되는 것을 의미합니다. Microsoft Active Directory와 같은 많은 현대 디렉토리 서비스에서는 암호화된 연결이 필요합니다. 사용자의 Kubernetes 연산자 MongoDB 배포서버에서 인증 요청을 암호화하기 위해 TLS 를 통한 LDAP 을 사용하는 것을 고려하세요.
일반 전제 조건
MongoDB deployment에 대한 LDAP 인증을 구성하기 전에 다음 작업을 완료하세요.
MongoDB Enterprise 데이터베이스 리소스를 배포해야 합니다. MongoDB Community 데이터베이스는 LDAP 인증을 지원하지 않습니다.
복제본 세트에 대한 LDAP 클라이언트 인증 구성
샘플 복제본 세트 리소스 복사합니다.
원하는 복제본 세트 구성과 일치하도록 이 YAML 파일의 설정을 변경합니다.
apiVersion: mongodb.com/v1kind: MongoDBmetadata: name: <my-replica-set>spec: members: 3 version: "8.0.0" opsManager: configMapRef: # Must match metadata.name in ConfigMap file name: <configMap.metadata.name> credentials: <mycredentials> type: ReplicaSet persistent: true security: tls: ca: <custom-ca> certsSecretPrefix: <prefix>복사한 예시 섹션을 기존 복제본 세트 리소스에 붙여넣습니다.
원하는 텍스트 편집기를 열고 섹션의 리소스 파일 끝에 객체 사양을 붙여넣습니다. spec
복제본 세트 리소스 에 대한 LDAP 설정을 구성합니다.
배포에서 LDAP 를 활성화하려면 Kubernetes 객체에서 다음 설정을 구성합니다.
키 | 유형 및 필요성 | 설명 | 예시 |
|---|---|---|---|
| 불리언, | LDAP 인증을 사용하려면 |
|
| string, | LDAP 서버에 연결할 때 MongoDB가 바인딩할 LDAP 고유 이름을 지정합니다. |
|
| string, | LDAP 서버 에 연결할 때 MongoDB 바인딩하는 LDAP 바인딩 고유 이름의 비밀번호가 포함된 시크릿 의 이름을 지정합니다. |
|
| string, | ConfigMap 추가 배포의 TLS 인증서에 서명하는 데 사용한 사용자 지정 CA 를 저장하는 의 이름입니다. |
|
| string, | LDAP 서버의 TLS 인증서의 유효성을 검사하는 CA 를 저장하는 필드 이름을 추가합니다. |
|
| 문자열 배열, | 하나 이상의 LDAP 서버의 |
|
| string, | LDAPS( TLS 를 통한 LDAP )를 사용하려면 |
|
| string, | 인증을 위해 자세한 학습 은 MongoDB Server 설명서의 |
|
| string, | LDAP를 통해 인증을 사용하려면 |
|
결과 구성은 다음 예시와 유사할 수 있습니다.
security: authentication: enabled: true # Enabled LDAP Authentication Mode modes: - "LDAP" - "SCRAM" # LDAP related configuration ldap: # Specify the hostname:port combination of one or # more LDAP servers servers: - "ldap1.example.com:636" - "ldap2.example.com:636"
# Set to "tls" to use LDAP over TLS. Leave blank if # the LDAP server doesn't accept TLS. You must enable TLS when you deploy the database resource to use this setting. transportSecurity: "tls"
# If TLS is enabled, add a reference to a ConfigMap that # contains a CA certificate that validates the LDAP server's # TLS certificate. caConfigMapRef: name: "<configmap-name>" key: "<configmap-entry-key>"
# Specify the LDAP Distinguished Name to which # MongoDB binds when connecting to the LDAP server bindQueryUser: "cn=admin,dc=example,dc=org"
# Specify the password with which MongoDB binds # when connecting to an LDAP server. This is a # reference to a Secret Kubernetes Object containing # one "password" key. bindQueryPasswordSecretRef: name: "<secret-name>"LDAP 설정의 전체 목록은 Kubernetes 연산자 MongoDB 리소스 사양의 보안 설정 을 참조하세요. LDAP 지원 Kubernetes 연산자 배포에서 MongoDB 에이전트 사용자에 대한 spec.security.authentication.agents.automationUserName 설정도 참조하세요.
MongoDB Agent의 LDAP 설정을 구성합니다.
Kubernetes 연산자 MongoDB 리소스 사양에서 Agent 관련 보안 설정 으로 MongoDB 리소스를 업데이트합니다 . 결과 구성은 다음 예시와 유사할 수 있습니다.
security: authentication: agents: automationPasswordSecretRef: key: automationConfigPassword name: automation-config-password automationUserName: mms-automation-agent clientCertificateSecretRef: name: agent-client-cert mode: LDAP enabled: true ldap: bindQueryPasswordSecretRef: name: bind-query-password bindQueryUser: cn=admin,dc=example,dc=org servers: - openldap.namespace.svc.cluster.local:389 userToDNMapping: '[{match: "(.+)",substitution: "uid={0},ou=groups,dc=example,dc=org"}]' modes: - LDAP - SCRAM requireClientTLSAuthentication: false복제본 세트 구성 파일 저장합니다.
복제본 세트 배포서버 에 변경 사항을 적용합니다.
다음 Kubernetes 명령을 호출하여 복제본 세트를 업데이트합니다.
kubectl apply -f <replica-set-conf>.yaml배포 상태를 추적합니다.
MongoDB 리소스의 상태를 확인하려면 다음 명령어를 사용하세요.
kubectl get mdb <resource-name> -o yaml -w-w(watch) 플래그 설정이 적용된 경우, 구성이 변경되면 상태 단계가 Running 상태를 달성할 때까지 출력이 즉시 새로 고침 됩니다. 리소스 배포 상태에 대해 자세히 알아보려면 Kubernetes Operator 문제 해결을 참조하세요.
샤드 cluster에 대한 LDAP 클라이언트 인증 구성
샘플 샤딩된 클러스터 리소스 를 복사합니다.
원하는 샤딩된 클러스터 구성에 맞게 이 YAML 파일의 설정을 변경합니다.
apiVersion: mongodb.com/v1kind: MongoDBmetadata: name: <my-sharded-cluster>spec: shardCount: 2 mongodsPerShardCount: 3 mongosCount: 2 configServerCount: 3 version: "8.0.0" opsManager: configMapRef: name: <configMap.metadata.name> # Must match metadata.name in ConfigMap file credentials: <mycredentials> type: ShardedCluster persistent: true security: tls: ca: <custom-ca> certsSecretPrefix: <prefix>복사한 예시 섹션을 기존 샤딩된 클러스터 리소스 에 붙여넣습니다.
원하는 텍스트 편집기를 열고 섹션의 리소스 파일 끝에 객체 사양을 붙여넣습니다. spec
샤딩된 클러스터 리소스 에 대한 LDAP 설정을 구성합니다.
배포에서 LDAP 를 활성화하려면 Kubernetes 객체에서 다음 설정을 구성합니다.
키 | 유형 및 필요성 | 설명 | 예시 |
|---|---|---|---|
| 불리언, | LDAP 인증을 사용하려면 |
|
| string, | LDAP 서버에 연결할 때 MongoDB가 바인딩할 LDAP 고유 이름을 지정합니다. |
|
| string, | LDAP 서버 에 연결할 때 MongoDB 바인딩하는 LDAP 바인딩 고유 이름의 비밀번호가 포함된 시크릿 의 이름을 지정합니다. |
|
| string, | ConfigMap 추가 배포의 TLS 인증서에 서명하는 데 사용한 사용자 지정 CA 를 저장하는 의 이름입니다. |
|
| string, | LDAP 서버의 TLS 인증서의 유효성을 검사하는 CA 를 저장하는 필드 이름을 추가합니다. |
|
| 문자열 배열, | 하나 이상의 LDAP 서버의 |
|
| string, | LDAPS( TLS 를 통한 LDAP )를 사용하려면 |
|
| string, | 인증을 위해 자세한 학습 은 MongoDB Server 설명서의 |
|
| string, | LDAP를 통해 인증을 사용하려면 |
|
결과 구성은 다음 예시와 유사할 수 있습니다.
security: authentication: enabled: true # Enabled LDAP Authentication Mode modes: - "LDAP" - "SCRAM" # LDAP related configuration ldap: # Specify the hostname:port combination of one or # more LDAP servers servers: - "ldap1.example.com:636" - "ldap2.example.com:636"
# Set to "tls" to use LDAP over TLS. Leave blank if # the LDAP server doesn't accept TLS. You must enable TLS when you deploy the database resource to use this setting. transportSecurity: "tls"
# If TLS is enabled, add a reference to a ConfigMap that # contains a CA certificate that validates the LDAP server's # TLS certificate. caConfigMapRef: name: "<configmap-name>" key: "<configmap-entry-key>"
# Specify the LDAP Distinguished Name to which # MongoDB binds when connecting to the LDAP server bindQueryUser: "cn=admin,dc=example,dc=org"
# Specify the password with which MongoDB binds # when connecting to an LDAP server. This is a # reference to a Secret Kubernetes Object containing # one "password" key. bindQueryPasswordSecretRef: name: "<secret-name>"LDAP 설정의 전체 목록은 Kubernetes 연산자 MongoDB 리소스 사양의 보안 설정 을 참조하세요. LDAP 지원 Kubernetes 연산자 배포에서 MongoDB 에이전트 사용자에 대한 spec.security.authentication.agents.automationUserName 설정도 참조하세요.
MongoDB Agent의 LDAP 설정을 구성합니다.
Kubernetes 연산자 MongoDB 리소스 사양에서 Agent 관련 보안 설정 으로 MongoDB 리소스를 업데이트합니다 . 결과 구성은 다음 예시와 유사할 수 있습니다.
security: authentication: agents: automationPasswordSecretRef: key: automationConfigPassword name: automation-config-password automationUserName: mms-automation-agent clientCertificateSecretRef: name: agent-client-cert mode: LDAP enabled: true ldap: bindQueryPasswordSecretRef: name: bind-query-password bindQueryUser: cn=admin,dc=example,dc=org servers: - openldap.namespace.svc.cluster.local:389 userToDNMapping: '[{match: "(.+)",substitution: "uid={0},ou=groups,dc=example,dc=org"}]' modes: - LDAP - SCRAM requireClientTLSAuthentication: false샤딩된 클러스터 구성 파일 저장합니다.
샤딩된 클러스터 배포서버 에 변경 사항을 적용합니다.
다음 Kubernetes 명령을 호출하여 샤드 클러스터를 업데이트합니다.
kubectl apply -f <sharded-cluster-conf>.yaml배포 상태를 추적합니다.
MongoDB 리소스의 상태를 확인하려면 다음 명령어를 사용하세요.
kubectl get mdb <resource-name> -o yaml -w-w(watch) 플래그 설정이 적용된 경우, 구성이 변경되면 상태 단계가 Running 상태를 달성할 때까지 출력이 즉시 새로 고침 됩니다. 리소스 배포 상태에 대해 자세히 알아보려면 Kubernetes Operator 문제 해결을 참조하세요.