Zertifikat für die Paketvalidierung aktualisieren

In diesem Dokument wird beschrieben, wie Sie die Root-Zertifizierungsstelle (CA) aktualisieren, die für die Paketvalidierung in der Google Distributed Cloud (GDC) Air-Gapped-Appliance verwendet wird.

Bei der GDC-Paketvalidierung wird eine Root-Zertifizierungsstelle verwendet, um Release-Schlüsselzertifikate zu validieren. Sie müssen diese Stammzertifizierungsstelle aktualisieren, wenn dies in einer Release-Mitteilung gefordert wird oder wenn Sie während eines Systemupgrades eine Warnmeldung sehen.

Hinweis

Fordern Sie die erforderlichen Berechtigungen von Ihrem IAM-Administrator an. Erzwingen Sie den Zugriff mit den geringsten Berechtigungen, indem Sie nur die Rollen anfordern, die für Ihre spezifischen Aufgaben erforderlich sind.

Erforderlicher Zugriff

Wenn Sie das Zertifikat für die Paketvalidierung aktualisieren möchten, müssen Sie eine der folgenden Optionen verwenden, um das package-validation-root-certs-ConfigMap-Objekt im Organisationsinfrastrukturcluster (root-infra) zu prüfen und zu aktualisieren:

  • Verwenden Sie die Datei root-infra kubeconfig aus den Notfall-Anmeldedaten, die Sie während der Einrichtung der Appliance gespeichert haben.
  • Bitten Sie Ihren Security Admin, dem Runbook IAM-R0013 zu folgen, um temporäre Role- und RoleBinding-Ressourcen für Sie im Namespace harbor-system zu erstellen. Die Ressource Role muss die Berechtigungen get, update und patch für ConfigMap-Objekte gewähren, wobei das Feld resourceNames auf ["package-validation-root-certs"] festgelegt ist.

Prüfen, ob ein Zertifikatsupgrade erforderlich ist

Prüfen Sie vor dem Ausführen des Vorgangs, ob ein Upgrade des Zertifikats für die Paketvalidierung erforderlich ist. Vergleichen Sie dazu die aktive ConfigMap in Ihrem Cluster mit dem neuesten Staging-Root-Zertifikat im Upgrade-Bundle:

  1. Legen Sie die Umgebungsvariable KUBECONFIG fest:

    $ KUBECONFIG=PATH_TO_KUBECONFIG_FILE
    

    Ersetzen Sie PATH_TO_KUBECONFIG_FILE durch den Pfad zur kubeconfig-Datei, die Sie für den Organisationsinfrastrukturcluster (root-infra) erhalten haben.

  2. Prüfen Sie, ob ein Upgrade erforderlich ist, indem Sie den aktuellen Trust-Anchor mit dem neuesten Trust-Anchor vergleichen. Die ConfigMap-Daten unter harbor-system/package-validation-root-certs werden mit dem lokalen Trust-Anchor verglichen:

    $ CURRENT_TRUST_ANCHOR=$(kubectl  --kubeconfig=$KUBECONFIG get cm package-validation-root-certs -n harbor-system -o jsonpath='{.data.ca\.crt}')
    
    $ LATEST_TRUST_ANCHOR=$(cat /root/release/staging_root_ca_certificate.crt)
    
    $ diff <( echo "$CURRENT_TRUST_ANCHOR" ) <( echo "$LATEST_TRUST_ANCHOR" ) && echo trust anchors are same  || echo trust anchors are different, upgrade required!
    

Zertifikat upgraden

Wenn ein Upgrade erforderlich ist, aktualisieren Sie das ConfigMap-Objekt unter harbor-system/package-validation-root-certs im Cluster der Organisationsinfrastruktur (root-infra).

  1. Legen Sie die Umgebungsvariable KUBECONFIG fest:

    $ KUBECONFIG=PATH_TO_KUBECONFIG_FILE
    

    Ersetzen Sie PATH_TO_KUBECONFIG_FILE durch den Pfad zur kubeconfig-Datei, die Sie für den Organisationsinfrastrukturcluster (root-infra) erhalten haben.

  2. Erstellen Sie die folgenden Variablen und weisen Sie ihnen Werte zu:

    USERNAME=USER_NAME #IO
    TARGET_FOLDER=/tmp/${USERNAME}
    OUTPUT="${TARGET_FOLDER}/package-validation-root-certs.yaml"
    LATEST_TRUST_ANCHOR_CA_FILE=/root/release/staging_root_ca_certificate.crt
    CONFIGMAP_NAME=package-validation-root-certs
    NAMESPACE=harbor-system
    

    Ersetzen Sie USER_NAME durch den AA-Nutzernamen.

  3. Erstellen Sie den Zielordner, der die Ausgabedateien des Zertifikats-Upgrades enthalten soll:

    mkdir -p "${TARGET_FOLDER}"
    
  4. Rufen Sie den aktuellen Trust-Anchor ab und speichern Sie ihn in einer lokalen temporären Datei:

    CURRENT_TRUST_ANCHOR=$(kubectl  --kubeconfig=$KUBECONFIG get configmap "${CONFIGMAP_NAME}" -n "${NAMESPACE}" -o jsonpath="{.data.ca\.crt}" )
    CURRENT_TRUST_ANCHOR_CA_FILE=$(mktemp)
    echo "$CURRENT_TRUST_ANCHOR" > "${CURRENT_TRUST_ANCHOR_CA_FILE}"
    
  5. Generieren Sie die aktualisierte Trust-Anchor-Datei:

    cat <<EOF  > "${OUTPUT}"
    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: ${CONFIGMAP_NAME}
      namespace: ${NAMESPACE}
    data:
      ca.crt: |
    $(sed 's/^/    /' "${LATEST_TRUST_ANCHOR_CA_FILE}")
    $(sed 's/^/    /' "${CURRENT_TRUST_ANCHOR_CA_FILE}")
    EOF
    
  6. Prüfen Sie, ob der Trust-Anchor korrekt aktualisiert wurde:

    Der Trust-Anchor muss sowohl das aktuelle als auch das neueste Trust-Anchor-Zertifikat enthalten.

    $ cat "${OUTPUT}"
    apiVersion: v1
    data:
      ca.crt: |
        -----BEGIN CERTIFICATE-----
        (certificate content)
        -----END CERTIFICATE-----
        -----BEGIN CERTIFICATE-----
        (certificate content)
        -----END CERTIFICATE-----
        (other certificate)
    kind: ConfigMap
    metadata:
      name: package-validation-root-certs
      namespace: harbor-system
    
  7. Wenden Sie die neue Konfiguration mit kubectl an:

      kubectl --kubeconfig=$KUBECONFIG apply -f ${OUTPUT}
    
  8. Prüfen Sie, ob die neu angewendete ca.crt in der ConfigMap vorhanden ist:

      kubectl --kubeconfig=$KUBECONFIG describe configmap package-validation-root-certs -n harbor-system
    

Dadurch wird ein neues Zertifikat in der package-validation-root-cert aktualisiert.