문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼
호환성
이 페이지의 내용
이 페이지에서는 Queryable Encryption 및 클라이언트 측 필드 레벨 암호화와 호환되는 MongoDB 에디션 및 드라이버 버전에 대해 설명하여 배포에서 각 사용 중 암호화 기능을 지원하는지 여부를 확인하는 데 도움이 됩니다.
Queryable Encryption 호환성
MongoDB 7 에서 Queryable Encryption을 사용할 수 있습니다.0 이상의 복제본 세트 또는 샤드 클러스터(독립형 인스턴스는 아님). 다음 표는 어떤 MongoDB 서버 제품이 어떤 Queryable Encryption 메커니즘을 지원하는지 보여줍니다.
제품 이름 | 최소 버전 | 자동 암호화로 Queryable Encryption 지원 | 명시적 암호화를 통한 Queryable Encryption 지원 |
|---|---|---|---|
MongoDB Atlas [1] | 7.0 | 예 | 예 |
MongoDB Enterprise Advanced | 7.0 | 예 | 예 |
MongoDB Community 에디션 | 7.0 | 아니요 | 예 |
| [1] | Queryable Encryption은 MongoDB Atlas와 호환되지만 MongoDB Atlas Search와는 호환되지 않습니다. |
Queryable Encryption 드라이버 호환성
Queryable Encryption에는 호환되는 MongoDB 드라이버에 다음과 같은 최소 버전이 필요합니다.
드라이버 | 최소 버전 | 암호화 라이브러리 |
|---|---|---|
1 . 24 . 0 | libmongocrypt 버전 1.8.0 이상. | |
3 . 8 . 0 | libmongocrypt 버전 1.8.0 이상. | |
2 . 20 . 0 | 추가 종속성이 없습니다. | |
1.12 | libmongocrypt 버전 1.8.0 이상. | |
1 . 24 . 0 | libmongocrypt 버전 1.8.0 이상. | |
3 . 8 . 0 | libmongocrypt 버전 1.8.0 이상. | |
2 . 20 . 0 | 추가 종속성이 없습니다. | |
1.12 | libmongocrypt 버전 1.8.0 이상. | |
4.10.0 | mongodb-crypt 버전 1.8.0 이상 | |
5 . 5 . 0 | mongodb-client-encryption 버전 2.8.0 이상. 노드 6.0.0 이상에는 Node.js 드라이버와 동일한 주요 버전 번호를 가진 | |
1.16 | 추가 종속성이 없습니다. | |
4.4 | pymongocrypt 버전 1 6. 이상. | |
2.19 | libmongocrypt-helper 버전 1.8.0 이상. | |
2.6.0 | libmongocrypt 버전 1.8.0 이상. | |
4.10.0 | mongodb-crypt 버전 1.8.0 이상 |
MongoDB 지원 제한 사항
컬렉션에서 Queryable Encryption를 사용하도록 설정하면 일부 진단 명령에서 필드가 삭제되고 쿼리 로그에서 일부 작업이 생략됩니다. 이로 인해 MongoDB 지원 엔지니어가 특히 쿼리 성능을 분석할 때 사용할 수 있는 데이터가 제한됩니다. 암호화된 컬렉션에 대한 작업의 영향을 측정하려면 타사 애플리케이션 성능 모니터링 도구를 사용하여 지표를 수집하십시오.
클라이언트 측 필드 레벨 암호화 호환성
MongoDB 4 에서 클라이언트 측 필드 레벨 암호화(CSFLE)를 사용할 수 있습니다.2 이상의 복제본 세트 또는 샤드 클러스터(독립형 인스턴스는 아님). 다음 표는 어떤 MongoDB 서버 제품이 어떤 클라이언트 사이드 필드 레벨 암호화 메커니즘을 지원하는지 보여줍니다.
제품 이름 | 최소 버전 | 자동 암호화로 CSFLE 지원 | 명시적 암호화로 CSFLE 지원 |
|---|---|---|---|
MongoDB Enterprise Advanced | 4.2 | 예 | 예 |
MongoDB Community 에디션 | 4.2 | 아니요 | 예 |
클라이언트 측 필드 레벨 암호화 드라이버 호환성
클라이언트 측 필드 레벨 암호화에는 호환되는 MongoDB 드라이버에 대해 다음과 같은 최소 버전이 필요합니다.
중요
키 순환 지원
키 순환 API를 사용하려면 드라이버의 바인딩 패키지 또는 libmongocrypt 의 특정 버전을 사용해야 합니다.
드라이버 | 최소 버전 | 키 순환 요구 사항 |
|---|---|---|
1 . 17 . 5 | 추가 요구 사항이 없습니다. | |
3.6.0 | 추가 요구 사항이 없습니다. | |
2 . 10 . 0 | 드라이버 버전 2.17.1 이상. | |
1.2 | libmongocrypt 버전 1.5.2 이상. | |
3 . 11 . 0 | mongodb-crypt 버전 1.7.3 이상. | |
1.12.0 | mongodb-crypt 버전 1.7.3 이상. | |
3.4.0 | 드라이버 버전 6 의 경우.0 이상에서는 드라이버와 동일한 mongodb-client-encryption 주요 버전을 사용합니다. 그렇지 않으면 mongodb-client-encryption 2 를 사용합니다.2.0 - 2.x. | |
1.6.0 | 추가 요구 사항이 없습니다. | |
3 . 10 . 0 | pymongocrypt 버전 1.3.1 이상. | |
2 . 12 . 1 | 추가 요구 사항이 없습니다. | |
2 . 7 . 0 | 추가 요구 사항이 없습니다. |