Docs Menu
Docs Home
/ /
クライアントサイドのフィールド レベル暗号化
Docs Home
/
開発
/
使用中の暗号化
/
クライアントサイドのフィールド レベル暗号化
Docs Home
/
開発
/
使用中の暗号化
/
クライアントサイドのフィールド レベル暗号化

インストール要件

Overview

クライアント側フィールド レベル暗号化（CSFLE）を使用するためにインストールする必要があるアプリケーションとライブラリについて説明します。

必要なもの

CSFLE を使用する前に、開発環境で次の項目を設定する必要があります。

  • （任意） 自動暗号化共有ライブラリをダウンロードします。 自動暗号化共有ライブラリはmongocryptdの推奨代替であり、新しいプロセスを生成する必要はありません。 mongocryptdは引き続きサポートされます。

  • MongoDB Enterprise エディションをインストールします。

  • CSFLE と互換性のある MongoDB ドライバーをインストールします。

  • MongoDB インスタンスまたはAtlas クラスターを起動します。

  • x64 オペレーティング システムを使用していることを確認します。CSFLE には x64 のサポートが必要です。

ドライバー バージョン 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>

  • libmongocrypt をインストールします。libmongocrypt ライブラリには、暗号化 を管理するネイティブ ライブラリと通信するためのバインディングが含まれています。

  • mongodb-crypt をインストールします。mongodb-crypt ライブラリには、暗号化 を管理するネイティブ ライブラリと通信するためのバインディングが含まれています。

Node.js ドライバー バージョン6.0.0以降を使用する場合、 mongodb-client-encryptionはドライバーと同じメジャー バージョン番号を持っている必要があります。

たとえば、Node.js ドライバー v 6 .x にはmongodb-client-encryption v 6 .x が必要です。

  • libmongocrypt暗号化ライブラリのPythonラッパーpymongocryptをインストールします。libmongocrypt ライブラリには、暗号化 を管理するネイティブ ライブラリと通信するためのバインディングが含まれています。

詳細

CSFLE の使用を開始するには、CSFLE クイック スタート を参照してください。

リモート キー管理システム プロバイダーで CSFLE を使用する方法については、CSFLE チュートリアル を参照してください。

戻る

主な機能

次へ

クイック スタート

項目一覧