연결에서 TLS 활성화

개요

이 가이드 에서는 TLS/SSL 을 사용하여 MongoDB 인스턴스에 연결하는 방법을 학습 수 있습니다. .NET 프레임워크 의 기본 TLS/SSL 지원 을 사용하는 보안 프로토콜 입니다. TLS/SSL을 사용하도록 연결을 구성하려면 연결 string 또는 MongoClientSettings에서 TLS/SSL 설정을 활성화 합니다.

TLS 활성화

MongoDB 인스턴스에 연결할 때는 기본적으로 TLS가 비활성화되어 있습니다. MongoDB 객체의 속성을 MongoClientSettings 사용하거나 연결 의 매개변수를 사용하는 두 가지 방법으로 인스턴스에 대한 연결에 TLS를 활성화할 수 string 있습니다.

var settings = new MongoClientSettings { UseTls = true };
var client = new MongoClient(settings);

var mongoClient = new MongoClient("mongodb://<db_username>:<db_password>@<hostname>:<port>?tls=true");

클라이언트 인증서 구성

MongoClientSettings을(를) 사용하여 X.509 인증서를 구성할 수습니다. 다음 코드 샘플은 비밀번호 mySuperSecretPassword로 보호되는 client.p12 인증서 파일을 사용하여 새 X.509 인증서 객체를 만듭니다. 그런 다음 이 코드는 이 인증서를 MongoClientSettings의 SslSettings.ClientCertificates 배열에 추가합니다.

var cert = new X509Certificate2("client.p12", "mySuperSecretPassword");
var settings = new MongoClientSettings
{
   SslSettings = new SslSettings
   {
      ClientCertificates = new[] { cert }
   },
   UseTls = true
};

안전하지 않은 TLS 허용

TLS가 활성화되면 .NET/C# 드라이버는 서버가 제공하는 인증서를 자동으로 검증합니다. 코드를 테스트할 때 인증서 검증을 비활성화 설정할 수 있습니다. 이를 안전하지 않은 TLS라고 합니다.

안전하지 않은 TLS를 사용하는 경우 유일한 요구 사항은 서버가 X.509 인증서를 제공하는 것입니다. 드라이버는 다음과 같은 경우에도 인증서를 수락합니다.

• 서버의 호스트 이름과 인증서의 주체 이름(또는 주체 대체 이름)이 일치하지 않는 경우

• 인증서가 만료되었거나 아직 유효하지 않습니다.

• 인증서의 체인에 신뢰할 수 있는 루트 인증서가 없는 경우

• 인증서 용도가 서버 식별에 유효하지 않은 경우

MongoClientSettings 객체의 속성을 사용하거나 연결 문자열의 매개변수를 사용하는 두 가지 방법으로 안전하지 않은 TLS를 허용할 수 있습니다.

var settings = new MongoClientSettings
{
   UseTls = true,
   AllowInsecureTls = true
};
var client = new MongoClient(settings);

var mongoClient = new MongoClient("mongodb://<db_username>:<db_password>@<hostname>:<port>?tls=true&tlsInsecure=true");

인증서 철회 확인

X.509 인증서를 더 이상 신뢰할 수 없는 경우(예시: 개인 키가 손상된 경우) 인증 기관은 인증서를 철회합니다.

기본적으로 .NET/C# 드라이버는 연결하기 전에 서버의 인증서가 철회됐는지 여부를 확인하지 않습니다. MongoClientSettings 또는 연결 문자열을 사용하여 철회 확인 메커니즘을 활성화할 수 있습니다

var settings = new MongoClientSettings
{
   SslSettings = new SslSettings
   {
      CheckCertificateRevocation = true
   },
   UseTls = true
};

var mongoClient = new MongoClient("mongodb://<db_username>:<db_password>@<hostname>:<port>?tls=true&tlsDisableCertificateRevocationCheck=false");

API 문서

이 가이드에서 설명한 연결 옵션에 대해 자세히 알아보려면 다음의 API 문서를 참조하세요.

• MongoClientSettings