Apigee mTLS メンテナンス

このページでは、定期的に実行する必要がある Apigee mTLS のメンテナンス タスクについて説明します。

ローカル証明書のローテーション

各 Apigee ホストにインストールされているローカル証明書は、新しい証明書に置き換える必要があります。 毎年更新していますこれを証明書のローテーションと呼びます。証明書をローテーションする方法は 2 つあります。 Kubernetes の カスタム認証局を使用している Consul によってインストールされた証明書です。

カスタム認証局（CA）を使用しないローカル証明書のローテーション

カスタムの CA を使用せずに証明書をローテーションする最も簡単な方法は、 uninstall、 apigee-mtls を再インストールします。 これにより、存在する古い証明書がすべて削除され、新しい証明書がローカルで生成されます。 各ホストで次のコマンドを実行すると、最小限のダウンタイムでこれを実現できます。 1 つずつ作成します。

注: これは、前のステップで使用されたものと同じ silent.conf ファイルを 行います。

  1. すべての Apigee コアコンポーネントを停止します。 
    /opt/apigee/apigee-service/bin/apigee-all stop
    詳しくは、 <ph type="x-smartling-placeholder"></ph> すべてのコンポーネントを開始/停止/確認する。
  2. apigee-mtls を停止します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
  3. apigee-mtls をアンインストールします。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall
  4. apigee-mtls を再インストールします。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls install
  5. apigee-mtls setup を実行します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls setup -f /opt/silent.conf
  6. apigee-mtls を再起動します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
  7. すべての Apigee コアコンポーネントを再起動します。 
    /opt/apigee/apigee-service/bin/apigee-all start
    詳しくは、 <ph type="x-smartling-placeholder"></ph> すべてのコンポーネントを開始/停止/確認する。

カスタム認証局（CA）を使用したローカル証明書のローテーション

カスタム CA を使用してローカル証明書をローテーションするには、次の操作を行います。

  1. カスタム証明書を使用するの手順に沿って操作します。 使用する新しい証明書を生成します。
  2. すべての Apigee コアコンポーネントを停止します。 
    /opt/apigee/apigee-service/bin/apigee-all stop
    詳しくは、 <ph type="x-smartling-placeholder"></ph> すべてのコンポーネントを開始/停止/確認する。
  3. apigee-mtls を停止します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
  4. 古いローカル証明書ファイルを削除します。 
    rm -f /opt/apigee/apigee-mtls/certs/local_cert.pem
rm -f /opt/apigee/apigee-mtls/certs/local_key.pem
rm -f /opt/apigee/apigee-mtls/source/certs/local_cert.pem
rm -f /opt/apigee/apigee-mtls/source/certs/local_key.pem
rm -rf /opt/apigee/data/apigee-mtls
  5. 最初の手順で生成した新しい証明書と鍵のペアを次の場所にコピーします。 権限を更新します。 
    cp ${new_cert} /opt/apigee/apigee-mtls/certs/local_cert.pem

chmod \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/certs/local_cert.pem

chown \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/certs/local_cert.pem

cp ${new_cert} /opt/apigee/apigee-mtls/source/certs/local_cert.pem

chmod \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/source/certs/local_cert.pem

chown \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/source/certs/local_cert.pem

cp ${new_key} /opt/apigee/apigee-mtls/certs/local_key.pem

chmod \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/source/certs/local_cert.pem

chown \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/source/certs/local_cert.pem

cp ${new_key} /opt/apigee/apigee-mtls/source/certs/local_key.pem

chmod \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/source/certs/local_cert.pem

chown \
  --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
  /opt/apigee/apigee-mtls/source/certs/local_cert.pem
  6. apigee-mtls を再起動します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
  7. すべての Apigee コアコンポーネントを再起動します。 
    /opt/apigee/apigee-service/bin/apigee-all start
    詳しくは、 <ph type="x-smartling-placeholder"></ph> すべてのコンポーネントを開始/停止/確認する。