メインコンテンツへスキップ
CData Arc は、コネクタ設定に保存されたパスワード、API キー、接続認証情報といった機密性の高い暗号化データを保護するために、マスターキーを使用します。デフォルトでは、Arc は組み込みのマスターキーを提供しますが、厳格なセキュリティ要件を持つ組織は、暗号化インフラストラクチャを完全に制御するためにカスタムマスターキーを定義できます。これにより、ユーザー定義のマスターキーを簡単にローテーションできるようになります。 マスターキーは2つのフォーマットで提供できます。AES キーファイル内のランダムな文字列として、またはオプションでパスワード保護されたPFX(PKCS#12)証明書ファイルとして提供できます。カスタムマスターキーにより、企業はArc の暗号化方法を社内のセキュリティポリシーに合わせ、規制要件に準拠し、既存の鍵管理システムと統合することができます。
カスタムマスターキーへのアクセスを失うと、Arc は保存された認証情報や設定データを復号できなくなります。カスタムマスターキーを設定する前に、安全な鍵のバックアップとリカバリの手順を実装してください。

データ暗号化キーとマスターキーについて

暗号化は、データの一部であるキーを使ってプレーンテキストを暗号文にスクランブルすることで機能します。アプリケーションを初めて使用する際、Arc はどこにもプレーンテキストで保存されないランダムなキーを生成します。これがデータ暗号化キー(DEK)です。すべてのデータはこのキーを使用して暗号化されます。 マスターキー(Key Encryption Key、KEK とも呼ばれます)は、データを直接暗号化するものではありません。代わりに、他のキーを暗号化するラッパーです。Arc は組み込みのマスターキーも提供しますが、上述のとおり、代わりに独自のマスターキーを定義することもできます。このトピックの残りの部分では、ユーザー定義のマスターキーを作成または更新する方法について説明します。 次の表は、2つのキーを比較したものです:
同じマスターキーファイルを2つのインスタンスで使用しても、互いの値を復号できるようにはなりません。それを決定するのはデータ暗号化キーだけです。既存のインスタンスのAppKey を別のマスターキーファイルに向けないでください。代わりにマスターキー変更コマンドを使用してください。そうしないと、インスタンスはIncorrect user master key or key file is damaged というメッセージで起動に失敗します。

マスターキー暗号化が有効かどうかの確認

開発環境で使用されるデータ暗号化キーのエクスポートやインポートなど、一部の機能では、マスターキー暗号化が有効になっている必要があります。インスタンスで有効になっているかどうかを確認するには:
  • クロスプラットフォーム版: arc.properties 設定ファイルでcdata.encryption.key プロパティが設定されている場合、またはAPP_KEY 環境変数が設定されている場合、マスターキー暗号化は有効です。
  • .NET 版: インストールディレクトリのwww フォルダにあるWeb.Config ファイルのappSettings 要素にAppKey エントリが存在する場合、またはAPP_KEY 環境変数が設定されている場合、マスターキー暗号化は有効です。
新規インストールでは、マスターキー暗号化がデフォルトで有効になっています。マスターキー暗号化が有効になっていない場合、これらの機能はエラーMaster key encryption is not enabled で失敗します。

マスターキー暗号化の有効化

すでに値が保存されている既存のインスタンスを含め、マスターキー暗号化が有効になっていないインスタンスで有効にするには:
  1. Arc を停止します。
  2. マスターキーを設定します:
    • クロスプラットフォーム版: arc.properties 設定ファイルでcdata.encryption.key プロパティを設定します:
    • .NET 版: インストールディレクトリのwww フォルダとwww_services フォルダの両方にあるWeb.Config ファイルのappSettings 要素に、次のエントリを追加します:
  3. Arc を起動します。default.master_key を使用していてファイルが存在しない場合、Arc はアプリケーションディレクトリにファイルを生成します。すでに保存されている値は引き続き読み取り可能です。
どちらのエディションでも、APP_KEY 環境変数を使用してキーファイルのパスを指定することもできます。相対パスは、アプリケーションディレクトリを基準に解決されます。デフォルトのキーファイルではなく独自のキーファイルを使用するには、カスタムマスターキーの定義を参照してください。

カスタムマスターキーの定義

マスターキーを定義する方法は、Arc のエディションの種類によって異なります。
  • クロスプラットフォーム版: arc.properties 設定ファイル内の cdata.encryption.key プロパティを使用してキーを定義します。PFX キーを定義し、パスワードが必要な場合は、cdata.encryption.key.password プロパティに設定します。あるいは、AES キーを使用している場合は、APP_KEY 環境変数を使用してキーファイルへのファイルパスを指定できます。
  • .NET 版: インストールディレクトリのwww フォルダとwww_services フォルダの両方にあるWeb.Config ファイルのappSettings 要素内のAppKey 設定にファイルパスを設定します。PFX キーを定義し、パスワードが必要な場合は、AppKeyPassword 設定に設定します。Web.Config に追加する必要のあるXML スニペットは次のとおりです:

マスターキーの変更

必要に応じて、マスターキーファイルを置き換えることができます。Arc は、暗号化に常にユーザーが指定したキーを使用します。マスターキーを変更するには、サーバーを停止していることを確認してから、次のいずれかのオプションを使用します:
  • クロスプラットフォーム版: 管理者は arc.jar -ChangeMasterKey <new-master-key-file-path> コマンドを使用して、マスターキーをローテーションできます。マスターキーをPFX ファイルに変更し、パスワードが必要な場合は、arc.jar -ChangeMasterKey <new-master-key-file-path> <new-master-key-password> コマンドを使用します。
  • .NET 版: 管理者は CData.exe appChangeMasterKey -NewKey <new-master-key-file-path> -@libdir "www\bin" コマンドを使用する必要があります(Web.Config ファイルを直接変更しないでください)。マスターキーをPFX ファイルに変更し、パスワードが必要な場合は、CData.exe appChangeMasterKey -NewKey <new-master-key-file-path> -NewKeyPassword <new-PFX-password> -@libdir "www\bin" コマンドを使用します。
これらのコマンドは、マスターキー暗号化がすでに有効になっているインスタンスでのみマスターキーを置き換えます。有効になっていない場合は、エラーThe encryption key is not set で失敗します。また、これらのコマンドはデータ暗号化キーを同じまま維持するため、インスタンス間でキーを共有するために使用することはできません。データ暗号化キーを共有するには、exportDataEncryptionKey とimportDataEncryptionKey を使用してください。
Arc は、PFX 証明書ファイルではRSA アルゴリズムのみをサポートします。その他のDSA またはECC 証明書は拒否されます。

セーフモードの使用

カスタムマスターキーを紛失し、(保有している別の記録元から)設定の機密性の高い値を再保存する必要がある場合は、Arc をセーフモードで起動できます。これにより、すべてのバックエンドオートメーションサービスが無効になり、ごく限られた機能のみが有効になるため、設定やその他のタスクの復元を試みることができます。セーフモードを有効にするには:
  • クロスプラットフォーム版: java -jar arc.jar -safemode を実行します。
  • .NET 版: Web.Config ファイルの appSettings 要素に <add key="SafeMode" value="true" /> を追加します。