Questa pagina descrive come proteggere la catena di fornitura del software configurando Autorizzazione binaria per consentire il deployment solo delle immagini container create da Cloud Build.
Per configurare questo controllo del deployment, devi richiedere l'attestatore built-by-cloud-build
nel criterio di Autorizzazione binaria. Cloud Build
crea automaticamente l'attestatore built-by-cloud-build
nel progetto quando
esegui una build che genera immagini. Una volta create correttamente le immagini,
Cloud Build automaticamente firma e crea attestazioni. Al momento del deployment, Autorizzazione binaria verifica le attestazioni con l'attestatore built-by-cloud-build
. È consentito il deployment delle immagini verificate.
Non è consentito eseguire il deployment delle immagini che non superano la verifica e l'errore viene registrato in Cloud Audit Logs.
Per la guida end-to-end che descrive come utilizzare i metadati registrati in Cloud Build e Autorizzazione binaria, vedi Utilizzo della provenienza firmata e di Autorizzazione binaria.
Prima di iniziare
Per utilizzare questa funzionalità, devi prima effettuare le seguenti operazioni:
- Configura Autorizzazione binaria per la tua piattaforma.
Configura Cloud Build e crea un'immagine.
Configura il criterio
In questa sezione configurerai il criterio di Autorizzazione binaria in modo che richieda l'attestatore built-by-cloud-build
.
Per consentire il deployment solo delle immagini create da Cloud Build, esegui questi passaggi:
Console
Vai alla pagina Autorizzazione binaria nella console Google Cloud:
Nella scheda Norme, fai clic su Modifica norma.
Nella finestra di dialogo Modifica criterio, seleziona Consenti solo le immagini che sono state approvate da tutti i seguenti attestatori.
Fai clic su Aggiungi attestatori.
Nella finestra di dialogo Aggiungi attestatori, procedi nel seguente modo:
- Seleziona Aggiungi per nome progetto e attestatore ed esegui questi
passaggi:
- Nel campo Nome progetto, inserisci il progetto in cui esegui Cloud Build.
- Fai clic sul campo Nome attestatore e tieni presente che l'attestatore
built-by-cloud-build
è disponibile. - Fai clic su
built-by-cloud-build
.
In alternativa, seleziona Aggiungi per ID risorsa attestatore. In ID risorsa attestatore, inserisci
projects/PROJECT_ID/attestors/built-by-cloud-build
Sostituzione di
PROJECT_ID
con il progetto in cui esegui Cloud Build.
- Seleziona Aggiungi per nome progetto e attestatore ed esegui questi
passaggi:
Fai clic su Aggiungi 1 attestatore.
Fai clic su Save Policy (Salva criterio).
gcloud
Esporta il criterio esistente in un file utilizzando il seguente comando:
gcloud container binauthz policy export > /tmp/policy.yaml
Modifica il file dei criteri.
Modifica una delle seguenti regole:
defaultAdmissionRule
clusterAdmissionRules
istioServiceIdentityAdmissionRules
kubernetesServiceAccountAdmissionRules
Aggiungi un blocco
requireAttestationsBy
alla regola se non ne esiste già uno.Nel blocco
requireAttestationsBy
, aggiungiprojects/PROJECT_ID/attestors/built-by-cloud-build
Sostituzione di
PROJECT_ID
con il progetto in cui esegui Cloud Build.Salva il file dei criteri.
Importa il file dei criteri.
gcloud container binauthz policy import /tmp/policy.yaml
Quello che segue è un file dei criteri di esempio che contiene il riferimento a
built-by-cloud-build-attestor
:defaultAdmissionRule: evaluationMode: REQUIRE_ATTESTATION enforcementMode: ENFORCED_BLOCK_AND_AUDIT_LOG requireAttestationsBy: - projects/PROJECT_ID/attestors/built-by-cloud-build name: projects/PROJECT_ID/policy
Sostituisci
PROJECT_ID
con l'ID progetto in cui esegui Cloud Build.
Passaggi successivi
- Anziché impedire il deployment delle immagini, puoi utilizzare la modalità di prova per registrare le violazioni dei criteri.
- Visualizza gli eventi dei log di controllo per le immagini non consentite su Google Kubernetes Engine (GKE) o Cloud Run.