Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Docs Menu
Docs Home
/ /

Requisitos de instalación

Aprende sobre las aplicaciones y bibliotecas que debes instalar para usar el cifrado a nivel de campo del lado del cliente (CSFLE).

Antes de que puedas utilizar CSFLE, debes configurar los siguientes elementos en tu entorno de desarrollo:

  • (Opcional) Descargue la Librería Compartida de Cifrado Automático. La Librería Compartida de Cifrado Automático es una alternativa preferible a mongocryptd y no requiere iniciar un nuevo proceso. mongocryptd sigue siendo compatible.

  • Instalar MongoDB Enterprise.

  • Instala un Controlador de MongoDB compatible con CSFLE.

  • Consulte Primeros pasos para obtener información sobre cómo iniciar una instancia de MongoDB.

  • Asegúrate de utilizar un sistema operativo x64. CSFLE requiere soporte con x64.

Si estás utilizando la versión de controlador 3.0 o posterior, también debes completar los siguientes pasos:

<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>
  • Instala libmongocrypt. La librería libmongocrypt contiene acoplamientos para comunicarse con la librería nativa que gestiona el cifrado.

  • Instala mongodb-crypt. La librería mongodb-crypt contiene enlaces para comunicarse con la librería nativa que gestiona el cifrado.

  • Instala mongodb-client-encryption, un contenedor Node.js para la librería de cifrado libmongocrypt. La librería libmongocrypt contiene enlaces para comunicarse con la librería nativa que gestiona el cifrado.

Al usar la versión 6.0.0 o posterior del controlador de Node.js, mongodb-client-encryption debe tener el mismo número de versión principal que el controlador.

Por ejemplo, el driver de Node.js v6.x.x requiere mongodb-client-encryption v6.x.x.

  • Instalar pymongocrypt, un contenedor de Python para la biblioteca de cifrado libmongocrypt. La librería libmongocrypt contiene vínculos para comunicar con la librería nativa que gestiona el cifrado.

Para comenzar a usar CSFLE, consulta la Guía de inicio rápido de CSFLE.

Para aprender cómo usar CSFLE con un proveedor remoto de Sistema de Gestión de Claves, consulta Tutoriales de CSFLE.

Volver

Características

En esta página