Recupera bundle di attendibilità GDC

Un bundle di attendibilità, noto anche come elenco di attendibilità, è un gruppo di trust anchor, come le entità, che sono intrinsecamente attendibili e la cui attendibilità non viene trasferita da un'altra entità (terze parti attendibili). Questi trust anchor vengono forniti come certificati dell'autorità di certificazione (CA). L'algoritmo di creazione del percorso di certificazione utilizza questi certificati CA per stabilire una catena tra un certificato che ottiene la convalida e i trust anchor.

Questo documento è rivolto ai membri del gruppo di amministratori della piattaforma, come amministratori IT o Security Engineer, che vogliono recuperare i bundle di attendibilità GDC. Per saperne di più, consulta la documentazione sui segmenti di pubblico per GDC con air gap.

Prima di iniziare

Prima di recuperare i bundle di attendibilità di GDC, devi stabilire l'attendibilità iniziale per le nuove organizzazioni. Questo passaggio è obbligatorio sia per il metodo del server well-known sia per il metodo kubectl, ma solo se ti connetti a una nuova organizzazione per la prima volta.

Per il metodo del server noto, non sono richiesti altri prerequisiti. Per il metodo kubectl, devi anche completare i prerequisiti relativi alle autorizzazioni e agli strumenti.

Stabilisci la fiducia iniziale per le nuove organizzazioni

Se ti connetti a una nuova organizzazione GDC per la prima volta, devi stabilire un trust iniziale. Questa procedura una tantum garantisce una connessione sicura, in quanto l'autorità di certificazione (CA) dell'organizzazione viene considerata attendibile sul computer client.

  1. Contatta un membro del gruppo di operatori dell'infrastruttura (IO) per richiedere il bundle di attendibilità iniziale per la nuova organizzazione. L'IO ha l'accesso necessario per recuperare questo bundle, che in genere proviene dal secret trust-store-root-ext all'interno del cluster dell'infrastruttura dell'organizzazione.

  2. Ottieni il file del bundle di attendibilità iniziale dal tuo IO tramite un canale sicuro esterno a GDC, come definito dalle policy di sicurezza della tua organizzazione.

  3. Installa il bundle di attendibilità nell'archivio di attendibilità della macchina client, seguendo le procedure standard del tuo sistema per considerare attendibili i certificati CA radice.

Se hai bisogno di accedere a ServiceNow, ottieni e installa anche il bundle di attendibilità dell'organizzazione gdchservices utilizzando la stessa procedura.

Richiedi ruoli IAM

Per recuperare il bundle di attendibilità con kubectl, devi disporre dell'autorizzazione per visualizzare i secret. Contatta l'amministratore dell'organizzazione IAM per richiedere il ruolo Visualizzatore archivio di attendibilità (trust-store-viewer).

prepara l'ambiente

Per utilizzare il metodo kubectl, prepara l'ambiente locale:

Tipi di bundle di attendibilità

Distributed Cloud fornisce due tipi di bundle di attendibilità gestiti per gli amministratori della piattaforma:

  • trust-store-root-ext: contiene la CA radice interna e la CA web-tls. I contenuti sono diversi a seconda di dove si trovano, ad esempio nella radice o nell'organizzazione tenant. Utilizza questo trust bundle per comunicare oltre i confini dell'organizzazione o per accedere a servizi come l'archiviazione di oggetti all'interno dell'organizzazione.

  • trust-store-global-root-ext: disponibile nel server API globale e nello spazio dei nomi platform del server API di zona. Quando il server API globale è pronto, il bundle compila tutti gli altri dati trust-store-root-ext di zona, inclusi i dati locali.

Recupera il bundle di attendibilità

Puoi recuperare i bundle di attendibilità dall'endpoint del server noto o dal cluster utilizzando kubectl.

Recupero dal server well-known

GDC fornisce un modo sicuro per accedere ai bundle di attendibilità tramite un endpoint server noto. Utilizza questo metodo quando devi recuperare il bundle trust-store-global-root-ext senza interagire direttamente con il cluster utilizzando kubectl.

Prima di eseguire i passaggi descritti in questa sezione, assicurati di aver stabilito l'attendibilità iniziale con le CA specifiche della tua organizzazione.

