Registry

unauthorized: authentication required / failed to parse Www-Authenticate challenge header. – Docker REGISTRY_CHALLENGE_FAILED

REGISTRY_CHALLENGE_FAILED

Il client non riesce a scambiare il token con l'endpoint di autorizzazione OAuth2/Bearer perché il proxy del registry omette o altera l'header `Www-Authenticate`.

Categoria: DockerGruppo: RegistryConfidenza: altaUltimo aggiornamento: 19-08-2026Letto 1 volta

Cosa significa questo errore?

Il client non riesce a scambiare il token con l'endpoint di autorizzazione OAuth2/Bearer perché il proxy del registry omette o altera l'header `Www-Authenticate`.

Messaggio originale

unauthorized: authentication required / failed to parse Www-Authenticate challenge header.

Contesto e parole chiave

Alias

  • failed to parse Www-Authenticate
  • registry challenge failed

Messaggi alternativi

  • autenticazione richiesta parsing header Www-Authenticate fallito

Prodotti

  • Docker Engine / Docker Compose / BuildKit / containerd

Piattaforme

  • Docker Desktop su macOS
  • Docker Desktop su Windows
  • Linux

Parole chiave

  • compose
  • container
  • docker
  • docker.registry.unauthorized-challenge-failed
  • errore-docker-registry-unauthorized-challenge-failed
  • Registry
  • REGISTRY_CHALLENGE_FAILED

Cause possibili

Origine del problema per Docker Registry: fallimento negoziazione autenticazione (Www-Authenticate)

Il client non riesce a scambiare il token con l'endpoint di autorizzazione OAuth2/Bearer perché il proxy del registry omette o altera l'header `Www-Authenticate`.

molto comune

Diagnosi

Diagnostica container e log per Docker Registry: fallimento negoziazione autenticazione (Www-Authenticate)

Eseguire comandi di ispezione dei container e controllare i log del demone Docker con journalctl o docker logs.

Come leggere il risultato. Mostra le eccezioni a runtime dell'applicazione, segnali di terminazione o errori di rete interna.

docker
docker logs --tail 50 <container_id>

Risoluzione

Procedura di risoluzione per Docker Registry: fallimento negoziazione autenticazione (Www-Authenticate)

Difficoltà: mediaRischio: basso

Applicare la configurazione raccomandata nelle specifiche ufficiali Docker e BuildKit.

  1. Ispezionare i parametri di avvio nel file Dockerfile o docker-compose.yml
  2. Verificare i vincoli di memoria, permessi e compatibilità delle porte
  3. Riavviare il container o eseguire una compilazione pulita senza cache

Domande frequenti

Come risolvere il problema REGISTRY_CHALLENGE_FAILED in Docker?

Il client non riesce a scambiare il token con l'endpoint di autorizzazione OAuth2/Bearer perché il proxy del registry omette o altera l'header `Www-Authenticate`.

Approfondimenti

Schede correlate