인증 메커니즘.

규칙 예시

각 인증 메커니즘에는 다음과 같은 자리 표시자가 포함되어 있습니다.

• db_username - MongoDB 데이터베이스 사용자 이름

• db_password - MongoDB 데이터베이스 사용자의 비밀번호

• hostname - 클라이언트가 액세스할 수 있는 MongoDB 서버 네트워크 주소

• port - MongoDB 서버 포트 번호

• authenticationDb - 사용자의 인증 데이터가 포함된 MongoDB 데이터베이스. 이 옵션을 생략하면 드라이버는 기본값 admin을 사용합니다.

기본값

기본 메커니즘은 서버가 지원하는 MongoDB 버전에 따라 다음 인증 메커니즘 중 하나를 사용합니다.

기본 인증 메커니즘을 지정하려면 AuthMechanism 옵션을 생략합니다:

credential := options.Credential{
   AuthSource: "<authenticationDb>",
   Username: "<db_username>",
   Password: "<db_password>",
}
clientOpts := options.Client().ApplyURI("mongodb://<hostname>:<port>").
   SetAuth(credential)
client, err := mongo.Connect(clientOpts)

MongoDB가 지원하는 CR(챌린지-응답) 및 SCRAM(솔티드 챌린지-응답 인증 메커니즘)에 대한 자세한 내용은 MongoDB Server 매뉴얼의 SCRAM 섹션을 참조하세요.

SCRAM-SHA-256

SCRAM-SHA-256 SHA-256 알고리즘으로 암호화된 데이터베이스 사용자 이름과 비밀번호를 사용하여 사용자를 인증하는 솔트 SCRAM(Challenge-Response Authentication Mechanism)입니다.

SCRAM-SHA-256 인증 메커니즘을 지정하려면 AuthMechanism 옵션에 "SCRAM-SHA-256" 값을 할당합니다:

credential := options.Credential{
   AuthMechanism: "SCRAM-SHA-256",
   AuthSource: "<authenticationDb>",
   Username: "<db_username>",
   Password: "<db_password>",
}
clientOpts := options.Client().ApplyURI("mongodb://<hostname>:<port>").
   SetAuth(credential)
client, err := mongo.Connect(clientOpts)

SCRAM-SHA-1

SCRAM-SHA-1 SHA-1 알고리즘으로 암호화된 사용자 이름과 비밀번호를 사용하여 사용자를 인증하는 SCRAM(솔티드 챌린지-응답 메커니즘)입니다.

SCRAM-SHA-1 인증 메커니즘을 지정하려면 AuthMechanism 옵션에 "SCRAM-SHA-1" 값을 할당합니다:

credential := options.Credential{
   AuthMechanism: "SCRAM-SHA-1",
   AuthSource: "<authenticationDb>",
   Username: "<db_username>",
   Password: "<db_password>",
}
clientOpts := options.Client().ApplyURI("mongodb://<hostname>:<port>").
   SetAuth(credential)
client, err := mongo.Connect(clientOpts)

MONGODB-CR

MONGODB-CR 사용자 이름과 비밀번호를 사용하여 사용자를 인증하는 과제-응답 인증 메커니즘입니다.

MONGODB-AWS

MONGODB-AWS 인증 메커니즘은 AWS IAM(Amazon Web Services Identity and Access Management) 자격 증명을 사용해 사용자를 인증합니다.

MONGODB-AWS 인증을 활성화한 상태로 MongoDB에 연결하려면 MONGODB-AWS 인증 메커니즘을 지정합니다.

운전자 나열된 순서대로 다음 소스에서 자격 자격 증명 확인합니다.

1. 연결 문자열입니다.

2. 환경 변수.

3. 웹 ID 토큰 파일.

4. AWS_CONTAINER_CREDENTIALS_RELATIVE_URI 환경 변수에 지정된 Amazon Web Services ECS 엔드포인트.

5. AWS EC2 엔드포인트. 자세한 학습 은 AWS 설명서에서 작업에 대한 IAM 역할 을 참조하세요.

var accessKeyID, secretAccessKey string
awsCredential := options.Credential{
	AuthMechanism: "MONGODB-AWS",
	AuthSource:    "<authenticationDb>",
	Username:      "<accessKeyID>",
	Password:      "<secretAccessKey>",
}
awsIAMClient, err := mongo.Connect(options.Client().SetAuth(awsCredential))
if err != nil {
	panic(err)
}
_ = awsIAMClient

var accessKeyID, secretAccessKey, sessionToken string
assumeRoleCredential := options.Credential{
	AuthMechanism: "MONGODB-AWS",
	AuthSource:    "<authenticationDb>",
	Username:      "<accessKeyID>",
	Password:      "<secretAccessKey>",
	AuthMechanismProperties: map[string]string{
		"AWS_SESSION_TOKEN": "<sessionToken>",
	},
}
assumeRoleClient, err := mongo.Connect(options.Client().SetAuth(assumeRoleCredential))

export AWS_ACCESS_KEY_ID=<awsKeyId>
export AWS_SECRET_ACCESS_KEY=<awsSecretKey>
export AWS_SESSION_TOKEN=<awsSessionToken>

envVariablesCredential := options.Credential{
	AuthMechanism: "MONGODB-AWS",
}
envVariablesClient, err := mongo.Connect(options.Client().SetAuth(envVariablesCredential))
if err != nil {
	panic(err)
}
_ = envVariablesClient

export AWS_WEB_IDENTITY_TOKEN_FILE=<absolute path to file that contains OIDC token>
export AWS_ROLE_ARN=<IAM role name>

envVariablesCredential := options.Credential{
	AuthMechanism: "MONGODB-AWS",
}
envVariablesClient, err := mongo.Connect(options.Client().SetAuth(envVariablesCredential))
if err != nil {
	panic(err)
}
_ = envVariablesClient

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)