Risoluzione dei problemi DNS di White Label

La maggior parte dei problemi DNS di White Label Lite dipende da una di quattro cause: il record manca, il suo valore è diverso da quello nella tabella Branding, è attivo un proxy oppure il passaggio relativo al certificato richiede attenzione.

Inizia dalla tabella DNS for your brand nella scheda Branding del dominio. È il riferimento definitivo per il nome host e la destinazione. Non copiare una destinazione CNAME da un vecchio articolo, da un altro account o da uno strumento di verifica DNS.

Procedura rapida

1. Apri Branding e copia host, tipo e valore dell’indirizzo interessato.
2. Crea o correggi il record presso il provider DNS che ospita la zona DNS attiva.
3. Mantieni il record in modalità solo DNS se il provider offre un’opzione proxy.
4. Torna in Branding e seleziona Verify DNS. Condividi l’indirizzo solo quando il suo stato è Active.

Come controllare il DNS senza terminale

Prima di cercare qualsiasi altra causa, confronta il record presso il provider DNS con la riga in Branding:

• Host o Name
• Type, che è CNAME per un host personalizzato della dashboard o della webmail
• Value o Target
• L’impostazione proxy, che deve essere disattivata per un host personalizzato che utilizza Cloudflare

Dopo aver salvato il record, usa l’azione Verify DNS in Branding. Questa mette in coda un nuovo controllo e la pagina mostra lo stato risultante.

Per un controllo indipendente, usa un servizio pubblico di ricerca DNS o chiedi al provider DNS di cercare il nome host completo come CNAME. La risposta deve corrispondere esattamente al campo Value corrente in Branding. Uno strumento pubblico può confermare ciò che rileva, ma non può sostituire lo stato Active della piattaforma.

Non occorre un terminale per terminare la configurazione. Se ne usi uno, interroga il nome host completo e confronta il CNAME restituito con il valore mostrato in Branding.

Lo stato indica "Pending DNS"

Pending DNS significa che la piattaforma non ha ancora trovato il record previsto per quell’host. Seleziona Verify DNS dopo aver corretto un record, quindi torna alla scheda Branding dopo l’aggiornamento dello stato. Esegui questi controlli nell’ordine:

Hai modificato il provider DNS sbagliato. Verifica quale provider è autoritativo per il DNS del dominio. È possibile modificare il pannello del registrar mentre la zona DNS attiva è ospitata altrove.

La destinazione CNAME non è quella corrente. Copia Value o Target dalla tabella Branding. Rimuovi un vecchio record in conflitto per lo stesso nome host solo dopo aver verificato che non sia usato da un altro servizio.

Il tipo di record è errato. Un host della dashboard o della webmail richiede il record CNAME mostrato in Branding. Un record A o AAAA con lo stesso nome host può impedire il risultato previsto.

Il nome host è stato inserito nella forma sbagliata. Alcuni provider richiedono solo il prefisso, come dashboard, mentre altri vogliono il nome host completo. Segui il suggerimento del campo del provider e confronta il record risultante con l’host mostrato in Branding.

Se il record corrisponde, lascialo invariato e usa nuovamente Verify DNS. Modificare ripetutamente un record corretto può prolungare il tempo necessario affinché tutti i resolver DNS vedano la stessa risposta.

La nuvola arancione di Cloudflare impedisce il provisioning SSL

Se usi Cloudflare come provider DNS, vedrai un’icona a forma di nuvola accanto a ogni record. Una nuvola arancione indica che Cloudflare inoltra la richiesta tramite proxy. Il CNAME di una dashboard o webmail personalizzata deve essere in modalità solo DNS affinché la piattaforma possa verificarlo ed emettere il certificato.

Soluzione: seleziona la nuvola accanto al CNAME dell’host personalizzato interessato finché non diventa grigia, quindi salva il record. Torna in Branding e seleziona Verify DNS.

Questa regola si applica al record dell’host personalizzato, non automaticamente a tutti gli altri record del dominio. Se un altro provider offre un’opzione proxy o CDN, disattivala per quel CNAME salvo diverse istruzioni nella tabella Branding.

Lo stato indica "SSL could not be issued" e menziona CAA

Un record CAA comunica ai provider di certificati quali organizzazioni possono emettere un certificato per il dominio. Modificalo solo quando lo stato in Branding o l’assistenza identifica espressamente CAA come causa del blocco.

