Auf dieser Seite werden die mTLS-Wartungsaufgaben von Apigee beschrieben, die regelmäßig ausgeführt werden müssen.
Lokale Zertifikate rotieren
Lokale Zertifikate, die auf jedem Apigee-Host installiert sind, müssen jährlich durch neue ersetzt werden. Dies wird als Rotation von Zertifikaten bezeichnet. Es gibt zwei Möglichkeiten, Zertifikate zu rotieren, je nachdem, ob Sie eine benutzerdefinierte Zertifizierungsstelle oder ein von Consul installiertes Zertifikat verwenden.
Lokale Zertifikate ohne benutzerdefinierte Zertifizierungsstelle (CA) rotieren
Die einfachste Möglichkeit, Zertifikate ohne benutzerdefinierte Zertifizierungsstelle zu rotieren, besteht darin, apigee-mtls zu deinstallieren und neu zu installieren.
Dadurch werden alle alten Zertifikate entfernt und neue Zertifikate lokal generiert.
Sie können dies mit minimaler Ausfallzeit tun, indem Sie die folgenden Befehle nacheinander auf jedem Host ausführen:
Hinweis: Hierbei wird davon ausgegangen, dass dieselbe silent.conf-Datei vorhanden ist, die für die Erstinstallation verwendet wurde.
- Beenden Sie alle Apigee-Kernkomponenten:
Siehe Alle Komponenten starten/beenden/prüfen./opt/apigee/apigee-service/bin/apigee-all stop
apigee-mtlsbeenden:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
apigee-mtlsdeinstallieren:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall
apigee-mtlsneu installieren:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls install
- Führen Sie
apigee-mtls setupaus./opt/apigee/apigee-service/bin/apigee-service apigee-mtls setup -f /opt/silent.conf
- Starten Sie
apigee-mtlsneu:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
- Starten Sie alle Apigee-Kernkomponenten neu:
Siehe Alle Komponenten starten/beenden/prüfen./opt/apigee/apigee-service/bin/apigee-all start
Lokale Zertifikate mit einer benutzerdefinierten Zertifizierungsstelle (CA) rotieren
So rotieren Sie lokale Zertifikate mit einer benutzerdefinierten CA:
- Folgen Sie der Anleitung unter Benutzerdefiniertes Zertifikat verwenden, um die neuen Zertifikate zu generieren, die Sie verwenden möchten.
- Beenden Sie alle Apigee-Kernkomponenten:
Siehe Alle Komponenten starten/beenden/prüfen./opt/apigee/apigee-service/bin/apigee-all stop
apigee-mtlsbeenden:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
- Entfernen Sie die alten lokalen Zertifikatsdateien:
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 - Kopieren Sie das im ersten Schritt generierte neue Zertifikat/Schlüsselpaar an die folgenden Speicherorte und aktualisieren Sie die Berechtigungen:
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 - Starten Sie
apigee-mtlsneu:/opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
- Starten Sie alle Apigee-Kernkomponenten neu:
Siehe Alle Komponenten starten/beenden/prüfen./opt/apigee/apigee-service/bin/apigee-all start