인증 메커니즘.

MongoDB\Client 자격 증명

먼저 운전자 는 AWS 자격 증명 을 연결 URI 또는 $uriOptions 배열 매개변수의 일부로 MongoDB\Client 생성자에 전달했는지 확인합니다. 자격 증명 을 MongoDB\Client 에 전달하려면 다음 연결 옵션을 설정하다 합니다.

• username: 인증할 Amazon Web Services IAM 액세스 키 ID 입니다. 이 값을 연결 URI에 포함하기 전에 퍼센트 인코딩합니다.

• password: Amazon Web Services IAM 시크릿 액세스 키입니다. 이 값을 연결 URI에 포함하기 전에 퍼센트 인코딩합니다.

• authMechanism: 'MONGODB-AWS' 로 설정합니다.

옵션 배열 을 MongoDB\Client 생성자에 전달하거나 연결 URI의 매개변수를 통해 두 가지 방법으로 이러한 옵션을 설정하다 수 있습니다.

$uriOptions = [
    'username' => '<AWS IAM access key ID>',
    'password' => '<AWS IAM secret access key>',
    'authMechanism' => 'MONGODB-AWS',
];
$client = new MongoDB\Client(
    'mongodb://<hostname>:<port>',
    $uriOptions,
);

$uri = 'mongodb://<AWS IAM access key ID>:<AWS IAM secret access key>@<hostname>:<port>/?authMechanism=MONGODB-AWS';
$client = new MongoDB\Client($uri);

환경 변수

MongoDB\Client 객체 를 구성할 때 사용자 이름 과 비밀번호를 제공하지 않으면 운전자 는 다음 환경 변수에서 AWS 자격 증명 을 조회 하려고 시도합니다.

• AWS_ACCESS_KEY_ID

• AWS_SECRET_ACCESS_KEY

• AWS_SESSION_TOKEN

이러한 환경 변수를 사용하여 애플리케이션 을 인증하려면 먼저 인증 에 필요한 AWS IAM 값으로 설정하다 합니다. 다음 코드 예시 와 같이 셸 에서 export 명령을 실행 하거나 .env 파일 에 변수를 추가할 수 있습니다.

export AWS_ACCESS_KEY_ID=<AWS IAM access key ID>
export AWS_SECRET_ACCESS_KEY=<AWS IAM secret access key>
export AWS_SESSION_TOKEN=<AWS session token>

AWS_ACCESS_KEY_ID=<AWS IAM access key ID>
AWS_SECRET_ACCESS_KEY=<AWS IAM secret access key>
AWS_SESSION_TOKEN=<AWS session token>

이러한 환경 변수를 설정하다 한 후 authMechanism 연결 옵션을 'MONGODB-AWS' 로 설정하다 합니다.

$client = new MongoDB\Client(
    'mongodb://<hostname>:<port>',
    ['authMechanism' => 'MONGODB-AWS']
);

$uri = 'mongodb://<hostname>:<port>/?authMechanism=MONGODB-AWS';
$client = new MongoDB\Client($uri);

AssumeRoleWithWebIdentity 요청

애플리케이션 이 OIDC(OpenID Connect) ID 제공자 로부터 EKS 클러스터 의 사용자를 인증하는 경우 운전자 는 AssumeRoleWithWebIdentity 요청 을 통해 OIDC 토큰을 애플리케이션 의 임시 AWS 자격 증명 으로 교환할 수 있습니다.

요청 에서 반환된 임시 AWS IAM 자격 증명 으로 인증하려면 AssumeRoleWithWebIdentity AWS 구성 파일 이 환경에 있고 올바르게 구성되어 있는지 확인합니다. AWS 구성 파일 을 생성하고 구성하는 방법을 학습 보려면 구성 을 참조하세요. AWS 설명서에 있습니다.

AssumeRoleWithWebIdentity 요청 에 대한 환경을 구성한 후 authMechanism 연결 옵션을 'MONGODB-AWS' 로 설정하다 합니다. authMechanism 옵션을 설정하는 예시 를 보려면 이 페이지의 authMechanism 예시 를 참조하세요.

ECS Metadata

애플리케이션 이 Elastic Container Service(ECS) 컨테이너 에서 실행되는 경우 운전자 는 ECS 엔드포인트에서 임시 AWS 자격 증명 을 자동으로 조회 할 수 있습니다. 이렇게 하려면 AWS_CONTAINER_CREDENTIALS_RELATIVE_URI 이라는 환경 변수에 ECS 엔드포인트의 URI를 지정합니다. 다음 예시 와 같이 export 셸 명령을 실행 하거나 .env 파일 에 추가하여 이 변수를 설정하다 수 있습니다.

export AWS_CONTAINER_CREDENTIALS_RELATIVE_URI=<URI of the ECS endpoint>

AWS_CONTAINER_CREDENTIALS_RELATIVE_URI=<URI of the ECS endpoint>

환경 변수를 설정하다 한 후 authMechanism 연결 옵션을 'MONGODB-AWS' 로 설정하다 합니다. authMechanism 옵션을 설정하는 예시 를 보려면 이 페이지의 authMechanism 예시 를 참조하세요.

EC2 인스턴스 메타데이터

운전자 는 Amazon Elastic Cloud Compute(EC2) 인스턴스 에서 임시 AWS 자격 증명 을 자동으로 조회 할 수 있습니다. EC2 인스턴스 내에서 임시 자격 증명 을 사용하려면 authMechanism 연결 옵션을 'MONGODB-AWS' 로 설정하다 합니다. authMechanism 옵션을 설정하는 예시 를 보려면 이 페이지의 authMechanism 예시 를 참조하세요.

API 문서

MongoDB\Client 클래스에 학습 보려면 라이브러리 API 문서에서 MongoDB\Client 를 참조하세요.

에 전달할 수 있는 URI 옵션의 전체 목록을 MongoDB\Client 보려면 MongoDB\ 드라이버\ 관리자::__construct() 매개변수 를 참조하세요. 확장 API 문서에서 확인 가능합니다.