Lascia invariato il CNAME e controlla se il dominio ha già un record CAA. Il provider DNS può mostrarlo oppure uno strumento DNS indipendente può interrogare il dominio radice.

Se il record deve autorizzare l’autorità emittente usata dalla piattaforma, aggiungi l’esatto valore CAA fornito dall’assistenza o indicato nelle istruzioni correnti del prodotto. Non eliminare voci CAA non correlate solo per superare questo passaggio. Possono coesistere più record CAA.

Per il processo di certificazione corrente, il valore richiesto è normalmente:

Type: CAA
Host: @
Value: 0 issue "letsencrypt.org"

Se non hai record CAA, non aggiungerne uno solo per precauzione. Dopo una modifica al CAA, torna in Branding e seleziona Verify DNS.

Lo stato indica "SSL could not be issued" senza motivo

Il CNAME potrebbe essere già corretto. Non eliminarlo e ricrearlo ripetutamente. Procedi invece così:

1. Verifica che il record corrisponda ancora all’host e alla destinazione in Branding e che non usi un proxy.
2. Seleziona Verify DNS una volta.
3. Se lo stato resta invariato, contatta l’assistenza indicando il nome host e lo stato mostrato e allegando una schermata del record DNS.

Il lavoro sul certificato non si risolve modificando un CNAME che è già corretto. Il team di assistenza può esaminare il risultato sul lato della piattaforma senza chiederti di rivelare le credenziali del provider DNS.

Il dominio era attivo, ma lo stato è cambiato

Quando un host è Active, è pronto a funzionare. Se il suo stato cambia in seguito:

• Torna a "Pending DNS": confronta il CNAME corrente con la tabella Branding. Il record potrebbe essere stato modificato, rimosso o posto dietro un proxy.
• "SSL could not be issued": lascia invariato un CNAME corrispondente, seleziona Verify DNS e contatta l’assistenza se lo stato persiste.
• Off: controlla se Branding è stato disattivato per quel dominio o se l’abbonamento White Label non è attivo. Se nessuna delle due condizioni lo spiega, contatta l’assistenza.

Scenari comuni

"Ho modificato il CNAME, ma lo stato è ancora in sospeso." Verifica di aver modificato il provider DNS autoritativo e che il nuovo CNAME corrisponda esattamente a Branding. Quindi usa Verify DNS. Evita di cambiare ripetutamente i valori mentre il controllo è in corso.

"Ho eliminato il vecchio CNAME presso il provider precedente, ma quello nuovo non viene trovato." Se hai cambiato provider DNS, assicurati che il registrar deleghi il dominio ai server dei nomi del nuovo provider. Altrimenti, chiedi al provider che ospita la zona DNS autoritativa di confermare il record.

"Il mio sito principale usa un proxy. Può usarlo anche l’host personalizzato?" Mantieni il CNAME personalizzato in modalità solo DNS. Il resto del dominio può utilizzare le proprie impostazioni proxy, purché lo specifico host in Branding non passi attraverso un proxy.

"Posso usare un CNAME con carattere jolly?" Configura lo specifico nome host mostrato in Branding. In questo modo la piattaforma dispone di un indirizzo univoco da verificare e provare. Non sostituire l’host elencato nella tabella con un record con carattere jolly.

"Voglio usare un sottodominio diverso." Modifica l’etichetta nella scheda Branding del dominio, salvando un host alla volta. Copia il nuovo CNAME dalla tabella, prova il nuovo host solo dopo che diventa Active e mantieni disponibile il vecchio indirizzo dei clienti fino al completamento del passaggio.

"Una rete non riesce a vedere il nuovo record." Prova da un’altra rete o chiedi al cliente interessato di riprovare in seguito. Se la tabella Branding indica Active e l’host funziona altrove, il ritardo residuo dipende probabilmente dalla cache DNS di quella rete.

Passaggi successivi

• Configurare White Label Lite: i passaggi di configurazione iniziali se non hai ancora terminato.
• Domande frequenti sui prezzi di White Label Lite: domande relative alla fatturazione.
• Annullare White Label Lite: cosa accade al dominio in caso di annullamento.
• Record DNS consigliati: una panoramica più ampia dei record DNS usati da TrekMail.

Se il problema persiste, apri un ticket di assistenza indicando il nome host, lo stato esatto in Branding e il provider DNS e allegando una schermata del record. Non inviare password o token API del provider DNS.