Linux

  1. Esporta le seguenti variabili di ambiente:

    export STORAGE=STORAGE
    export ORG_NAME=ORG_NAME
    export DNS_SUFFIX=DNS_SUFFIX
    

    Sostituisci quanto segue:

    • STORAGE: il percorso della directory in cui vuoi archiviare il file del bundle di attendibilità.
    • ORG_NAME: il nome della tua organizzazione all'interno di GDC.
    • DNS_SUFFIX: il tuo suffisso DNS. Ad esempio, se uno dei tuoi domini è org-1.zone1.google.gdch.test, il suffisso DNS è zone1.google.gdch.test.
  2. Imposta la variabile di ambiente WELL_KNOWN_URL:

    export WELL_KNOWN_URL="https://console.${ORG_NAME:?}.${DNS_SUFFIX:?}/.well-known/certificate-authority"
    
  3. Imposta la variabile di ambiente GLOBAL_TRUST_BUNDLE_FILE. Questo file archivia il trust bundle GDC localmente nella posizione $STORAGE specificata.

    export GLOBAL_TRUST_BUNDLE_FILE="${STORAGE:?}/global/ca-bundles/global-trust-bundle"
    
  4. Crea la directory per il file del bundle di attendibilità:

    mkdir -p "$(dirname "${GLOBAL_TRUST_BUNDLE_FILE:?}")"
    
  5. Ottieni il bundle di attendibilità trust-store-global-root-ext dal server noto e memorizzalo nel file specificato dalla variabile di ambiente GLOBAL_TRUST_BUNDLE_FILE:

    curl "${WELL_KNOWN_URL:?}" | sed '$a\' > "${GLOBAL_TRUST_BUNDLE_FILE:?}"
    

Windows

  1. Imposta le seguenti variabili PowerShell:

    $STORAGE = "STORAGE"
    $ORG_NAME = "ORG_NAME"
    $DNS_SUFFIX = "DNS_SUFFIX"
    

    Sostituisci quanto segue:

    • STORAGE: il percorso della directory in cui vuoi archiviare il file del bundle di attendibilità, ad esempio C:\Users\username\bundles.
    • ORG_NAME: il nome della tua organizzazione all'interno di GDC.
    • DNS_SUFFIX: il tuo suffisso DNS. Ad esempio, se uno dei tuoi domini è org-1.zone1.google.gdch.test, il suffisso DNS è zone1.google.gdch.test.
  2. Crea la directory per il file del bundle di attendibilità:

    New-Item -ItemType Directory -Force -Path (Split-Path -Path "STORAGE\global\ca-bundles\global-trust-bundle")
    
  3. Ottieni il bundle di attendibilità trust-store-global-root-ext dal server noto e archivialo nel file del bundle di attendibilità:

    Invoke-WebRequest -Uri "https://console.ORG_NAME.DNS_SUFFIX/.well-known/certificate-authority" -OutFile "STORAGE\global\ca-bundles\global-trust-bundle"
    

Il file del bundle di attendibilità recuperato contiene uno o più certificati CA. L'output è simile al seguente:

   -----BEGIN CERTIFICATE-----
   MIIC8TCCAdmgAwIBAgIRAODQ/dOB39RBs8ZpN0RujIswDQYJKoZIhvcNAQELBQAw
   EjEQMA4GA1UEAxMHcm9vdC1jYTAeFw0yNTAxMDYwNzM3MzVaFw00ODEyMzEwNzM3
   MzVaMBIxEDAOBgNVBAMTB3Jvb3QtY2EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw
   ggEKAoIBAQC41U4+3M1EAHggUBw5ki97533zTvwHukmZyORwbQ3tlQ4GQDscoCEh
   nn+KCaG767VCaGDcQhq99hl6qa/nBoc1X6WQ3a/uhv5E2ztRD40PB5NFNdSulxTH
   gsitukSmv+DAx15UJnVkJtPP/FzxEWPu0piIiFZakTxT83VUSs54QRmTahxP80FI
   R0xZ0ohsu9jzA2CAyxTccJU0/xE2kDwN8c8kiYYuG+czMdNVdnT4Jm2ToSkzIDux
   Yi9MzNmarVGG/rtW5SlqnUMYzSsxtUYSmMRlCsFDVxkSzfmICmTRw2zmNkFA/3nz
   XneVSIsUHOA2NzvMN4eoLTVRgSFcHlZRAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIB
   hjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTEeB0EQwhc5p++GhwNymsBfN93
   WjANBgkqhkiG9w0BAQsFAAOCAQEAKBqn4AXjUWmhIUOrWQ5cetsmI76Wl+RBeSzU
   HxbqMBH8Dk1oJbGHtmQbu7EmWz1pKYge650s9N83hMgjFZD24t9GiQZ7YY+i+317
   D6HzJ8VIKPnxVtnUIQzCpkRTQoglDlb1f/7+fi2SYJoHdhnRI/3OaVQTnObjbW5T
   mBhsMxFKc0zGa3HIEm9SUH608V60xUPanl23YZ6X7W8nWAJfnzKvH+3q3Fz58u/S
   VR5t/FkbOktVtnU8AfcMKLof6KG2KhE2L7FAC+fp0ZsjV9vE2uqlZ+8mIQHyc3tM
   cbWxOx+SO/XUCenY9C1yrublln9aOEn4/s3aSURPguiSZOfDyQ==
   -----END CERTIFICATE-----

Recupera dal cluster utilizzando kubectl

Puoi recuperare i bundle di attendibilità direttamente dal cluster GDC utilizzando lo strumento a riga di comando kubectl. Utilizza questo metodo se hai accesso diretto al cluster e alla sua configurazione e devi recuperare i bundle di attendibilità trust-store-root-ext o trust-store-global-root-ext.

