Risoluzione dei problemi relativi ai certificati SSL

Le procedure di risoluzione dei problemi variano a seconda che utilizzi certificati SSL gestiti da Google o autogestiti.

Risoluzione dei problemi dei certificati gestiti da Google

Per i certificati gestiti da Google, esistono due tipi di stato:

  • Stato gestito
  • Stato dominio

Stato gestito

Per verificare lo stato del certificato, esegui questo comando:

gcloud compute ssl-certificates describe CERTIFICATE_NAME \
    --global \
    --format="get(name,managed.status)"

I valori per lo stato gestito sono i seguenti:

Stato gestito Spiegazione
PROVISIONING

Il certificato gestito da Google è stato creato e Google Cloud sta collaborando con l'autorità di certificazione per firmarlo.

Il provisioning di un certificato gestito da Google potrebbe richiedere fino a 60 minuti dal momento in cui le modifiche alla configurazione del DNS e del bilanciatore del carico vengono propagate su internet. Se hai aggiornato la configurazione DNS di recente, la propagazione completa delle modifiche può richiedere molto tempo. A volte la propagazione in tutto il mondo può richiedere fino a 72 ore, anche se in genere sono necessarie alcune ore. Per maggiori informazioni sulla propagazione DNS, consulta Propagazione delle modifiche.

Se il certificato rimane nello stato PROVISIONING, assicurati che sia associato al proxy di destinazione quello corretto. Puoi verificarlo eseguendo il comando gcloud compute target-https-proxies describe o gcloud compute target-ssl-proxies describe.

ACTIVE Il certificato SSL gestito da Google è ottenuto dall'autorità di certificazione. Potrebbero essere necessari altri 30 minuti prima che siano disponibili per l'utilizzo da parte di un bilanciatore del carico.
PROVISIONING_FAILED Potresti visualizzare brevemente PROVISIONING_FAILED anche quando il tuo certificato è effettivamente ACTIVE. Ricontrolla lo stato.

Se lo stato rimane PROVISIONING_FAILED, il certificato gestito da Google è stato creato, ma l'autorità di certificazione non può firmarlo. Assicurati di aver completato tutti i passaggi descritti in Utilizzare i certificati SSL gestiti da Google.

Google Cloud ritenta il provisioning finché non viene eseguito correttamente o lo stato non diventa PROVISIONING_FAILED_PERMANENTLY.
PROVISIONING_FAILED_PERMANENTLY Il certificato gestito da Google è stato creato, ma l'autorità di certificazione non può firmarlo a causa di un problema di configurazione del DNS o del bilanciatore del carico. In questo stato, Google Cloud non riprova a eseguire il provisioning.

Crea un certificato SSL sostitutivo gestito da Google e assicurati che sia associato al proxy di destinazione del bilanciatore del carico. Verifica o completa tutti i passaggi descritti in Utilizzare i certificati SSL gestiti da Google. In seguito, potrai eliminare il certificato il cui provisioning non è riuscito definitivamente.
RENEWAL_FAILED

Il rinnovo del certificato gestito da Google non è riuscito a causa di un problema con il bilanciatore del carico o con la configurazione DNS. Se uno dei domini o dei sottodomini in un certificato gestito non punta all'indirizzo IP del bilanciatore del carico utilizzando un record A/AAAA, il processo di rinnovo non va a buon fine. Il certificato esistente continua a essere gestito, ma scade a breve. Controlla la configurazione.

Se lo stato rimane RENEWAL_FAILED, esegui il provisioning di un nuovo certificato, passa al nuovo certificato ed elimina il certificato precedente.

Per maggiori informazioni sul rinnovo del certificato, consulta la pagina sul rinnovo del certificato SSL gestito da Google.

Stato dominio

Per verificare lo stato del dominio, esegui questo comando:

gcloud compute ssl-certificates describe CERTIFICATE_NAME \
    --global \
    --format="get(managed.domainStatus)"

In questa tabella sono descritti i valori relativi allo stato del dominio.

