AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

SQL 인터페이스 인증

SQL 인터페이스는 MongoDB 배포서버에 연결하기 위해 여러 인증 메커니즘을 지원합니다. 이 페이지에는 Atlas 전용 클러스터, Atlas 연합 데이터베이스 인스턴스 및 자체 관리형 MongoDB Enterprise 배포서버에 대한 지원되는 인증 방법, 컴포넌트 호환성 및 배포 가용성이 포함됩니다.

다음 표는 각 SQL 인터페이스 구성 요소에서 지원하는 인증 메커니즘을 보여줍니다.

구성 요소
SCRAM
X.509
LDAP
GSSAPI
AWS IAM
OIDC

MongoDB SQL 스키마 빌더

예

예

예

예

예

예

ODBC 드라이버

예

예

예

예

예

예

JDBC 드라이버

예

예

예

예

예

예

Power BI 데스크톱

예

예

예

예

예

예

Power BI 게이트웨이

예

No

No

No

No

No

Tableau Desktop

예

예

예

예

예

예

Tableau 서버

예

예

No

No

No

No

Tableau 클라우드

예

No

No

No

No

No

참고

모든 제3자 BI 도구가 이러한 인증 옵션을 지원하는 것은 아닙니다. 이들이 MongoDB 드라이버에서는 지원되지만 말입니다. 특정 BI 도구와 함께 작동하는지 확인하려면 사용하려는 기능을 테스트합니다.

다음 표는 각 MongoDB 배포서버 유형에 사용할 수 있는 인증 메커니즘을 보여줍니다.

인증 메커니즘
전용 클러스터
연합 데이터베이스 인스턴스

SCRAM

예

예

예

X.509

예

예

예

LDAP

예

No

예

Kerberos(GSSAPI)

No

No

예

AWS IAM

예

예

No

OIDC

예

예

예

중요

MongoDB 8.0 버전부터, LDAP 인증 및 권한 부여는 더 이상 지원되지 않습니다. LDAP은 MongoDB 8 전체에 걸쳐 계속 사용할 수 있으며 변경 없이 계속 작동합니다. 하지만 향후 주요 릴리스에서 제거됩니다. OIDC 또는 다른 지원되는 인증 메커니즘으로 마이그레이션하는 것을 고려해 보세요. 자세한 내용은 LDAP 사용 중단을 참조하세요.

MongoDB JDBC 드라이버는 MongoDB가 지원하는 모든 인증 메커니즘을 지원합니다. 자세한 내용은 인증 메커니즘을 참조하세요. 구성하면 드라이버도 TLS/SSL 연결을 지원합니다. 더 자세히 알아보려면 TLS/SSL 구성. 참조하세요.

다음 섹션에서는 JDBC 드라이버에 대한 X., Kerberos (GSSAPI) 및 OIDC 인증을 구성하는 연결 속성에 대해509 설명합니다. 이러한 속성은 Atlas 및 자체 관리형 MongoDB Enterprise 배포서버 모두에 적용됩니다.

MongoDB JDBC 드라이버는 X.509 클라이언트 인증서 인증을 지원합니다. 다음 속성은 드라이버가 클라이언트 인증서와 CA 신뢰를 구성하는 방식을 제어합니다.

속성
목적

x509pempath

클라이언트 인증서와 개인 키가 포함된 PEM 파일의 경로. 암호화되지 않은 키 또는 암호화된 PKCS #1 및 PKCS #8 키에 필요합니다.

tlscafile

선택 사항입니다. 하나 이상의 신뢰할 수 있는 X.509 인증서가 포함된 PEM 파일의 경로. 설정되면, 드라이버는 이 CA에서 서명한 인증서만 허용합니다.

password

x509pempath을 설정하는지 여부에 따라 다른 목적을 수행합니다. x509pempath을 설정하면 password가 암호화된 PEM 파일의 암호구입니다. x509pempath을(를) 설정하지 않은 경우, password 에는 암호화되지 않은 인증서와 개인 키로 구성된 원시 PEM 콘텐트가 포함될 수 있습니다. 또는 암호화된 PEM 데이터에 대한 {"pem": "...", "passphrase": "..."} 형식의 JSON 객체가 포함될 수 있습니다.

X.509 인증을 구성할 때 다음 동작을 고려하세요.

  • x509pempath을 설정하면 password 속성의 모든 PEM 콘텐트보다 우선시됩니다.

  • tlscafile을(를) 설정하지 않을 경우, 드라이버는 기본값 JVM 트러스트어를 사용합니다.

  • PEM 컨텐츠에는 클라이언트 인증서와 해당 개인 키가 모두 포함되어 있어야 합니다. 제공 방식이 x509pempath을 통하든 password 속성에서 제공하든 상관없이.

MongoDB JDBC 드라이버는 Kerberos 기반 인증을 위해 GSSAPI를 지원합니다. 이 메카니즘은 드라이버 외부에서 Kerberos 및 JAAS 설정을 구성해야 합니다. 다음 속성은 드라이버가 해당 구성을 사용하는 방식을 제어합니다.

속성
설명

jaasconfigpath

JAAS 설정 파일의 경로(jaas.config 등)입니다. 이 속성을 설정하지 않으면 드라이버는 기본값 JVM JAAS 구성을 사용합니다.

gssapilogincontextname

JAAS 구성에 정의된 로그인 컨텍스트 이름을 지정합니다.

gssapiserverauth

true으로 설정하면 SASL 협상 동안 서버 인증을 활성화합니다.

gssnativemode

드라이버가 네이티브 GSSAPI 라이브러리를 사용하는지 여부를 제어합니다. 허용되는 값은 true 또는 false입니다.

MongoDB JDBC 드라이버는 설정한 인증 메커니즘 속성에 따라 사람이 시작한 OIDC 플로와 기계가 자동화한 OIDC 플로를 구분합니다.

  • 인간 흐름: 기본값 동작. 브라우저 로그인을 통한 사용자 상호 작용이 필요합니다.

  • 기계 플로: GCP 워크로드 아이덴티, Azure Managed Identity 및 Kubernetes 같은 자동화된 환경에서 사용됩니다. 기계 플로우를 활성화하려면 ENVIRONMENT 및 TOKEN_RESOURCE 매개변수를 설정합니다.

SQL 인터페이스에 대한 인증 구성할 때는 다음 보안 권장사항 고려하세요.

  • 강력한 인증 메커니즘 사용: 가능한 경우 암호 기반 인증보다 X.509, OIDC 또는 Kerberos를 사용하세요.

  • TLS 암호화 활성화: 항상 TLS를 사용하여 전송 중인 자격 증명 과 데이터를 보호합니다.

  • 최소 권한 원칙 준수: 사용자에게 작업에 필요한 최소한의 권한만 부여합니다.

  • 보안 자격 증명 저장: 연결 문자열에 자격 증명 하드코딩하지 않습니다. 환경 변수, 자격 증명 파일 또는 보안 자격 증명 관리 시스템을 사용합니다.

  • 정기적인 자격 증명 교체: 비밀번호와 인증서의 정기적인 교체를 구현합니다.

  • 인증 이벤트 모니터링: 감사 로깅을 활성화하여 인증 시도 및 실패를 추적 .