Compatibilidade de Queryable Encryption

Queryable Encryption com queries de igualdade normalmente está disponível (GA) no MongoDB 7.0 e versões posteriores. A pré-visualização pública do Queryable Encryption , lançada na versão 6.0, não é mais aceita. Os dados criptografados utilizando a pré-visualização pública são incompatíveis com as funcionalidades da versão. Para obter mais informações, consulte Alterações de compatibilidade no MongoDB 7.0.

Esta página descreve as versões do MongoDB e do driver com as quais a Queryable Encryption é compatível.

➤ Use o menu suspenso Selecione seu idioma para selecionar seu driver e ver sua compatibilidade com a Queryable Encryption.

Edição do MongoDB , topologia e compatibilidade de versão

A Queryable Encryption com criptografia automática só está disponível com o MongoDB Enterprise Edition e o MongoDB Atlas. Você pode usar a Queryable Encryption em um conjunto de réplicas do MongoDB ou em um cluster fragmentado, mas não em uma instância autônomo .

A criptografia explícita está disponível com o MongoDB Community and Enterprise Edition.

Compatibilidade de drivers

Para usar a Queryable Encryption com o driver C, instale os seguintes componentes:

Versão do driver 1.24.0 ou posterior
libmongocrypt versão 1.8.0 ou posterior

Para usar a Queryable Encryption com o driver C++, instale os seguintes componentes:

Versão do driver 3.8.0 ou posterior
libmongocrypt versão 1.8.0 ou posterior

Para usar a Queryable Encryption com o driver .NET/C#, instale a versão do driver 2.20.0 ou posterior.

Se estiver usando a versão 3.0 ou posterior do driver, você também deverá concluir as seguintes etapas:

Instale o pacote MongoDB.Driver.Encryption do NuGet. Este pacote habilita a criptografia automática.
Se seu aplicação for executado no Linux, instale libmongocrypt manualmente. Em seguida, defina a variável de ambiente LIBMONGOCRYPT_PATH para o caminho absoluto do arquivo libmongocrypt.
Se o seu aplicação for executado no 64-bit Linux e você estiver utilizando a versão do driver 3.4.3 ou anterior, adicione as seguintes linhas de XML ao seu arquivo .csproj. Altere o valor do elemento <MongoDriverEncryptionVersion> para corresponder à versão do pacote MongoDB.Driver.Encryption que você instalou.

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

Para usar a Queryable Encryption com o driver Go, instale os seguintes componentes:

Versão do driver 1.12 ou posterior
libmongocrypt versão 1.8.0 ou posterior

Para usar a Queryable Encryption com o driver Java Reactive Streams, instale os seguintes componentes:

Versão do driver 4.10.0 ou posterior
mongodb-crypt versão 1.8.0 ou mais tarde

Para usar a Queryable Encryption com o driver Java Sync, instale os seguintes componentes:

Versão do driver 4.10.0 ou posterior
mongodb-crypt versão 1.8.0 ou mais tarde

Para usar a Queryable Encryption com o driver Node.js, instale os seguintes componentes:

Versão do driver 5.5.0 ou posterior
mongodb-client-encryption versão 2.8.0 ou mais tarde

Para usar a Queryable Encryption com o driver PHP, instale a versão do driver 1.16 ou posterior.

Para usar a Queryable Encryption com PyMongo, instale os seguintes componentes:

Versão do driver 4.4 ou posterior
pymongocrypt versão 1.6 ou posterior

Para usar a Queryable Encryption com o driver Ruby, instale os seguintes componentes:

Versão do driver 2.19 ou posterior
libmongocrypt-helper versão 1.8.0 ou mais tarde

Para usar a Queryable Encryption com o driver Rust, instale os seguintes componentes:

Versão do driver 2.4.0 ou posterior
libmongocrypt versão 1.8.0 ou posterior

Para usar a Queryable Encryption com o driver Scala, instale os seguintes componentes:

Versão do driver 4.10.0 ou posterior
mongodb-crypt versão 1.8.0 ou mais tarde

Voltar

Usar criptografia explícita

Limitações do Queryable Encryption