メインコンテンツへ移動

MySQL TLS 接続設定

HAP から MySQL に片方向 TLS または mTLS で接続するための設定方法を説明します。

設定前に、MySQL で TLS が有効になっていることを確認してください。片方向 TLS に使用するアカウントでは、クライアント証明書を必須にできません。例えば REQUIRE X509 は設定しないでください。

mTLS では、MySQL がクライアント証明書を発行した CA を信頼している必要があります。アカウントでクライアント証明書を必須にするには、REQUIRE X509 を設定します。

証明書の準備​

次の証明書ファイルを用意し、コンテナ内のサービスが読み取れることを確認してください。

ファイル説明
mysql-ca-cert.pemMySQL サーバー証明書の検証に使用する CA 証明書
mysql-client-cert.pemクライアント証明書(mTLS で使用)
mysql-client-key.pemクライアント秘密鍵(mTLS で使用)

片方向 TLS では CA 証明書のみを用意します。mTLS ではクライアント証明書と秘密鍵も必要です。

以下の例では、証明書をコンテナ内の /etc/mysql/ssl/ にマウントします。パスは変更できますが、接続設定のパスと一致させてください。接続アドレスは MySQL サーバー証明書の名前と一致する必要があります。

証明書のマウント​

  1. 証明書をサーバーに保存します。例えば、docker-compose.yaml と同じ階層の volume/mysql/ssl/ に配置します。

  2. /data/mingdao/script/docker-compose.yaml の既存の app サービスの volumes に証明書のマウントを追加します。

services:
app:
volumes:
- ./volume/mysql/ssl/mysql-ca-cert.pem:/etc/mysql/ssl/mysql-ca-cert.pem:ro
- ./volume/mysql/ssl/mysql-client-cert.pem:/etc/mysql/ssl/mysql-client-cert.pem:ro
- ./volume/mysql/ssl/mysql-client-key.pem:/etc/mysql/ssl/mysql-client-key.pem:ro

片方向 TLS では CA 証明書のみをマウントし、mTLS では上記の 3 ファイルをマウントします。

接続の設定​

デプロイ方式に応じて、対象の設定ファイルを変更します。

/data/mingdao/script/docker-compose.yaml の app サービスで設定します。

認証方式に応じて次の環境変数を追加し、アドレス、ポート、ユーザー名、パスワード、証明書のパスを変更します。証明書にはコンテナ内のパスを指定します。

ENV_RDB_TYPE: '10'
ENV_RDB_URI_MDPROJECT: 'Server=192.0.2.10;Port=3306;Database=MDProject;uid=hap;password=YOUR_PASSWORD;SslMode=VerifyFull;SslCa=/etc/mysql/ssl/mysql-ca-cert.pem;'
ENV_RDB_URI_MDLOG: 'Server=192.0.2.10;Port=3306;Database=MDLog;uid=hap;password=YOUR_PASSWORD;SslMode=VerifyFull;SslCa=/etc/mysql/ssl/mysql-ca-cert.pem;'
ENV_RDB_URI_MDSTRUCTURE: 'Server=192.0.2.10;Port=3306;Database=MDStructure;uid=hap;password=YOUR_PASSWORD;SslMode=VerifyFull;SslCa=/etc/mysql/ssl/mysql-ca-cert.pem;'
ENV_RDB_URI_MDCALENDAR: 'Server=192.0.2.10;Port=3306;Database=MDCalendar;uid=hap;password=YOUR_PASSWORD;SslMode=VerifyFull;SslCa=/etc/mysql/ssl/mysql-ca-cert.pem;'
ENV_RDB_URI_MDAPPLICATION: 'Server=192.0.2.10;Port=3306;Database=MDApplication;uid=hap;password=YOUR_PASSWORD;SslMode=VerifyFull;SslCa=/etc/mysql/ssl/mysql-ca-cert.pem;'

ENV_RDB_URI_* は既存の ENV_MYSQL_* 接続設定より優先されます。他のサービスやメンテナンススクリプトが使用していないことを確認した後、既存のアドレス、ポート、ユーザー名、パスワードの変数を削除できます。

MySQL Router 経由で MGR に接続する場合、Server に Router のアドレスを指定します。複数ある場合はカンマで区切ります。Port には Router の読み書き用ポートを指定します。

接続アドレスは TLS で検証するサーバー証明書と一致する必要があります。IP アドレスを使用する場合、証明書にその IP アドレスが含まれている必要があります。

設定後、シングルモードではインストールマネージャーのディレクトリで次のコマンドを実行し、app コンテナを再作成して Compose の設定を反映します。

docker compose -f docker-compose.yaml up -d --no-deps --force-recreate app

その後、HAP マイクロサービスを再起動します。クラスターモードでは設定を適用し、HAP マイクロサービスを再起動します。