Apigee mTLS-Wartung

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.

  1. Beenden Sie alle Apigee-Kernkomponenten:
    /opt/apigee/apigee-service/bin/apigee-all stop
    Siehe Alle Komponenten starten/beenden/prüfen.
  2. apigee-mtls beenden:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
  3. apigee-mtls deinstallieren:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall
  4. apigee-mtls neu installieren:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls install
  5. Führen Sie apigee-mtls setup aus.
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls setup -f /opt/silent.conf
  6. Starten Sie apigee-mtls neu:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
  7. Starten Sie alle Apigee-Kernkomponenten neu:
    /opt/apigee/apigee-service/bin/apigee-all start
    Siehe Alle Komponenten starten/beenden/prüfen.

Lokale Zertifikate mit einer benutzerdefinierten Zertifizierungsstelle (CA) rotieren

So rotieren Sie lokale Zertifikate mit einer benutzerdefinierten CA:

  1. Folgen Sie der Anleitung unter Benutzerdefiniertes Zertifikat verwenden, um die neuen Zertifikate zu generieren, die Sie verwenden möchten.
  2. Beenden Sie alle Apigee-Kernkomponenten:
    /opt/apigee/apigee-service/bin/apigee-all stop
    Siehe Alle Komponenten starten/beenden/prüfen.
  3. apigee-mtls beenden:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop
  4. 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.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. 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.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. Starten Sie apigee-mtls neu:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start
  7. Starten Sie alle Apigee-Kernkomponenten neu:
    /opt/apigee/apigee-service/bin/apigee-all start
    Siehe Alle Komponenten starten/beenden/prüfen.