Stato dominio Spiegazione
PROVISIONING Il certificato gestito da Google viene creato per il dominio. Google Cloud sta collaborando con l'autorità di certificazione per firmare il certificato.
ACTIVE Il dominio è stato convalidato per il provisioning del certificato. Se il certificato SSL riguarda più domini, è possibile eseguire il provisioning del certificato solo dopo che tutti i domini hanno uno stato ACTIVE e anche lo stato gestito del certificato è ACTIVE.
FAILED_NOT_VISIBLE

Il provisioning dei certificati non è stato completato per il dominio. Il problema potrebbe essere uno dei seguenti:

  • Il record DNS del dominio non si risolve nell'indirizzo IP del bilanciatore del carico Google Cloud. Per risolvere il problema, aggiorna i record DNS A e AAAA in modo che puntino all'indirizzo IP del bilanciatore del carico.

    Il DNS non deve risolversi in indirizzi IP diversi da quello del bilanciatore del carico. Ad esempio, se un record A si risolve nel bilanciatore del carico corretto, ma il valore AAAA si risolve in altro, lo stato del dominio è FAILED_NOT_VISIBLE.

  • La propagazione completa dei record DNS A e AAAA appena aggiornati può richiedere una notevole quantità di tempo. A volte la propagazione su internet richiede fino a 72 ore in tutto il mondo, anche se in genere sono necessarie alcune ore. Lo stato del dominio continua a essere FAILED_NOT_VISIBLE fino al completamento della propagazione.
  • Il certificato SSL non è collegato al proxy di destinazione del bilanciatore del carico. Per risolvere questo problema, aggiorna la configurazione del bilanciatore del carico.
  • Le porte del frontend per la regola di forwarding globale non includono la porta 443 per un bilanciatore del carico di rete proxy esterno con un proxy SSL. Il problema può essere risolto aggiungendo una nuova regola di forwarding con la porta 443.
  • Una mappa di certificati del gestore certificati è collegata al proxy di destinazione. La mappa di certificati allegata ha la precedenza e i certificati collegati direttamente vengono ignorati. Il problema si può risolvere scollegando la mappa di certificati dal proxy.
  • Se lo stato di gestione è PROVISIONING, Google Cloud continua a riprovare il provisioning, anche se lo stato del dominio è FAILED_NOT_VISIBLE.
FAILED_CAA_CHECKING Il provisioning del certificato non è riuscito a causa di un problema di configurazione con il record CAA del tuo dominio. Assicurati di aver seguito la procedura corretta.
FAILED_CAA_FORBIDDEN Il provisioning del certificato non è riuscito perché il record CAA del tuo dominio non specifica una CA che Google Cloud deve utilizzare. Assicurati di aver seguito la procedura corretta.
FAILED_RATE_LIMITED Il provisioning del certificato non è riuscito perché un'autorità di certificazione ha richieste di firma dei certificati con limitazioni di frequenza. Puoi eseguire il provisioning di un nuovo certificato, utilizzare il nuovo certificato ed eliminare il certificato precedente oppure contattare l'assistenza Google Cloud.

Rinnovo dei certificati gestiti

Se uno dei domini o dei sottodomini in un certificato gestito non punta all'indirizzo IP del bilanciatore del carico o a un IP insieme all'IP del bilanciatore del carico, il processo di rinnovo non va a buon fine. Per evitare il mancato rinnovo, assicurati che tutti i domini e i sottodomini puntino all'indirizzo IP del bilanciatore del carico.

Risolvere i problemi relativi ai certificati SSL autogestiti

Questa guida descrive come risolvere i problemi di configurazione per i certificati SSL autogestiti.

Impossibile analizzare il certificato

Google Cloud richiede certificati in formato PEM. Se il certificato è in formato PEM, verifica quanto segue:

Puoi convalidare il tuo certificato utilizzando il seguente comando OpenSSL, sostituendo CERTIFICATE_FILE con il percorso del file del certificato:

openssl x509 -in CERTIFICATE_FILE -text -noout

Se OpenSSL non è in grado di analizzare il certificato:

Nome comune mancante o nome alternativo del soggetto

Google Cloud richiede che il certificato abbia un attributo nome comune (CN) o nome alternativo del soggetto (SAN). Per ulteriori informazioni, consulta Creare un CSR.

