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.
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-extall'interno del cluster dell'infrastruttura dell'organizzazione.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.
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:
Scarica e installa l'interfaccia a riga di comando gdcloud, se non l'hai ancora fatto.
Genera un file kubeconfig per il server API di gestione nella zona di destinazione. Devi avere il percorso del file kubeconfig per sostituire
MANAGEMENT_API_SERVER_KUBECONFIGnei comandikubectl.
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 nomiplatformdel server API di zona. Quando il server API globale è pronto, il bundle compila tutti gli altri datitrust-store-root-extdi 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
Esporta le seguenti variabili di ambiente:
export STORAGE=STORAGE export ORG_NAME=ORG_NAME export DNS_SUFFIX=DNS_SUFFIXSostituisci 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.
Imposta la variabile di ambiente
WELL_KNOWN_URL:export WELL_KNOWN_URL="https://console.${ORG_NAME:?}.${DNS_SUFFIX:?}/.well-known/certificate-authority"Imposta la variabile di ambiente
GLOBAL_TRUST_BUNDLE_FILE. Questo file archivia il trust bundle GDC localmente nella posizione$STORAGEspecificata.export GLOBAL_TRUST_BUNDLE_FILE="${STORAGE:?}/global/ca-bundles/global-trust-bundle"Crea la directory per il file del bundle di attendibilità:
mkdir -p "$(dirname "${GLOBAL_TRUST_BUNDLE_FILE:?}")"Ottieni il bundle di attendibilità
trust-store-global-root-extdal server noto e memorizzalo nel file specificato dalla variabile di ambienteGLOBAL_TRUST_BUNDLE_FILE:curl "${WELL_KNOWN_URL:?}" | sed '$a\' > "${GLOBAL_TRUST_BUNDLE_FILE:?}"
Windows
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 esempioC:\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.
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")Ottieni il bundle di attendibilità
trust-store-global-root-extdal 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:
Esporta le seguenti variabili di ambiente:
export KUBECONFIG=MANAGEMENT_API_SERVER_KUBECONFIG export STORAGE=STORAGE export ZONE=ZONESostituisci 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.
Imposta la variabile di ambiente
TRUST_BUNDLE_FILE. Questo file memorizza il bundle di attendibilità GDC localmente nella posizione$STORAGEspecificata 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"Imposta la variabile di ambiente dello spazio dei nomi
NSper lo spazio dei nomi:export NS=platformCrea le directory per i file del bundle di attendibilità:
mkdir -p "$(dirname "${TRUST_BUNDLE_FILE:?}")" mkdir -p "$(dirname "${GLOBAL_TRUST_BUNDLE_FILE:?}")"Ottieni le autorità di certificazione (CA) e memorizzale nei file specificati dalle variabili di ambiente
TRUST_BUNDLE_FILEeGLOBAL_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-----