CSFLE 호환성

MongoDB의 Queryable Encryption 기능 은 MongoDB 7.0 이상에서 사용할 수 있습니다(GA). Queryable Encryption 에 학습 자세히 알아보고 클라이언트 측 필드 레벨 암호화 와 그 이점을 비교하려면 Queryable Encryption 을 참조하세요.

이 페이지에서는 클라이언트 측 필드 레벨 암호화와 호환되는 MongoDB 및 드라이버 버전에 대해 설명합니다.

➤ 언어 선택 드롭다운 메뉴를 사용하여 운전자 선택하고 클라이언트 측 필드 레벨 암호화 와의 호환성을 확인합니다.

MongoDB 에디션 및 버전 호환성

클라이언트 측 필드 레벨 암호화를 사용한 자동 암호화 는 MongoDB Enterprise Edition, 버전 4.2 이상에서만 사용할 수 있습니다.

클라이언트 측 필드 레벨 암호화를 사용한 명시적 암호화 는 MongoDB Community 및 Enterprise Edition, 버전 4.2 이상에서 사용할 수 있습니다.

드라이버 호환성

클라이언트 측 필드 레벨 암호화 및 키 순환 API C 운전자와 함께 사용하려면 운전자 버전 1.17.5 이상을 설치합니다.

클라이언트 측 필드 레벨 암호화 및 키 순환 API를 C++ 운전자와 함께 사용하려면 운전자 버전 3.6.0 이상을 설치합니다.

.NET/ C# 운전자 와 함께 클라이언트 측 필드 레벨 암호화 사용하려면 운전자 버전 2.10.0 이상을 설치합니다. 키 순환 API 사용하려면 운전자 버전 2.17.1 이상을 설치합니다.

운전자 버전 3.0 이상을 사용하는 경우 다음 단계도 완료해야 합니다.

MongoDB 설치합니다. NuGet의 드라이버.Encryption 패키지 . 이 패키지 자동 암호화 활성화합니다.
애플리케이션이 Linux에서 실행되는 경우 libmongocrypt 를 수동으로 설치합니다. 그런 다음 LIBMONGOCRYPT_PATH 환경 변수를 libmongocrypt 파일 의 절대 경로로 설정하다 .
애플리케이션 64비트 Linux 에서 실행되고 운전자 버전 3.4.3 이하를 사용하는 경우 .csproj 파일 에 다음 XML 줄을 추가합니다. 설치한 MongoDB.Driver.Encryption 패키지 의 버전과 일치하도록 <MongoDriverEncryptionVersion> 요소의 값을 변경합니다.

<PropertyGroup>
    <!-- replace the version here with your package version -->
    <MongoDriverEncryptionVersion>3.4.2</MongoDriverEncryptionVersion>
    <MongoDriverEncryptionPath>$(NuGetPackageRoot)mongodb.driver.encryption\$(MongoDriverEncryptionVersion)</MongoDriverEncryptionPath>
</PropertyGroup>
<PropertyGroup>
    <!-- Suppresses the duplicate file error -->
    <ErrorOnDuplicatePublishOutputFiles>false</ErrorOnDuplicatePublishOutputFiles>
</PropertyGroup>
<!-- Ensures the correct library after build or publish -->
<Target Name="EnsureCorrectMongoEncryption" AfterTargets="Build;Publish" Condition="'$(RuntimeIdentifier)' != ''">
    <!-- Determine paths based on current operation -->
    <PropertyGroup>
        <_TargetDir Condition="Exists('$(PublishDir)')">$(PublishDir)</_TargetDir>
        <_TargetDir Condition="'$(_TargetDir)' == ''">$(OutputPath)</_TargetDir>
    </PropertyGroup>
    <!-- Copy the correct library based on runtime identifier (RID) -->
    <ItemGroup>
        <_CorrectMongoLib Include="$(MongoDriverEncryptionPath)/runtimes/linux/native/x64/libmongocrypt.so"
                          Condition="'$(RuntimeIdentifier)' == 'linux-x64'" />
        <_CorrectMongoLib Include="$(MongoDriverEncryptionPath)/runtimes/linux/native/arm64/libmongocrypt.so"
                          Condition="'$(RuntimeIdentifier)' == 'linux-arm64'" />
        <_CorrectMongoLib Include="$(MongoDriverEncryptionPath)/runtimes/linux/native/alpine/libmongocrypt.so"
                          Condition="'$(RuntimeIdentifier)' == 'linux-musl-arm64'" />
    </ItemGroup>
    <!-- Copy with overwrite -->
    <Copy SourceFiles="@(_CorrectMongoLib)"
          DestinationFolder="$(_TargetDir)"
          Condition="'@(_CorrectMongoLib)' != ''"
          OverwriteReadOnlyFiles="true" />
    <Message Text="Fixed MongoDB encryption library for $(RuntimeIdentifier)"
             Condition="'@(_CorrectMongoLib)' != ''" />
</Target>

고 (Go) 운전자 와 함께 클라이언트 측 필드 레벨 암호화 1.2 사용하려면 운전자 버전 이상을 설치합니다. 키 순환 API 사용하려면 libmongocrypt 버전 1.5.2 이상을 설치합니다.

Node.js 운전자 와 함께 클라이언트 측 필드 레벨 암호화 3.4.0 사용하려면 운전자 버전 이상을 설치합니다. 키 순환 API 사용하려면 mongodb-client-encryption 버전 2.2.0 을(를) 설치합니다. - 2.x.

클라이언트 측 필드 레벨 암호화 및 키 순환 API를 PHP 운전자와 함께 사용하려면 운전자 버전 1.6.0 이상을 설치합니다.

PyMongo 에서 클라이언트 측 필드 레벨 암호화 사용하려면 운전자 버전 3.10.0 이상을 설치합니다. 키 순환 API 사용하려면 pymongocrypt 버전 1.3.1 을(를) 설치합니다. 또는 그 이후 버전.

클라이언트 측 필드 레벨 암호화 및 키 순환 API를 Ruby 운전자와 함께 사용하려면 운전자 버전 2.12.1 이상을 설치하세요.

Rust 운전자 와 함께 클라이언트 측 필드 레벨 암호화 2.4.0 사용하려면 운전자 버전 이상을 설치합니다. 키 순환 API 사용하려면 libmongocrypt 버전 1.8.0 이상을 설치합니다.

스칼라 운전자 와 함께 클라이언트 측 필드 레벨 암호화 및 키 순환 API 사용하려면 운전자 버전 이상을 2.7.0 설치합니다.

키 순환 API 에 대해 자세히 학습하려면 암호화 키 순환 및 다시 래핑을 참조하세요.

돌아가기

KMIP 사용

CSFLE 제한