Torna agli aggiornamenti
New releaseAug 6, 2026

cosign v3.1.3

Firma del codice e trasparenza per contenitori e binari

Condividi

Cosign logo

cosign

Firma di container OCI (e altri artefatti) utilizzando Sigstore!

Go Report Card e2e-tests CII Best Practices OpenSSF Scorecard

Cosign mira a rendere le firme infrastruttura invisibile.

Cosign supporta:

  • "Firma senza chiave" con l'autorità di certificazione Fulcio del bene pubblico Sigstore e il registro di trasparenza Rekor (predefinito)
  • Firma con hardware e KMS
  • Firma con una coppia di chiavi privata/pubblica cifrata generata da cosign
  • Firma, verifica e archiviazione di container in un registro OCI.
  • Bring-your-own PKI

Informazioni

Cosign è sviluppato come parte del progetto sigstore. Utilizziamo anche un canale slack! Clicca qui per il link di invito.

Installazione

Per installazioni tramite Homebrew, Arch, Nix, GitHub Action e Kubernetes consulta la documentazione di installazione.

Per i binari Linux, macOS e Windows, consulta gli asset della release GitHub.

🚨 Se stai scaricando le release di cosign dal nostro bucket GCS - consulta maggiori informazioni sull'avviso di deprecazione del 31 luglio 2023 🚨

Installazione per sviluppatori

Se disponi di Go 1.22+, puoi configurare un ambiente di sviluppo:

$ git clone https://github.com/sigstore/cosign
$ cd cosign
$ go install ./cmd/cosign
$ $(go env GOPATH)/bin/cosign

Contribuire

Se sei interessato a contribuire a cosign, leggi la documentazione per i contributori.

Lo sviluppo futuro di Cosign sarà incentrato sulla prossima major release, che sarà basata su sigstore-go. I maintainer si concentreranno sullo sviluppo delle funzionalità all'interno di sigstore-go. I contributi a sigstore-go, in particolare per quanto riguarda le chiavi personalizzate e la firma, sono apprezzati. Consulta il tracker delle issue per le good first issue.

Cosign 2.x è una release stabile e continuerà a ricevere aggiornamenti periodici delle funzionalità e correzioni di bug. Le PR di portata e dimensioni ridotte hanno maggiori probabilità di essere revisionate rapidamente.

Le PR che modificano significativamente o rompono l'API non saranno accettate. Le PR di dimensioni significative ma che non introducono modifiche incompatibili potrebbero essere accettate, ma saranno considerate a priorità inferiore rispetto alle PR in sigstore-go.

Dockerfile

Ecco come installare e utilizzare cosign all'interno di un Dockerfile tramite l'immagine ghcr.io/sigstore/cosign/cosign:

FROM ghcr.io/sigstore/cosign/cosign:v2.4.1 as cosign-bin

# Source: https://github.com/chainguard-images/images/tree/main/images/static
FROM cgr.dev/chainguard/static:latest
COPY --from=cosign-bin /ko-app/cosign /usr/local/bin/cosign
ENTRYPOINT [ "cosign" ]

Avvio rapido

Questo mostra come:

Firmare un container e memorizzare la firma nel registry

Nota che dovresti sempre firmare le immagini in base al loro digest (@sha256:...) anziché a un tag (:latest), perché altrimenti potresti firmare qualcosa che non intendevi firmare!

 cosign sign $IMAGE

Generating ephemeral keys...
Retrieving signed certificate...

	Note that there may be personally identifiable information associated with this signed artifact.
	This may include the email address associated with the account with which you authenticate.
	This information will be used for signing this artifact and will be stored in public transparency logs and cannot be removed later.

By typing 'y', you attest that you grant (or have permission to grant) and agree to have this information stored permanently in transparency logs.
Are you sure you would like to continue? [y/N] y
Your browser will now be opened to:
https://oauth2.sigstore.dev/auth/auth?access_type=online&client_id=sigstore&code_challenge=OrXitVKUZm2lEWHVt1oQWR4HZvn0rSlKhLcltglYxCY&code_challenge_method=S256&nonce=2KvOWeTFxYfxyzHtssvlIXmY6Jk&redirect_uri=http%3A%2F%2Flocalhost%3A57102%2Fauth%2Fcallback&response_type=code&scope=openid+email&state=2KvOWfbQJ1caqScgjwibzK2qJmb
Successfully verified SCT...
tlog entry created with index: 12086900
Pushing signature to: $IMAGE

Cosign ti chiederà di autenticarti tramite OIDC, dove accederai con il tuo indirizzo email. Dietro le quinte, cosign richiederà un certificato di firma del codice all'autorità di certificazione Fulcio. Il soggetto del certificato corrisponderà all'indirizzo email con cui hai effettuato l'accesso. Cosign memorizzerà quindi la firma e il certificato nel registro di trasparenza Rekor, e caricherà la firma nel registro OCI insieme all'immagine che stai firmando.

Verificare un container

Per verificare l'immagine, dovrai passare il soggetto del certificato e l'emittente del certificato previsti tramite i flag --certificate-identity e --certificate-oidc-issuer:

cosign verify $IMAGE --certificate-identity=$IDENTITY --certificate-oidc-issuer=$OIDC_ISSUER

Puoi anche passare un regex per i flag relativi all'identità e all'emittente del certificato, --certificate-identity-regexp e --certificate-oidc-issuer-regexp.

Verificare un container rispetto a una chiave pubblica

Questo comando restituisce 0 se viene trovata almeno una firma in formato cosign per l'immagine corrispondente alla chiave pubblica. Consulta l'utilizzo dettagliato riportato di seguito per informazioni e avvertenze sugli altri formati di firma.

Qualsiasi payload valido viene stampato su stdout, in formato json. Nota che questi payload firmati includono il digest dell'immagine del container, ed è così che possiamo essere certi che queste firme "separate" coprano l'immagine corretta.

$ cosign verify --key cosign.pub $IMAGE_URI:1h
The following checks were performed on these signatures:
  - The cosign claims were validated
  - The signatures were verified against the specified public key
{"Critical":{"Identity":{"docker-reference":""},"Image":{"Docker-manifest-digest":"sha256:87ef60f558bad79beea6425a3b28989f01dd417164150ab3baab98dcbf04def8"},"Type":"cosign container image signature"},"Optional":null}

Verifica di un container in un ambiente air-gapped

Categorie