중요
MONGODB-AWS 인증 메커니즘 MongoDB 버전 4.4 이상에서만 사용할 수 있습니다.
개요
MONGODB-AWS 인증 메커니즘 Amazon Web Services ID 및 액세스 관리(Amazon Web Services IAM) 자격 증명 사용하여 MongoDB 에 사용자를 인증합니다. 이 메커니즘은 MongoDB Atlas 에 인증할 때만 사용할 수 있습니다.
팁
Amazon Web Services IAM 인증을 위한 Atlas 구성
Amazon Web Services IAM 인증 위한 MongoDB Atlas 구성에 대해 자세히 학습 Atlas 설명서에서 Amazon Web Services IAM으로 인증 설정을 참조하세요.
MONGODB-AWS 인증 지정
MONGODB-AWS 인증을 활성화한 상태로 MongoDB에 연결하려면 MONGODB-AWS 인증 메커니즘을 지정합니다.
운전자 나열된 순서대로 다음 소스에서 자격 자격 증명 확인합니다.
연결 문자열입니다.
사용자 지정 자격 증명 제공자. 자세히 알아보려면 사용자 지정 Amazon Web Services 자격 증명 제공자 지정을 참조하십시오.
환경 변수.
웹 ID 토큰 파일.
AWS_CONTAINER_CREDENTIALS_RELATIVE_URI환경 변수에 지정된 Amazon Web Services ECS 엔드포인트.Amazon Web Services EC2 엔드포인트. 자세한 학습 은 Amazon Web Services 문서에서 작업에 대한 IAM 역할 을 참조하세요.
중요
운전자 자격 증명 얻습니다. 예시 를 들어 연결 문자열 에 Amazon Web Services 자격 증명 지정하면 운전자 환경 변수에 지정한 모든 자격 증명 무시합니다.
팁
다음 예시에서는 SetAuth() 메서드를 사용하여 적절한 자격 증명을 설정합니다. ApplyURI() 메서드를 사용하여 이러한 자격 증명을 지정할 수도 있습니다. ApplyURI() 메서드를 사용하는 경우 사용자 이름과 비밀번호가 올바르게 구문 분석되도록 URL을 인코딩해야 합니다.
AWS IAM 자격 증명을 사용하여 MongoDB 인스턴스에 연결하려면 다음 단계를 수행하십시오.
AuthMechanism옵션에MONGODB-AWS값을 할당합니다.Username옵션에accessKeyID값을 할당합니다.Password옵션에secretAccessKey값을 할당합니다.
var accessKeyID, secretAccessKey stringawsCredential := options.Credential{ AuthMechanism: "MONGODB-AWS", AuthSource: "<authenticationDb>", Username: "<accessKeyID>", Password: "<secretAccessKey>",}
awsIAMClient, err := mongo.Connect(options.Client().SetAuth(awsCredential))if err != nil { panic(err)}_ = awsIAMClientAmazon Web Services 세션 토큰을 지정해야 하는 경우, 역할 요청 에서 반환된 임시 자격 증명 사용합니다.
임시 자격 증명을 사용하려면 AuthMechanismProperties 옵션에 sessionToken 값을 할당합니다.
var accessKeyID, secretAccessKey, sessionToken stringassumeRoleCredential := 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))환경 변수에 저장된 Amazon Web Services 자격 증명을 사용하여 MongoDB 인스턴스에 인증하려면 셸을 사용하여 다음과 같이 변수를 설정합니다.
export AWS_ACCESS_KEY_ID=<awsKeyId>export AWS_SECRET_ACCESS_KEY=<awsSecretKey>export AWS_SESSION_TOKEN=<awsSessionToken>참고
인증 대상 역할에 AWS 세션 토큰이 필요하지 않은 경우 AWS_SESSION_TOKEN이(가) 포함된 줄을 생략하세요.
위의 환경 변수를 설정한 후 다음 예와 같이 MONGODB-AWS 인증 메커니즘을 지정합니다.
envVariablesCredential := options.Credential{ AuthMechanism: "MONGODB-AWS",}
envVariablesClient, err := mongo.Connect(options.Client().SetAuth(envVariablesCredential))if err != nil { panic(err)}_ = envVariablesClient웹 자격 증명 공급자에서 얻은 OIDC(OpenID Connect) 토큰을 사용해 Amazon Elastic Kubernetes Service(EKS) 또는 기타 서비스에 인증할 수 있습니다. OIDC 토큰을 사용하려면 토큰이 포함된 파일을 생성하거나 찾으세요. 그 후, 다음과 같은 환경 변수를 설정하세요.
AWS_WEB_IDENTITY_TOKEN_FILE: OIDC 토큰이 포함된 파일 의 절대 경로로 설정합니다.AWS_ROLE_ARN: 클러스터 에 연결하는 데 사용되는 IAM 역할 로 설정합니다. 예시:arn:aws:iam::111122223333:role/my-role.
다음 셸 명령은 이러한 환경 변수를 설정합니다.
export AWS_WEB_IDENTITY_TOKEN_FILE=<absolute path to file that contains OIDC token>export AWS_ROLE_ARN=<IAM role name>위의 환경 변수를 설정한 후 다음 예시와 같이 MONGODB-AWS 인증 메커니즘을 지정합니다.
envVariablesCredential := options.Credential{ AuthMechanism: "MONGODB-AWS",}
envVariablesClient, err := mongo.Connect(options.Client().SetAuth(envVariablesCredential))if err != nil { panic(err)}_ = envVariablesClient사용자 지정 Amazon Web Services 자격 증명 제공자 지정
드라이버에 자체 Amazon Web Services 자격 증명 제공자를 제공하여 AWS SDK for Go v2의 전체 자격 증명 체인을 사용할 수 있습니다. Amazon EKS Pod Identity와 같이 드라이버의 내장 자격 증명 체인이 지원하지 않는 AWS 메커니즘을 사용하여 인증하는 경우 이 메서드를 사용하세요.
전제 조건
시작하기 전에 다음 항목이 준비되어 있는지 확인하세요.
Go 1.26 이상
Go 드라이버 v2.9 이상
참고
실험적 기능
ext/awsauth 모들은 사전 출시 버전입니다. 그 API는 불안정적이며 하위 호환성이 없는 방식으로 변경될 수 있습니다.
AWS SDK에서 자격 증명 제공자를 제공하려면 ext/awsauth 모듈과 Go v2용 AWS SDK를 설치합니다.
go get go.mongodb.org/mongo-driver/ext/awsauth github.com/aws/aws-sdk-go-v2/config다음 예시는 AWS SDK에서 AWS 인증 메커니즘으로 제공자 체인을 전달합니다.
awsConfig, err := config.LoadDefaultConfig(context.TODO())if err != nil { panic(err)}
awsSdkCredential := options.Credential{ AuthMechanism: "MONGODB-AWS", AWSCredentialsProvider: awsauth.NewCredentialsProvider(awsConfig.Credentials),}
awsSdkClient, err := mongo.Connect(options.Client().SetAuth(awsSdkCredential))if err != nil { panic(err)}_ = awsSdkClientAPI 문서
이 페이지에서 설명하는 메서드 또는 유형에 대해 자세히 학습 다음 API 설명서를 참조하세요.