パッケージ検証証明書をアップグレードする

このドキュメントでは、Google Distributed Cloud(GDC)エアギャップ アプライアンスでパッケージ検証に使用されるルート認証局(CA)をアップグレードする方法について説明します。

GDC パッケージの検証では、ルート認証局(CA)を使用してリリースキー証明書を検証します。リリース通知で必要な場合、またはシステム アップグレード中に警告メッセージが表示された場合は、このルート CA をアップグレードする必要があります。

始める前に

IAM 管理者に必要な権限をリクエストします。特定のタスクに必要なロールのみをリクエストして、最小権限でのアクセスを適用します。

必要なアクセス権

パッケージ検証証明書をアップグレードするには、次のいずれかのオプションを使用して、組織インフラストラクチャ クラスタ(root-infra)の package-validation-root-certs ConfigMap オブジェクトを検査して更新する必要があります。

  • アプライアンスの設定時に保存した緊急認証情報の root-infra kubeconfig ファイルを使用します。
  • セキュリティ管理者に、IAM-R0013 ランブックに沿って、harbor-system 名前空間に一時的な Role リソースと RoleBinding リソースを作成するよう依頼します。Role リソースは、resourceNames フィールドが ["package-validation-root-certs"] に設定された ConfigMap オブジェクトに対する get、update、patch 権限を付与する必要があります。

証明書のアップグレードが必要であることを確認する

オペレーションを実行する前に、クラスタ内のアクティブな ConfigMap とアップグレード バンドルの最新のステージング ルート証明書を比較して、パッケージ検証証明書のアップグレードが必要かどうかを確認します。

  1. KUBECONFIG 環境変数を設定します。

    $ KUBECONFIG=PATH_TO_KUBECONFIG_FILE
    

    PATH_TO_KUBECONFIG_FILE は、組織インフラストラクチャ クラスタ(root-infra)用に取得した kubeconfig ファイルのパスに置き換えます。

  2. 現在のトラスト アンカーと最新のトラスト アンカーを比較して、アップグレードが必要かどうかを判断します。harbor-system/package-validation-root-certs の ConfigMap データがローカル トラスト アンカーと比較されます。

    $ 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!
    

証明書をアップグレードする

アップグレードが必要な場合は、組織インフラストラクチャ クラスタ(root-infra)の harbor-system/package-validation-root-certs にある ConfigMap オブジェクトを更新します。

  1. KUBECONFIG 環境変数を設定します。

    $ KUBECONFIG=PATH_TO_KUBECONFIG_FILE
    

    PATH_TO_KUBECONFIG_FILE は、組織インフラストラクチャ クラスタ(root-infra)用に取得した kubeconfig ファイルのパスに置き換えます。

  2. 次の変数を作成して値を割り当てます。

    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
    

    USER_NAME は、IO ユーザー名に置き換えます。

  3. 証明書のアップグレード プロセスの出力ファイルを格納するターゲット フォルダを作成します。

    mkdir -p "${TARGET_FOLDER}"
    
  4. 現在のトラスト アンカーを取得し、ローカルの一時ファイルに保存します。

    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. 更新されたトラスト アンカー ファイルを生成します。

    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. トラスト アンカーが正しく更新されたことを確認します。

    トラスト アンカーには、現在のトラスト アンカー証明書と最新のトラスト アンカー証明書の両方が含まれている必要があります。

    $ 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. kubectl を使用して新しい構成を適用します。

      kubectl --kubeconfig=$KUBECONFIG apply -f ${OUTPUT}
    
  8. 新しく適用された ca.crt が ConfigMap 内に存在することを確認します。

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

これにより、package-validation-root-cert で新しい証明書がアップグレードされます。