使用中の暗号化

インストール

C ドライバーで使用中の暗号化を使用するには、依存関係libmongocryptが必要です。 libmongocrypt のインストール手順については、MongoDB マニュアルを参照してください。

libmongocrypt がインストールされたら、使用中の暗号化を有効にするよう要求するように -DENABLE_CLIENT_SIDE_ENCRYPTION=ONを使用して C ドライバーを構成します。

$ cd mongo-c-driver
$ mkdir cmake-build && cd cmake-build
$ cmake -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF -DENABLE_CLIENT_SIDE_ENCRYPTION=ON ..
$ cmake --build . --target install

API

mongoc_client_encryption_t は、明示的な暗号化とキー管理に使用されます。 mongoc_client_enable_auto_encryption と mongoc_client_role_enable_auto_encryption は、自動暗号化を有効にするために使用されます。

Queryable Encryption と CSFLE の機能は、一部の例外を除いて、同じ API の多くを共有します。

• mongoc_client_encryption_encrypt_ops_set_algorithm に記載されているサポートされているアルゴリズムは、両方の機能には適用されません。

• mongoc_auto_encryption_opts_set_encrypted_fields_map は、 Queryable Encryptionにのみ適用されます。

• mongoc_auto_encryption_opts_set_schema_map は CSFLE にのみ適用されます。

クエリ分析

自動暗号化機能をサポートするには、次のいずれかの依存関係が必要です。

• mongocryptd実行可能ファイル。 MongoDB マニュアルのドキュメント: mongocryptd のインストールと構成

• crypt_sharedライブラリ。 MongoDB マニュアルのドキュメント:自動暗号化共有ライブラリ

自動暗号化が設定された mongoc_client_t または mongoc_client_Pool_tcrypt_shared は、自動的に ライブラリのロードを試行します。crypt_shared ライブラリのロードに失敗した場合、mongoc_client_t または mongoc_client_Pool_t mongocryptdは、アプリケーションの から プロセスを生成しようとします。PATH crypt_sharedと の使用を構成するには、mongocryptd mongoc_auto_encryption_opts_set_Extra を参照してください。