# 暗号化用カスタムキーの設定

<tomcat\_path>\WEB-INF\classes\configuration.propertiesファイルにあるmaster.keyパラメーターは、機密情報のエンコードとデコードに必須です。このパラメーターが見つからない場合、Talend Administration Centerは正しく動作しません。

Talend Administration Centerのインストール後はマスターキーのローテーションが必須となります。この操作は次の手順で行います。

1. Talend Administration Centerの[Database Configuration] (データベース設定)ページで、[Change master key] (マスターキーを変更)をクリックします。 ![\[Change master key\] (マスターキーを変更)ダイアログボックスでは、デフォルト値はadminです。](https://help.qlik.com/talend/ja-JP/installation-guide-linux/Resources/images/tac_change_master_key.png)

2. [Change master key] (マスターキーを変更)フィールドにテキストを入力し(テキストに制限はありません)、[Launch Key Rotation] (キーローテーションを開始)をクリックします。

   新しいマスターキーはSHA256でハッシュされ、base256でエンコードされて<tomcat\_path>\WEB-INF\classes\configuration.propertiesに保存されます。また、このマスターキーが最後に使用された時の情報を持つプロパティも追加されています。例:

   ```
   master.key.2020-08-19-17-40=âjhiàkjjiinioliâknqãolmßqppãllkß
   master.key.2020-08-19-17-40_LastUsed=2020-08-19
   ```

   2020-08-19-17-40は新しいマスターキーの識別子で、どのマスターキーが最新のものかを理解できるよう、マスターキーの作成時刻が含まれています。

   機密データの再暗号化が開始され、マスターキーローテーションの実行がログ設定に従って記録されます。詳細は、[Setting up the Logging parameters](https://help.qlik.com/talend/en-US/administration-center-user-guide/8.0/setting-up-logging-parameters)をご覧ください。

   master.key.cleanerに正数を設定すれば、未使用のマスターキーを手動でクリーンアップしたり、データベースに自動クリーナーを設定したりできます。デフォルトでは自動マスターキークリーナーは無効化されています。master.key.cleanerの値はマスターキーのクリーンアップまでの未使用日数を意味します。最新のマスターキーが削除されることはありません。

   情報メモ警告:

   master.key.\*\*\*プロパティを<tomcat\_path>\WEB-INF\classes\configuration.propertiesで直接変更したり追加したりすることはできません。削除できるのは未使用のマスターキーのみです。

   同じ名前のmaster.key.\*\*\*がある場合は、いずれかのデータベースでローテーションを行い、古いマスターキーを削除する必要があります。

お使いのTalend Administration Centerがクラスターモードの場合は、次の手順に従ってマスターキーのローテーションを行ってください。

1. マスターキーのローテーションが実行されるノードを除き、クラスター内のTalend Administration Centerノードをすべて停止します。
2. [Database Configuration] (データベース設定)ページでマスターキーのローテーションを開始します。
3. <tomcat\_path>\WEB-INF\classes\configuration.propertiesに生成された新しいマスターキーであるmaster.key.YYYY-MM-dd-HH-ssを、全Talend Administration Centerノードのconfiguration.propertiesにコピーします。
4. Talend Administration Center停止していたノードを開始します。

## Talend Administration Centerの環境変数での暗号化マスターキーの指定

セキュリティ向上の目的で、Talend Administration Centerの環境変数に暗号化用のマスターキーを指定できます。

* データベース設定でマスターキーのローテーションが完了している必要があります。
* Talend Administration Centerが停止されている必要があります。

1. configuration.propertiesファイルからマスターキーをコピーします。

2. フォーマットを変更します。例: master.key.2026-03-04-13-50をTAC\_MASTER\_KEY\_2026\_03\_04\_13\_50に変更。

3. 新しいフォーマットのマスターキーをシステムの環境変数に追加し、変更を保存します。

   クラスターモードの場合は、クラスターの各ノードの環境変数に追加する必要があります。

   ![システム変数の編集。](https://help.qlik.com/talend/ja-JP/installation-guide-linux/Resources/images/edit-environment-variable.png)

4. configuration.propertiesファイルから、マスターキーを削除します(この例ではmaster.key.2026-03-04-13-50)。

5. Talend Administration Centerを開始します。

   マスターキーが環境変数から取得されるようになりました。