X.509 인증

개요

X.509 인증 메커니즘 에서 서버 와 클라이언트 TLS 프로토콜 사용하여 X.509 공개 키 인증서를 교환합니다. 이 메커니즘을 사용하여 MongoDB Atlas, MongoDB Enterprise Advanced 및 MongoDB Community Edition 에 인증할 수 있습니다.

팁

X.509 메커니즘

Java 운전자 에서 TLS/SSL을 사용하는 방법을 학습하려면 연결 가이드 에서 TLS/SSL 활성화 를 참조하세요.

X.509 인증서에 대한 자세한 내용은 MongoDB Server 매뉴얼에서 x.509 인증서를 사용하여 자체 관리 배포서버에서 클라이언트 인증하기 를 참조하세요.

코드 자리 표시자

이 페이지의 코드 예제에서는 다음 자리 표시자를 사용합니다.

<hostname>: MongoDB deployment 의 네트워크 주소 .
<port>: MongoDB deployment 의 포트 번호입니다. 이 매개 변수를 생략하면 운전자 기본값 포트 번호(27017)를 사용합니다. MongoDB Atlas cluster 에 연결할 때는 포트 번호가 필요하지 않습니다.
<authenticationDb>: 사용자의 인증 데이터가 포함된 MongoDB database 입니다. 이 자리 표시자를 생략하면 운전자 기본값 admin 데이터베이스 사용합니다.

코드 예제를 사용하려면 이러한 자리 표시자를 원하는 값으로 바꾸세요.

X.509 인증을 지정합니다.

이 인증 메커니즘 지정에 대한 지침과 예제 코드를 보려면 아래 Connection String 또는 MongoCredential 탭을 선택하세요.

연결 문자열을 사용하여 X.509 인증 메커니즘을 지정하려면 authMechanism 매개변수에 MONGODB-X509 를 할당하고 tls 매개변수에 true를 할당하여 TLS를 활성화합니다. MongoClient 을(를) 인스턴스화하는 코드는 다음 예시와 유사합니다.

MongoClient mongoClient = MongoClients.create("mongodb://<hostname>:<port>/?authSource=<authenticationDb>&authMechanism=MONGODB-X509&tls=true");

MongoCredential 클래스를 사용하여 X.509 인증 메커니즘을 지정하려면 createMongoX509Credential() 메서드를 사용합니다. 또한 applyToSslSettings() 메서드를 호출하고 SslSettings.Builder 블록에서 enabled 속성을 true (으)로 설정하여 TLS를 활성화합니다. MongoClient 을(를) 인스턴스화하는 코드는 다음 예시와 유사합니다.

MongoCredential credential = MongoCredential.createMongoX509Credential();
MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder()
        .applyToClusterSettings(builder ->
            builder.hosts(Arrays.asList(new ServerAddress("<hostname>", <port>))))
        .applyToSslSettings(builder ->
            builder.enabled(true);
            )
        .credential(credential)
        .build());

API 문서

이 페이지에 사용된 MongoDB 메서드 및 유형에 대해 자세히 학습 다음 API 설명서를 참조하세요.

돌아가기

SCRAM

AWS IAM