Se entrambi gli attributi non sono presenti, Google Cloud mostra un messaggio di errore come il seguente quando provi a creare un certificato autogestito:

ERROR: (gcloud.compute.ssl-certificates.create) Could not fetch resource:
 -   The SSL certificate is missing a Common Name(CN) or Subject Alternative
   Name(SAN).

Impossibile analizzare la chiave privata

Google Cloud richiede chiavi private in formato PEM che soddisfino i criteri per le chiavi private.

Puoi convalidare la tua chiave privata utilizzando il seguente comando OpenSSL, sostituendo PRIVATE_KEY_FILE con il percorso della chiave privata:

    openssl rsa -in PRIVATE_KEY_FILE -check

Le seguenti risposte indicano un problema con la tua chiave privata:

  • unable to load Private Key
  • Expecting: ANY PRIVATE KEY
  • RSA key error: n does not equal p q
  • RSA key error: d e not congruent to 1
  • RSA key error: dmp1 not congruent to d
  • RSA key error: dmq1 not congruent to d
  • RSA key error: iqmp not inverse of q

Per risolvere il problema, devi creare una nuova chiave privata e un nuovo certificato.

Chiavi private con passphrase

Se OpenSSL richiede una passphrase, dovrai rimuovere la passphrase dalla tua chiave privata per poterla utilizzare con Google Cloud. Puoi utilizzare il seguente comando OpenSSL:

openssl rsa -in PRIVATE_KEY_FILE \
    -out REPLACEMENT_PRIVATE_KEY_FILE

Sostituisci i segnaposto con valori validi:

  • PRIVATE_KEY_FILE: il percorso della tua chiave privata protetta con una passphrase
  • REPLACEMENT_PRIVATE_KEY_FILE: il percorso in cui vuoi salvare una copia della chiave privata in testo normale

Certificati intermedi in scadenza

Se un certificato intermedio scade prima del certificato del server (foglia), ciò potrebbe indicare che la tua CA non sta seguendo le best practice.

Quando un certificato intermedio scade, il certificato foglia utilizzato in Google Cloud potrebbe non essere più valido. Dipende dal client SSL, come segue:

  • Alcuni client SSL considerano solo l'ora di scadenza del certificato leaf e ignorano i certificati intermedi scaduti.
  • Alcuni client SSL considerano non valide una catena con certificati intermedi scaduti e visualizzano un avviso.

Per risolvere il problema:

  1. Attendi che la CA passi a un nuovo certificato intermedio.
  2. Richiedi un nuovo certificato al team.
  3. Ricarica il nuovo certificato con le nuove chiavi.

La tua CA potrebbe anche consentire la firma incrociata per i certificati intermedi. Rivolgiti alla tua CA per avere conferma.

L'esponente pubblico RSA è troppo grande

Il seguente messaggio di errore viene visualizzato quando l'esponente pubblico RSA è maggiore di 65537. Assicurati di utilizzare 65537, come specificato in RFC 4871.

ERROR: (gcloud.compute.ssl-certificates.create) Could not fetch resource:
 -   The RSA public exponent is too large.

Rimuovi certificato SSL da proxy-target

I passaggi seguenti mostrano come rimuovere un singolo certificato SSL collegato al proxy https di destinazione:

  1. Esporta il proxy target-https-proxy in un file temporaneo.

    gcloud compute target-https-proxies export TARGET_PROXY_NAME > /tmp/proxy
    
  2. Modifica il file /tmp/proxy e rimuovi le seguenti righe:

    sslCertificates:
    -   https://www.googleapis.com/compute/v1/projects/...
    
  3. Importa il file /tmp/proxy.

    gcloud compute target-https-proxies import TARGET_PROXY_NAME \
       --source=/tmp/proxy
    
  4. (Facoltativo) Elimina il certificato SSL.

    gcloud compute ssl-certificates delete SSL_CERT_NAME
    

Sostituisci quanto segue:

  • TARGET_PROXY_NAME: il nome della risorsa proxy https di destinazione.
  • SSL_CERT_NAME: il nome del certificato SSL.