문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼
getClientEncryption()
버전 4.2에 추가되었습니다.
getClientEncryption()
현재 데이터베이스 collection에 대한
ClientEncryption
객체를 반환합니다.ClientEncryption
객체는 클라이언트 사이드 필드 수준 암호화를 위한 필드 값의 명시적(수동) 암호화 및 암호 해독을 지원합니다.반환합니다: 현재 데이터베이스 연결에 대한 ClientEncryption
객체입니다.
구문
getClientEncryption()
의 구문은 다음과 같습니다:
db.getMongo().getClientEncryption();
다음과 같은 명시적 암호화 메서드에 액세스하려면 ClientEncryption
객체를 사용합니다.
행동
데이터베이스 연결에서 클라이언트 측 필드 수준 암호화 활성화
mongosh
클라이언트 사이드 필드 수준 암호화 방법을 사용하려면 클라이언트 사이드 필드 수준 암호화가 활성화된 데이터베이스 연결이 필요합니다. 클라이언트 사이드 필드 수준 암호화가 활성화된 상태에서 현재 데이터베이스 연결이 시작되지 않은 경우 다음 중 하나를 수행합니다.
mongosh
의Mongo()
생성자를 사용하여 필요한 클라이언트 사이드 필드 수준 암호화 옵션과 연결을 설정합니다.Mongo()
메서드는 고객 마스터 키(CMK) 관리를 위해 다음과 같은 키 관리 서비스(KMS) 공급자를 지원합니다.또는
mongosh
명령줄 옵션 을 사용하여 필요한 옵션과의 연결을 설정합니다. 명령줄 옵션은 CMK 관리를 위한 Amazon Web Services KMS 제공자만 지원합니다.
예제
메서드는 가 존재하는 문서에 대해서만 부분 인덱스 필터를 사용하여 필드에 고유 getKeyVault()
인덱스 를 자동으로 생성합니다.keyAltNames
keyAltNames
getKeyVault()
는 키 볼트 컬렉션에 이 인덱스를 생성합니다. 이렇게 하면 동일한 Key Vault에 있는 두 개의 데이터 암호화 키가 동일한 키 대체 이름을 갖는 것을 방지할 수 있으므로 암호화/복호화에 어떤 데이터 암호화 키가 적합한지 모호해지는 것을 방지할 수 있습니다.
경고
getKeyVault()
에 의해 생성된 고유 인덱스를 삭제하지 않도록 합니다. 클라이언트 측 필드 레벨 암호화 작업은 keyAltNames
의 서버 적용 고유성에 따라 달라집니다. 인덱스를 제거하면 예기치 않거나 예측할 수 없는 동작이 발생할 수 있습니다.
다음 예에서는 클라이언트 사이드 필드 수준 암호화 구성을 위해 로컬로 managed KMS를 사용합니다.
암호화된 클라이언트 만들기
Mongo()
생성자를 클라이언트 사이드 필드 수준 암호화 옵션과 함께 사용하여 데이터베이스 연결을 생성합니다. mongodb://myMongo.example.net
URI를 대상 cluster의 연결 문자열 URI 로 바꿉니다.
encryptedClient = Mongo( "mongodb://myMongo.example.net:27017/?replSetName=myMongo", autoEncryptionOpts )
getClientEncryption()
메서드를 사용하여 클라이언트 암호화 객체를 검색합니다.
clientEncryption = encryptedClient.getClientEncryption()
자세히 알아보기
클라이언트 사이드 필드 레벨 암호화가 활성화된 상태에서 MongoDB 연결을 시작하는 방법에 대한 전체 설명서는 Mongo()
를 참조하세요.