身份验证机制

示例规则

每种身份验证机制都包含以下占位符：

• db_username - 您的 MongoDB 数据库用户名

• db_password - 您的 MongoDB 数据库用户的密码

• hostname - 您的 MongoDB 服务器网络地址（可由您的客户访问）

• port - 您的 MongoDB Server 端口号

• 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(context.TODO(), clientOpts)

如要进一步了解有关 MongoDB 支持的质询-响应 (CR) 和 salted 质询-响应身份验证机制 (SCRAM) ，请参阅 server 手册的 SCRAM 部分。

SCRAM-SHA-256

SCRAM-SHA-256 是一种Salted 挑战响应身份验证机制 (SCRAM)，即使用通过 SHA-256 算法加密的数据库用户名和密码来验证用户身份。

要指定 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(context.TODO(), clientOpts)

SCRAM-SHA-1

SCRAM-SHA-1 是一种盐化质询-响应机制 (SCRAM)，它使用您的用户名和密码，并使用 SHA-1 算法加密，来对您的用户进行身份验证。

要指定 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(context.TODO(), clientOpts)

MONGODB-CR

MONGODB-CR 是一种挑战-响应身份验证机制，它使用您的用户名和密码 来验证您的用户。

MONGODB-AWS

MONGODB-AWS 身份验证机制使用 Amazon Web Services Identity and Access Management (AWS IAM) 档案对用户进行身份验证。

要连接到启用了 MONGODB-AWS 身份验证的 MongoDB 实例，请指定 MONGODB-AWS 身份验证机制。

The driver checks for your credentials in the following sources in the order listed:

1. Connection string.

2. 环境变量。

3. Web 身份令牌文件。

4. AWS_CONTAINER_CREDENTIALS_RELATIVE_URI 环境变量中指定的Amazon Web Services ECS 端点。

5. AWS EC2 endpoint. To learn more, see IAM Roles for Tasks in the AWS documentation.

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

X.509

X.509 身份验证机制使用 TLS 以及 X.509 证书对用户进行身份验证，并由客户端证书的相对标识名 (RDN) 进行标识。当您指定 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)