TLS 활성화 및 구성

개요

이 가이드에서는 TLS 프로토콜을 사용하여 MongoDB deployment에 대한 연결을 보호하는 방법을 배울 수 있습니다. TLS를 사용하도록 연결을 구성하려면 TLS 옵션을 활성화하고 선택적으로 애플리케이션의 config/database.php 파일에 유효성 검사를 위한 인증서를 제공합니다.

TLS 활성화

애플리케이션의 config/database.php 파일에서 다음 방법 중 하나를 사용하여 MongoDB deployment에 대한 연결에서 TLS를 활성화할 수 있습니다.

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

• mongodb 연결 항목의 options 속성에서 tls 옵션을 true 로 설정합니다.

다음 Connection String 및 Connection Options 탭에서 선택하여 해당 코드 샘플을 확인합니다.

'connections' => [
    'mongodb' => [
        'driver' => 'mongodb',
        'dsn' => 'mongodb://<hostname>:<port>/?tls=true',
        'database' => 'myDB',
    ]
]

'connections' => [
    'mongodb' => [
        'driver' => 'mongodb',
        'dsn' => '<connection string>',
        'database' => 'myDB',
        'options'  => [
            'tls' => true,
        ],
    ]
]

인증서 구성

TLS 요청 을 성공적으로 시작하려면 애플리케이션 에서 ID를 증명하는 암호화 인증서를 제시해야 할 수 있습니다. 연결 시 TLS를 활성화 하려면 애플리케이션의 인증서를 PEM 파일로 저장해야 합니다.

다음 목록에서는 클라이언트 가 TLS 지원 연결을 설정하기 위해 제시할 수 있는 구성 요소에 대해 설명합니다.

참조 인증서

필요한 경우 클라이언트가 연결되기 전에 서버가 인증서의 유효성을 검사할 수 있도록 mongodb 연결을 구성할 때 인증서를 참조해야 합니다.

연결 string 대신 연결 구성의 options 속성에서 인증서를 참조하고 다른 TLS 옵션을 설정하는 것이 좋습니다. 이렇게 하면 애플리케이션의 코드 가독성이 향상됩니다.

options 속성에서 다음 옵션을 설정하여 인증서를 참조합니다.

• tlsCAFile

• tlsCertificateKeyFile

• tlsCertificateKeyFilePassword

다음 예에서는 TLS를 활성화하여 연결을 구성합니다.

'connections' => [
    'mongodb' => [
        'driver' => 'mongodb',
        'dsn' => '<connection string>',
        'database' => 'myDB',
        'options'  => [
            'tls' => true,
            'tlsCAFile' => '<path to CA certificate>',
            'tlsCertificateKeyFile' => '<path to private client certificate>',
            'tlsCertificateKeyFilePassword' => '<path to client key passphrase>',
        ]
    ]
]

추가 정보

URI 옵션 설정에 학습 보려면 MongoDB\\ 드라이버\\ 관리자::__construct() API 문서.

연결에서 TLS를 활성화하는 방법에 대해 자세히 알아보려면 다음 서버 매뉴얼 문서를 참조하세요.

• TLS/SSL(전송 암호화)

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