MySQL TLS 接続設定
HAP から MySQL に片方向 TLS または mTLS で接続するための設定方法を説明します。
設定前に、MySQL で TLS が有効になっていることを確認してください。片方向 TLS に使用するアカウントでは、クライアント証明書を必須にできません。例えば REQUIRE X509 は設定しないでください。
mTLS では、MySQL がクライアント証明書を発行した CA を信頼している必要があります。アカウントでクライアント証明書を必須にするには、REQUIRE X509 を設定します。
証明書の準備
次の証明書ファイルを用意し、コンテナ内のサービスが読み取れることを確認してください。
| ファイル | 説明 |
|---|---|
mysql-ca-cert.pem | MySQL サーバー証明書の検証に使用する CA 証明書 |
mysql-client-cert.pem | クライアント証明書(mTLS で使用) |
mysql-client-key.pem | クライアント秘密鍵(mTLS で使用) |
片方向 TLS では CA 証明書のみを用意します。mTLS ではクライアント証明書と秘密鍵も必要です。
以下の例では、証明書をコンテナ内の /etc/mysql/ssl/ にマウントします。パスは変更できますが、接続設定のパスと一致させてください。接続アドレスは MySQL サーバー証明書の名前と一致する必要があります。
証明書のマウント
- HAP シングルモード(Docker Compose)
- HAP クラスターモード(Kubernetes)
-
証明書をサーバーに保存します。例えば、
docker-compose.yamlと同じ階層のvolume/mysql/ssl/に配置します。 -
/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 ファイルをマウントします。
-
設定ファイルのマウントを参照し、必要な証明書ファイルをそれぞれコンテナ内にマウントします。
- 片方向 TLS:CA 証明書をマウントします。
- mTLS:CA 証明書、クライアント証明書、秘密鍵をマウントします。
各ファイルには、
ENV_SERVICE_CONFIGで始まる異なる環境変数を使用します。 -
コンテナ内のマウント先が、以下の接続設定に指定する証明書のパスと一致することを確認します。
接続の設定
デプロイ方式に応じて、対象の設定ファイルを変更します。
- HAP シングルモード(Docker Compose)
- HAP クラスターモード(Kubernetes)
/data/mingdao/script/docker-compose.yaml の app サービスで設定します。
マイクロサービスの config.yaml で設定します。
認証方式に応じて次の環境変数を追加し、アドレス、ポート、ユーザー名、パスワード、証明書のパスを変更します。証明書にはコンテナ内のパスを指定します。
- 片方向 TLS
- mTLS 相互認証
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_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;SslCert=/etc/mysql/ssl/mysql-client-cert.pem;SslKey=/etc/mysql/ssl/mysql-client-key.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;SslCert=/etc/mysql/ssl/mysql-client-cert.pem;SslKey=/etc/mysql/ssl/mysql-client-key.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;SslCert=/etc/mysql/ssl/mysql-client-cert.pem;SslKey=/etc/mysql/ssl/mysql-client-key.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;SslCert=/etc/mysql/ssl/mysql-client-cert.pem;SslKey=/etc/mysql/ssl/mysql-client-key.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;SslCert=/etc/mysql/ssl/mysql-client-cert.pem;SslKey=/etc/mysql/ssl/mysql-client-key.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 マイクロサービスを再起動します。