호환성
이 페이지의 내용
이 페이지에서는 Queryable Encryption 및 클라이언트 측 필드 레벨 암호화와 호환되는 MongoDB 에디션 및 드라이버 버전에 대해 설명하여 배포에서 각 사용 중 암호화 기능을 지원하는지 여부를 확인하는 데 도움이 됩니다.
Queryable Encryption 호환성
MongoDB 7.0 이상의 복제본 세트 또는 샤드 클러스터에서는 Queryable Encryption을 사용할 수 있지만 독립형 인스턴스는 사용할 수 없습니다. 다음 표는 어떤 MongoDB 서버 제품이 어떤 Queryable Encryption 메커니즘을 지원하는지 보여줍니다.
제품 이름 | 최소 버전 | 자동 암호화로 Queryable Encryption 지원 | 명시적 암호화를 통한 Queryable Encryption 지원 |
|---|---|---|---|
MongoDB Atlas [1] | 7.0 | 예 | 예 |
MongoDB Enterprise Advanced | 7.0 | 예 | 예 |
MongoDB Community 에디션 | 7.0 | No | 예 |
| [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 | 3.0 이전의 C#/ .NET 버전에 대한 추가 종속성은 없습니다. C#/ .NET 버전 3.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.4.0 | libmongocrypt 버전 1.8.0 이상. | |
4.10.0 | mongodb-crypt 버전 1.8.0 이상 |
MongoDB 지원 제한 사항
컬렉션에서 Queryable Encryption를 사용하도록 설정하면 일부 진단 명령에서 필드가 삭제되고 쿼리 로그에서 일부 작업이 생략됩니다. 이로 인해 MongoDB 지원 엔지니어가 특히 쿼리 성능을 분석할 때 사용할 수 있는 데이터가 제한됩니다. 암호화된 컬렉션에 대한 작업의 영향을 측정하려면 타사 애플리케이션 성능 모니터링 도구를 사용하여 지표를 수집하십시오.
클라이언트 측 필드 레벨 암호화 호환성
클라이언트 측 필드 레벨 암호화 (CSFLE) 복제본 세트 또는 샤딩된 클러스터 는 사용할 수 있지만 독립형 인스턴스 는 사용할 수 없습니다. 다음 표는 어떤 MongoDB 서버 제품이 어떤 클라이언트 사이드 필드 레벨 암호화 메커니즘을 지원 하는지 보여줍니다.
제품 이름 | 최소 버전 | 자동 암호화로 CSFLE 지원 | 명시적 암호화로 CSFLE 지원 |
|---|---|---|---|
MongoDB Atlas | 예 | 예 | |
MongoDB Enterprise Advanced | 4.2 | 예 | 예 |
MongoDB Community 에디션 | 4.2 | No | 예 |
클라이언트 측 필드 레벨 암호화 드라이버 호환성
클라이언트 측 필드 레벨 암호화에는 호환되는 MongoDB 드라이버에 대해 다음과 같은 최소 버전이 필요합니다.
중요
키 순환 지원
키 순환 API를 사용하려면 드라이버의 바인딩 패키지 또는 libmongocrypt 의 특정 버전을 사용해야 합니다.
드라이버 | 최소 버전 | 키 순환 요구 사항 |
|---|---|---|
1.17.5 | 추가 요구 사항이 없습니다. | |
3.6.0 | 추가 요구 사항이 없습니다. | |
2.10.0 | 드라이버 버전 2.17.1 이상. C#/ .NET 버전 3.0 이상에는 | |
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.4.0 | libmongocrypt 버전 1.8.0 이상. | |
2.7.0 | 추가 요구 사항이 없습니다. |