データ暗号化キーとマスターキーについて
暗号化は、データの一部であるキーを使ってプレーンテキストを暗号文にスクランブルすることで機能します。アプリケーションを初めて使用する際、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環境変数が設定されている場合、マスターキー暗号化は有効です。
マスターキー暗号化の有効化
すでに値が保存されている既存のインスタンスを含め、マスターキー暗号化が有効になっていないインスタンスで有効にするには:- Arc を停止します。
-
マスターキーを設定します:
-
クロスプラットフォーム版: arc.properties 設定ファイルでcdata.encryption.key プロパティを設定します:
-
.NET 版: インストールディレクトリの
wwwフォルダとwww_servicesフォルダの両方にあるWeb.ConfigファイルのappSettings要素に、次のエントリを追加します:
-
クロスプラットフォーム版: arc.properties 設定ファイルでcdata.encryption.key プロパティを設定します:
-
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"コマンドを使用します。
Arc は、PFX 証明書ファイルではRSA アルゴリズムのみをサポートします。その他のDSA またはECC 証明書は拒否されます。
セーフモードの使用
カスタムマスターキーを紛失し、(保有している別の記録元から)設定の機密性の高い値を再保存する必要がある場合は、Arc をセーフモードで起動できます。これにより、すべてのバックエンドオートメーションサービスが無効になり、ごく限られた機能のみが有効になるため、設定やその他のタスクの復元を試みることができます。セーフモードを有効にするには:- クロスプラットフォーム版:
java -jar arc.jar -safemodeを実行します。 - .NET 版: Web.Config ファイルの
appSettings要素に<add key="SafeMode" value="true" />を追加します。