このページでは、定期的に実行する必要がある Apigee mTLS メンテナンス タスクについて説明します。
ローカル証明書のローテーション
各 Apigee ホストにインストールされているローカル証明書は、毎年新しいものに置き換える必要があります。これは証明書のローテーションと呼ばれます。証明書をローテーションするには、カスタム認証局を使用しているか、Consul によってインストールされた証明書を使用しているかに応じて、2 つの方法があります。
カスタム認証局(CA)を使用せずにローカル証明書をローテーションする
カスタム CA を使用せずに証明書をローテーションする最も簡単な方法は、apigee-mtls をアンインストールして再インストールすることです。これにより、既存の古い証明書がすべて削除され、新しい証明書がローカルに生成されます。ダウンタイムを最小限に抑えるには、各ホストで次のコマンドを 1 つずつ実行します。
注: これは、最初のインストールで使用されたものと同じ silent.conf ファイルが存在することを前提としています。
- Apigee のすべてのコア コンポーネントを停止します。
すべてのコンポーネントの起動/停止/確認をご覧ください。/opt/apigee/apigee-service/bin/apigee-all stop
apigee-mtlsを停止します。/opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
apigee-mtlsをアンインストールします。/opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall
apigee-mtlsを再インストールします。/opt/apigee/apigee-service/bin/apigee-service apigee-mtls install
apigee-mtls setupを実行します。/opt/apigee/apigee-service/bin/apigee-service apigee-mtls setup -f /opt/silent.conf
apigee-mtlsを再起動します。/opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
- Apigee のすべてのコア コンポーネントを再起動します。
すべてのコンポーネントの起動/停止/確認をご覧ください。/opt/apigee/apigee-service/bin/apigee-all start
カスタム認証局(CA)を使用したローカル証明書のローテーション
カスタム CA でローカル証明書をローテーションする手順は次のとおりです。
- カスタム証明書を使用するの手順に沿って、使用する新しい証明書を生成します。
- Apigee のすべてのコア コンポーネントを停止します。
すべてのコンポーネントの起動/停止/確認をご覧ください。/opt/apigee/apigee-service/bin/apigee-all stop
apigee-mtlsを停止します。/opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
- 古いローカル証明書ファイルを削除します。
rm -f /opt/apigee/apigee-mtls/certs/local_cert.pem
rm -f /opt/apigee/apigee-mtls/certs/local_key.pemrm -f /opt/apigee/apigee-mtls/source/certs/local_cert.pemrm -f /opt/apigee/apigee-mtls/source/certs/local_key.pemrm -rf /opt/apigee/data/apigee-mtls - 最初のステップで生成された新しい証明書/鍵ペアを次の場所にコピーし、権限を更新します。
cp ${new_cert} /opt/apigee/apigee-mtls/certs/local_cert.pemchmod \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/certs/local_cert.pemchown \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/certs/local_cert.pemcp ${new_cert} /opt/apigee/apigee-mtls/source/certs/local_cert.pemchmod \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemchown \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemcp ${new_key} /opt/apigee/apigee-mtls/certs/local_key.pemchmod \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemchown \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemcp ${new_key} /opt/apigee/apigee-mtls/source/certs/local_key.pemchmod \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pemchown \ --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \ /opt/apigee/apigee-mtls/source/certs/local_cert.pem apigee-mtlsを再起動します。/opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
- Apigee のすべてのコア コンポーネントを再起動します。
すべてのコンポーネントの起動/停止/確認をご覧ください。/opt/apigee/apigee-service/bin/apigee-all start