연결에서 TLS 사용

개요

이 가이드에서는 TLS 보안 프로토콜을 사용해 MongoDB 인스턴스에 연결하는 방법을 배울 수 있습니다.

TLS를 사용하도록 연결을 구성하려면 TLS 옵션을 활성화하고 유효성 검사를 위해 인증서를 제공합니다.

TLS 활성화

다음과 같은 방법으로 MongoDB 인스턴스에 대한 연결에서 TLS를 활성화할 수 있습니다:

• MongoClientOptions 객체에서tls 옵션을 true(으)로 설정

• 연결 문자열에서 tls 옵션을 true(으)로 설정

const client = new MongoClient(uri, { tls: true });

const uri = "mongodb://<hostname>:<port>?tls=true";
const client = new MongoClient(uri, myClientSettings);

드라이버는 tls 클라이언트 옵션 외에도 연결에 TLS를 구성할 수 있는 옵션을 다양하게 제공합니다. 테스트 목적으로 tlsAllowInvalidHostnames, tlsAllowInvalidCertificates 및 tlsInsecure 클라이언트 옵션을 설정할 수 있습니다.

tlsAllowInvalidHostnames 옵션을 true로 설정하면 호스트 이름 확인이 비활성화되며, tlsAllowInvalidCertificates를 true로 설정하면 인증서 유효성 검사가 비활성화됩니다. tlsInsecure옵션을 true로 설정하면 인증서 및 호스트 이름 유효성 검사를 모두 비활성화합니다.

클라이언트 옵션의 전체 목록은 연결 옵션을 참조하세요.

인증서 구성

TLS 요청을 성공적으로 시작하려면 애플리케이션은 암호화 인증서를 참조해 ID를 증명해야 합니다. TLS로 MongoDB에 연결하려면 인증서를 PEM 파일로 저장해야 합니다.

다음 목록에서는 TLS와의 연결을 설정하는 데 필요한 구성 요소를 설명합니다.

클라이언트의 참조 인증서

클라이언트가 연결되기 전에 서버에서 인증서를 검증할 수 있도록 MongoClientOptions 객체의 인증서를 참조해야 합니다. 다음과 같은 방법으로 인증서를 참조할 수 있습니다.

• 인증서를 저장할 SecureContext 객체 만들기(권장)

• 인증서를 가리키는 파일 경로 문자열을 제공합니다.

• 인증서를 저장할 Buffer 객체 만들기

// Create a SecureContext object
const secureContext = tls.createSecureContext({
  ca: fs.readFileSync(`<path to CA certificate>`),
  cert: fs.readFileSync(`<path to public client certificate>`),
  key: fs.readFileSync(`<path to private client key>`),
});
// Pass the SecureContext as a client option
const client = new MongoClient(uri, { tls: true, secureContext });

// Pass filepaths as client options
const client = new MongoClient(uri, {
  tls: true,
  tlsCAFile: `<path to CA certificate>`,
  tlsCertificateKeyFile: `<path to private client key>`,
});

// Read file contents
const ca = fs.readFileSync(`<path to CA certificate>`);
const cert = fs.readFileSync(`<path to public client certificate>`);
const key = fs.readFileSync(`<path to private client key>`);
// Pass Buffers as client options
const client = new MongoClient(uri, { tls: true, ca, cert, key });

SecureContext 예제

이 예제에서는 TLS 옵션을 포함하는 SecureContext 객체와 MongoClient 인스턴스를 생성하는 방법을 보여 줍니다. 이 예제에서는 MongoDB에 연결하여 찾기 쿼리를 실행합니다.

import { MongoClient } from "mongodb";
import * as fs from "fs";
import * as tls from "tls";
// Replace the uri string with your connection string.
const uri = "<connection uri>";
// Replace the filepaths with your certificate filepaths.
const secureContext = tls.createSecureContext({
  ca: fs.readFileSync(`<path to CA certificate>`),
  cert: fs.readFileSync(`<path to public client certificate>`),
  key: fs.readFileSync(`<path to private client key>`),
});
// Create a client with the secureContext option
const client = new MongoClient(uri, { tls: true, secureContext });
async function run() {
  try {
    const db = client.db("myDB");
    const myColl = db.collection("myColl");
    const doc = await myColl.findOne({});
    console.log(doc);
  } finally {
    await client.close();
  }
}
run().catch(console.dir);

추가 정보

연결에서 TLS를 활성화하는 방법에 대한 자세한 내용은 다음 서버 설명서를 참조하세요.

• TLS/SSL(전송 암호화)

• 클라이언트를 위한 TLS/SSL 구성