Queryable Encryption の互換性

このページでは、Queryable Encryption が互換性のある MongoDB とドライバーのバージョンについて説明します。

➤ [ 言語を選択 ]ドロップダウンメニューを使用してドライバーを選択し、 Queryable Encryptionとの互換性を確認します。

MongoDB Edition、トポロジー、バージョン互換性

自動暗号化を使用した Queryable Encryption は、MongoDB Enterprise Edition および MongoDB Atlas でのみ利用できます。 Queryable Encryption は、MongoDB レプリカセットまたはシャーディングされたクラスターで使用できますが、スタンドアロンインスタンスでは使用できません。

明示的な暗号化は MongoDB Community および Enterprise Edition で利用できます。

ドライバーの互換性

CドライバーでQueryable Encryptionを使用するには、次のコンポーネントをインストールします。

ドライバーバージョン 1.24.0 以降
libmongocrypt バージョン 1.8.0 以降

.NET/ C#ドライバーでQueryable Encryptionを使用するには、ドライバーバージョン 2.20.0 以降をインストールしてください。

ドライバーバージョン 3.0 以降を使用している場合は、次の手順も完了する必要があります。

NuGet からMongoDB.Driver.Encryptionパッケージをインストールします。このパッケージは自動暗号化を有効にします。
アプリケーションがLinuxで実行される場合は、libmongocrypt を手動でインストールします。次に、LIBMONGOCRYPT_PATH 環境変数を libmongocryptファイルの絶対パスに設定します。
アプリケーションが64 ビットLinuxで実行され、かつドライバーバージョン 3.4.3 またはそれ以前のバージョンを使用している場合は、次の XML 行を .csprojファイルに追加します。<MongoDriverEncryptionVersion> 要素の値を、インストールしている MongoDB.Driver.Encryptionパッケージのバージョンと一致するように変更します。

<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>

Node.jsドライバーでQueryable Encryptionを使用するには、次のコンポーネントをインストールします。

ドライバーバージョン 5.5.0 以降
mongodb-クライアント暗号化バージョン 2.8.0またはそれ以降

Node.jsドライバーのバージョン 6.0 以降を使用している場合は、mongodb-client-encryption のバージョン 6.0 以降も使用する必要があります。

戻る

明示的な暗号化の使用

Queryable Encryption の制限