Menu Docs
Página inicial do Docs
/ /

Requisitos de instalação

Saiba mais sobre os aplicativos e bibliotecas que você deve instalar para usar a criptografia no nível do campo do lado do cliente (CSFLE).

Antes de usar o CSFLE, você deve configurar os seguintes itens em seu ambiente de desenvolvimento:

  • (Opcional) Baixe abiblioteca compartilhada de criptografia automática . A Biblioteca compartilhada de criptografia automática é uma alternativa preferencial ao mongocryptd e não requer a geração de um novo processo. mongocryptd ainda é suportado.

  • Instale a edição MongoDB Enterprise.

  • Instale um driver MongoDB compatível com CSFLE.

  • Inicie uma instância MongoDB ou Atlas Cluster.

  • Certifique-se de que esteja usando um sistema operacional x64. O CSFLE requer suporte x64.

Se você estiver usando a versão 3.0 do driver ou posterior:

  • 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 LIBMONGOCRYPT_PATH variável de ambiente para o caminho absoluto do libmongocrypt arquivo.

  • Se seu aplicação for executado no Linux de 64bits e você estiver usando a versão do driver 3.4.3 ou anterior, adicione o seguinte XML ao seu arquivo .csproj.

    Substitua <MongoDriverEncryptionVersion> pela versão instalada do pacote 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>
  • Instale o libmongocrypt. A biblioteca libmongocrypt contém ligações para se comunicar com a biblioteca nativa que gerencia a criptografia.

  • Instale mongodb-crypt. A biblioteca mongodb-crypt contém ligações para se comunicar com a biblioteca nativa que gerencia a criptografia.

  • Instale mongodb-client-encryption, um wrapper do Node.js para a biblioteca de criptografia libmongocrypt. A biblioteca libmongocrypt contém vinculações para se comunicar com a biblioteca nativa que gerencia a criptografia.

Ao usar a versão 6.0.0 ou posterior do driver do Node.js, mongodb-client-encryption deve ter o mesmo número de versão principal que o driver.

Por exemplo, o driver Node.js v6.xx requer mongodb-client-encryption v6.xx

  • Instale pymongocrypt, um wrapper Python para a biblioteca de criptografia libmongocrypt. A biblioteca libmongocrypt contém vinculações para se comunicar com a biblioteca nativa que gerencia a criptografia.

Para começar a usar o CSFLE, consulte Início Rápido do CSFLE.

Para saber como usar o CSFLE com um provedor remoto do Key Management System, consulte Tutoriais do CSFLE.

Voltar

Características

Nesta página