Come verificare il tuo dominio

Istruzioni passo passo per aggiungere un dominio e completare la verifica.

Panoramica

Prima che QuietLS possa gestire i certificati SSL del tuo dominio, devi dimostrarne la proprietà. La verifica del dominio è un processo da eseguire una sola volta: crei un record DNS speciale (un CNAME) che punta a QuietLS, e QuietLS verifica che il record esista. Una volta verificato, lo stato del dominio passa ad Attivo e sei pronto per iniziare.

Per una spiegazione più approfondita del meccanismo sottostante, consulta Che cos'è la delega CNAME?.

Prerequisiti

Un nome di dominio che controlli (es. example.com).
Accesso alle impostazioni DNS del tuo dominio — in genere tramite il tuo registrar o il provider DNS (Cloudflare, Route 53, Namecheap, GoDaddy, ecc.).

Passo 1: Aggiungi il tuo dominio

Accedi al cruscotto di QuietLS.
Vai a Domini e fai clic su Aggiungi dominio.
Inserisci il nome del tuo dominio (es. example.com o *.example.com per un dominio jolly).
Fai clic su Aggiungi.

Il tuo dominio appare nell'elenco con lo stato Verifica in attesa.

Passo 2: Copia il record CNAME

Dopo aver aggiunto il dominio, QuietLS genera un record di verifica univoco per te. Apri la finestra di verifica (fai clic su Verifica accanto al tuo dominio) e vedrai due valori:

Tipo	Nome	Valore
CNAME	`_pki-validation.example.com`	`<token>.verification.quietls.com`

Nome — sempre _pki-validation. seguito dal tuo dominio.
Valore — un token univoco generato specificamente per il tuo account e questo dominio.

Usa i pulsanti di copia nel cruscotto per evitare errori di battitura.

Passo 3: Crea il CNAME nel tuo provider DNS

Accedi al tuo provider DNS e crea un nuovo record CNAME con il nome e il valore dal Passo 2.

Istruzioni generali

Vai alla pagina di gestione DNS.
Aggiungi un nuovo record di tipo CNAME.
Nel campo Nome (o Host), inserisci _pki-validation (alcuni provider aggiungono il tuo dominio automaticamente; altri richiedono il nome completo _pki-validation.example.com).
Nel campo Valore (o Punta a / Destinazione), incolla il valore del token, es. a1b2c3d4e5f6...verification.quietls.com.
Salva il record.

Utenti di Cloudflare

Se utilizzi Cloudflare, assicurati che l'interruttore Proxy sia impostato su Solo DNS (l'icona della nuvola grigia). I record con proxy attivo (nuvola arancione) non verranno risolti correttamente e la verifica fallirà.

Passo 4: Verifica

Hai due opzioni:

Verifica immediata: Fai clic sul pulsante Verifica ora nel cruscotto. QuietLS esegue una ricerca DNS immediata e ti comunica il risultato.

Attendere la verifica automatica: QuietLS verifica automaticamente il tuo record CNAME in background — una volta all'ora, per un massimo di 5 ore dopo l'aggiunta del dominio. Se il record viene trovato durante una di queste verifiche, il tuo dominio viene verificato automaticamente.

Cosa succede dopo la verifica

Una volta che il record CNAME viene rilevato e corrisponde al valore atteso:

Lo stato del tuo dominio passa da Verifica in attesa ad Attivo.
Viene registrata una marca temporale Verificato il.
Il dominio è ora pronto per la gestione dei certificati SSL.

Se hai aggiunto un dominio jolly (es. *.example.com), tutti i sottodomini aggiunti in precedenza (come api.example.com, cdn.example.com) vengono automaticamente raggruppati sotto il dominio jolly come figli.

Risoluzione dei problemi

«Record CNAME non trovato»

Possibile causa	Cosa fare
Ritardo di propagazione DNS	Le modifiche DNS possono richiedere fino a 24-48 ore per propagarsi a livello globale, sebbene la maggior parte dei provider si aggiorni nel giro di pochi minuti. Attendi e riprova, oppure lascia che la verifica automatica rilevi il record.
Nome del record errato	Verifica che il nome sia esattamente `_pki-validation.example.com`. Alcuni provider richiedono solo `_pki-validation` (aggiungono il dominio automaticamente).
Valore del record errato	Copia il valore direttamente dal cruscotto utilizzando il pulsante di copia. Il token non distingue tra maiuscole e minuscole, ma il valore completo deve corrispondere esattamente.
Proxy Cloudflare attivo	Se utilizzi Cloudflare, imposta il CNAME su Solo DNS (nuvola grigia). I record con proxy non sono visibili come query CNAME.
Tipo di record errato	Assicurati di aver creato un record CNAME, non un record TXT, A o AAAA.

La verifica è riuscita ma lo stato non è cambiato

Questo significa in genere che il cruscotto non si è aggiornato. Ricarica la pagina oppure esci dalla lista Domini e tornaci.

Il dominio jolly non adotta i sottodomini

I sottodomini vengono adottati automaticamente solo al momento della prima creazione del dominio jolly. Se aggiungi sottodomini dopo il dominio jolly, non vengono collegati automaticamente. Aggiungendoli nuovamente verranno associati al dominio jolly padre.