인증 메커니즘.
개요
이 가이드에서는 MongoDB 커뮤니티 에디션에서 사용할 수 있는 각 인증 메커니즘을 사용하는 방법을 배울 수 있습니다. MongoDB는 인증 메커니즘을 사용하여 ID를 확인하고 신뢰를 구축하여 연결하기 전에 드라이버와 서버의 보안을 보장합니다.
GSSAPI/Kerberos 또는 LDAP 를 사용하여 인증하려면 엔터프라이즈 인증 메커니즘 기본 사항 페이지를 참조하세요. MongoDB 클러스터에 대한 연결 설정에 대해 자세히 알아보려면 연결 가이드를 참조하세요.
지원되는 메커니즘
고(Go) 드라이버는 다음과 같은 인증 메커니즘을 지원합니다:
Go 드라이버는 클라이언트 유형을 통해 인증 메커니즘과 연결을 설정합니다. Client 유형은 자격 증명 유형에서 연결 옵션으로 사용할 메커니즘과 자격 증명을 지정합니다. 이러한 옵션을 구성하려면 Credential 유형을 ClientOptions 유형의 SetAuth() 메서드에 전달합니다.
다음 섹션에서는 MongoDB Community Edition이 지원하는 5가지 메커니즘을 사용하여 이 프로세스를 보여 줍니다.
규칙 예시
각 인증 메커니즘에는 다음과 같은 자리 표시자가 포함되어 있습니다.
username- MongoDB 사용자 이름password- MongoDB 사용자 비밀번호hostname- 클라이언트가 액세스할 수 있는 MongoDB 서버 네트워크 주소port- MongoDB 서버 포트 번호authenticationDb- 사용자의 인증 데이터가 포함된 MongoDB 데이터베이스. 이 옵션을 생략하면 드라이버는 기본값admin을 사용합니다.
기본값
기본 메커니즘은 서버가 지원하는 MongoDB 버전에 따라 다음 인증 메커니즘 중 하나를 사용합니다.
메커니즘 | 버전 |
|---|---|
SCRAM-SHA-256 | MongoDB 4.0 이상 |
SCRAM-SHA-1 | MongoDB 3.0, 3.2, 3.4, 3.6 |
MONGODB-CR | MongoDB 2.6 및 이전 버전 |
기본 인증 메커니즘을 지정하려면 AuthMechanism 옵션을 생략합니다:
credential := options.Credential{ AuthSource: "<authenticationDb>", Username: "<username>", Password: "<password>", } clientOpts := options.Client().ApplyURI("mongodb://<hostname>:<port>"). SetAuth(credential) client, err := mongo.Connect(context.TODO(), clientOpts)
MongoDB가 지원하는 챌린지-응답(CR) 및 솔티드 챌린지-응답 인증 메커니즘(SCRAM)에 대해 자세히 알아보려면 서버 매뉴얼의 SCRAM 섹션을 참조하세요.
SCRAM-SHA-256
중요
SCRAM-SHA-256 MongoDB 4.0부터 지원되는 MongoDB의 기본 인증 방법입니다.
SCRAM-SHA-256 SHA-256 알고리즘으로 암호화된 사용자 이름과 비밀번호를 사용하여 사용자를 인증하는 SCRAM(솔티드 챌린지-응답 인증 메커니즘)입니다.
SCRAM-SHA-256 인증 메커니즘을 지정하려면 AuthMechanism 옵션에 "SCRAM-SHA-256" 값을 할당합니다:
credential := options.Credential{ AuthMechanism: "SCRAM-SHA-256", AuthSource: "<authenticationDb>", Username: "<username>", Password: "<password>", } clientOpts := options.Client().ApplyURI("mongodb://<hostname>:<port>"). SetAuth(credential) client, err := mongo.Connect(context.TODO(), clientOpts)
SCRAM-SHA-1
중요
SCRAM-SHA-1 MongoDB 버전 3.0, 3.2, 3.4, 3.6의 기본 인증 방법입니다.
SCRAM-SHA-1 SHA-1 알고리즘으로 암호화된 사용자 이름과 비밀번호를 사용하여 사용자를 인증하는 SCRAM(솔티드 챌린지-응답 메커니즘)입니다.
SCRAM-SHA-1 인증 메커니즘을 지정하려면 AuthMechanism 옵션에 "SCRAM-SHA-1" 값을 할당합니다:
credential := options.Credential{ AuthMechanism: "SCRAM-SHA-1", AuthSource: "<authenticationDb>", Username: "<username>", Password: "<password>", } clientOpts := options.Client().ApplyURI("mongodb://<hostname>:<port>"). SetAuth(credential) client, err := mongo.Connect(context.TODO(), clientOpts)
MONGODB-CR
MONGODB-CR 사용자 이름과 비밀번호를 사용하여 사용자를 인증하는 과제-응답 인증 메커니즘입니다.
중요
이 인증 메커니즘은 MongoDB 3.6부터 사용되지 않으며 MongoDB 4.0부터 더 이상 지원되지 않습니다.
MONGODB-AWS
중요
MONGODB-AWS 인증 메커니즘은 MongoDB 버전 4.4 이상에서만 사용할 수 있습니다.
MONGODB-AWS 인증 메커니즘은 AWS IAM(Amazon Web Services Identity and Access Management) 자격 증명을 사용해 사용자를 인증합니다.
MONGODB-AWS 인증을 활성화한 상태로 MongoDB에 연결하려면 MONGODB-AWS 인증 메커니즘을 지정합니다.
드라이버는 나열된 순서대로 다음 소스에서 자격 증명을 확인합니다.
연결 문자열
환경 변수
웹 ID 토큰 파일
AWS_CONTAINER_CREDENTIALS_RELATIVE_URI환경 변수 AWS EC2 엔드포인트에 지정된AWS EC2 엔드포인트. 자세한 내용은 작업에 대한 IAM 역할을 참조하세요.
중요
드라이버는 자격 증명이 발견된 첫 번째 소스에서만 자격 증명을 얻습니다. 예를 들어 연결 문자열에 AWS 자격 증명을 지정하면 드라이버는 환경 변수에 지정한 모든 자격 증명을 무시합니다.
X.509
X.509 인증 메커니즘은 클라이언트 인증서의 RDN(상대적 고유 이름)으로 식별되는 사용자를 인증하기 위해 X.509 인증서가 있는 TLS를 사용합니다. X.509 인증 메커니즘을 지정하면 서버는 다음 파일의 경로를 사용하여 연결을 인증합니다.
tlsCAFile여기에는 TLS 연결을 만들 때 신뢰할 수 있는 단일 인증 기관 또는 다수 인증 기관이 포함됩니다.tlsCertificateKeyFile클라이언트 인증서 파일 또는 클라이언트 비공개 키 파일의 경로를 참고합니다.
X.509 인증 메커니즘을 지정하려면 다음을 수행합니다:
연결 문자열에서 해당 파일의 경로를
tlsCAFile에 할당합니다.연결 문자열에서 해당 파일의 경로를
tlsCertificateKeyFile에 할당합니다.AuthMechanism옵션에"MONGODB-X509"값을 할당합니다.
caFilePath := "<cafile_path>" certificateKeyFilePath := "<client_certificate_path>" uri := "mongodb://<hostname>:<port>/?tlsCAFile=%s&tlsCertificateKeyFile=%s" uri = fmt.Sprintf(uri, caFilePath, certificateKeyFilePath) credential := options.Credential{ AuthMechanism: "MONGODB-X509", } clientOpts := options.Client().ApplyURI(uri).SetAuth(credential)