Prima di eseguire i passaggi descritti in questa sezione, assicurati di aver stabilito l'attendibilità iniziale con le CA specifiche della tua organizzazione.

Recupera il bundle di attendibilità dal cluster utilizzando kubectl:

  1. Esporta le seguenti variabili di ambiente:

    export KUBECONFIG=MANAGEMENT_API_SERVER_KUBECONFIG
    export STORAGE=STORAGE
    export ZONE=ZONE
    

    Sostituisci quanto segue:

    • MANAGEMENT_API_SERVER_KUBECONFIG: il percorso del kubeconfig del server dell'API di gestione.
    • STORAGE: il percorso della directory in cui vuoi archiviare il file del bundle di attendibilità.
    • ZONE: il nome della zona GDC.
  2. Imposta la variabile di ambiente TRUST_BUNDLE_FILE. Questo file memorizza il bundle di attendibilità GDC localmente nella posizione $STORAGE specificata per il tuo GDC $ZONE:

    export TRUST_BUNDLE_FILE="${STORAGE:?}/${ZONE:?}/ca-bundles/trust-bundle"
    export GLOBAL_TRUST_BUNDLE_FILE="${STORAGE:?}/global/ca-bundles/global-trust-bundle"
    
  3. Imposta la variabile di ambiente dello spazio dei nomi NS per lo spazio dei nomi:

    export NS=platform
    
  4. Crea le directory per i file del bundle di attendibilità:

    mkdir -p "$(dirname "${TRUST_BUNDLE_FILE:?}")"
    mkdir -p "$(dirname "${GLOBAL_TRUST_BUNDLE_FILE:?}")"
    
  5. Ottieni le autorità di certificazione (CA) e memorizzale nei file specificati dalle variabili di ambiente TRUST_BUNDLE_FILE e GLOBAL_TRUST_BUNDLE_FILE:

    Per trust-store-root-ext:

    kubectl --kubeconfig ${KUBECONFIG:?} get secret trust-store-root-ext -n ${NS:?} -o go-template='{{ index .data "ca.crt" }}' | base64 -d | sed '$a\' > ${TRUST_BUNDLE_FILE:?}
    

    Per trust-store-global-root-ext:

    kubectl --kubeconfig ${KUBECONFIG:?} get secret trust-store-global-root-ext -n ${NS:?} -o go-template='{{ index .data "ca.crt" }}' | base64 -d | sed '$a\' > ${GLOBAL_TRUST_BUNDLE_FILE:?}
    

    Il file del bundle di attendibilità recuperato contiene uno o più certificati CA. L'output è simile al seguente:

    -----BEGIN CERTIFICATE-----
    MIIC8TCCAdmgAwIBAgIRAODQ/dOB39RBs8ZpN0RujIswDQYJKoZIhvcNAQELBQAw
    EjEQMA4GA1UEAxMHcm9vdC1jYTAeFw0yNTAxMDYwNzM3MzVaFw00ODEyMzEwNzM3
    MzVaMBIxEDAOBgNVBAMTB3Jvb3QtY2EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw
    ggEKAoIBAQC41U4+3M1EAHggUBw5ki97533zTvwHukmZyORwbQ3tlQ4GQDscoCEh
    nn+KCaG767VCaGDcQhq99hl6qa/nBoc1X6WQ3a/uhv5E2ztRD40PB5NFNdSulxTH
    gsitukSmv+DAx15UJnVkJtPP/FzxEWPu0piIiFZakTxT83VUSs54QRmTahxP80FI
    R0xZ0ohsu9jzA2CAyxTccJU0/xE2kDwN8c8kiYYuG+czMdNVdnT4Jm2ToSkzIDux
    Yi9MzNmarVGG/rtW5SlqnUMYzSsxtUYSmMRlCsFDVxkSzfmICmTRw2zmNkFA/3nz
    XneVSIsUHOA2NzvMN4eoLTVRgSFcHlZRAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIB
    hjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTEeB0EQwhc5p++GhwNymsBfN93
    WjANBgkqhkiG9w0BAQsFAAOCAQEAKBqn4AXjUWmhIUOrWQ5cetsmI76Wl+RBeSzU
    HxbqMBH8Dk1oJbGHtmQbu7EmWz1pKYge650s9N83hMgjFZD24t9GiQZ7YY+i+317
    D6HzJ8VIKPnxVtnUIQzCpkRTQoglDlb1f/7+fi2SYJoHdhnRI/3OaVQTnObjbW5T
    mBhsMxFKc0zGa3HIEm9SUH608V60xUPanl23YZ6X7W8nWAJfnzKvH+3q3Fz58u/S
    VR5t/FkbOktVtnU8AfcMKLof6KG2KhE2L7FAC+fp0ZsjV9vE2uqlZ+8mIQHyc3tM
    cbWxOx+SO/XUCenY9C1yrublln9aOEn4/s3aSURPguiSZOfDyQ==
    -----END CERTIFICATE-----