Configurazione automatica del DNS con Cloudflare

TrekMail può creare i record DNS di posta per i domini gestiti da Cloudflare. Entrambi i metodi mostrano una conferma prima di scrivere le modifiche; la verifica DNS avviene dopo. Scegli il metodo adatto al dominio.

Metodo 1: configurazione automatica di un dominio idoneo

Quando compare nella scheda DNS e stato, questo è il percorso più rapido per un singolo dominio gestito da Cloudflare. Non richiede un token API. Il pulsante non è disponibile per tutte le configurazioni, per esempio un dominio usato solo per l'invio o uno che richiede un selettore DKIM diverso.

1. Apri la scheda DNS e stato del dominio.
2. Fai clic su Configura DNS automaticamente.
3. Verrai indirizzato a Cloudflare, dove potrai controllare i record.
4. Approva la modifica su Cloudflare.
5. Torna a TrekMail. Al termine del percorso presso il provider viene avviata una verifica DNS. Attendi lo stato mostrato da TrekMail prima di considerare conclusa la configurazione.

Questo metodo usa il protocollo Domain Connect. Il dominio deve utilizzare i server DNS di Cloudflare.

Metodo 2: token API per uno o più domini

Usa questo metodo per configurare più domini contemporaneamente o se Domain Connect non è disponibile.

Come funziona

1. Crei un token API su Cloudflare.
2. TrekMail trova le zone Cloudflare accessibili con il token e mostra quelle che puoi aggiungere o collegare.
3. Controlli e applichi le modifiche. TrekMail aggiunge i domini e crea automaticamente i record DNS.

Procedura dettagliata

Passaggio 1: collegare Cloudflare

1. In TrekMail, apri Domini e seleziona la scheda Cloudflare nel riquadro “Aggiungi un dominio”. Puoi anche andare direttamente a /app/domains?add=cloudflare.
2. Fai clic su Apri Cloudflare per aprire la pagina di creazione del token.
3. Su Cloudflare:
   • Fai clic su Create Token.
   • Parti dal modello Edit zone DNS oppure crea un token personalizzato con Zone → DNS → Edit.
   • In Zone Resources, scegli solo la zona o le zone che TrekMail dovrà gestire. Usa All zones esclusivamente quando vuoi collegare intenzionalmente un gruppo ampio.
   • Non aggiungere permessi estranei all'operazione.
   • Fai clic su Continue to summary → Create Token.
   • Copia il token. Cloudflare lo mostra una sola volta.
4. Incolla il token in TrekMail. Un segno di spunta verde conferma che è valido.

Passaggio 2: selezionare i domini

TrekMail mostra le zone Cloudflare accessibili con il token. Controlla la selezione prima di proseguire e deseleziona ogni dominio che non vuoi collegare.

• Configura DNS: Il dominio esiste già in TrekMail e i suoi record DNS verranno configurati.
• Aggiungi e configura DNS: Il dominio è nuovo; verrà aggiunto a TrekMail e il DNS sarà configurato automaticamente.

I domini non gestiti da Cloudflare non compaiono nell'elenco.

Passaggio 3: applicare i record DNS

TrekMail mostra un'anteprima delle modifiche per ogni dominio selezionato:

• Verrà aggiunto: Sarà creato un nuovo record DNS.
• Verrà unito: Il record SPF esistente sarà aggiornato per includere TrekMail.
• Già configurato: Non serve alcuna modifica.
• Verrà sostituito: Un record esistente è in conflitto con i requisiti di TrekMail. Usa il selettore Sostituisci / Mantieni del record: Sostituisci sovrascrive il vecchio valore con quello di TrekMail, mentre Mantieni lascia intatto il record.

Prima di applicare le modifiche puoi anche scegliere esattamente quali record scrivere. Ogni record ha una casella di selezione. Puoi applicare ora soltanto MX e SPF e tornare in seguito per DKIM, oppure saltare un record già gestito altrove. Gli elementi deselezionati non vengono modificati.

Fai clic su Applica DNS a tutti i domini per creare i record selezionati. Dopo un'applicazione riuscita, TrekMail pianifica una verifica DNS. Questa verifica conferma ciò che è visibile pubblicamente ed è lo stato finale a cui fare riferimento.

Configurazione in blocco

Se gestisci molti domini su Cloudflare, la procedura guidata può elaborarli insieme:

1. Durante la creazione del token API, seleziona All zones in Zone Resources.
2. Nel passaggio 2, scegli i domini da includere e controlla la selezione.
3. TrekMail aggiungerà i domini nuovi e applicherà i record DNS a ciascuno in sequenza.

Limiti del piano

Si applica il limite di domini del tuo piano:

• Nano: Fino a 10 domini totali.
• Starter: Fino a 50 domini totali.
• Pro: Fino a 100 domini totali.
• Agency: Fino a 1.000 domini totali.

Puoi collegare fino a 50 domini per gruppo. I domini nuovi vengono conteggiati nel limite del piano.

Sicurezza

• Il token API viene archiviato in forma crittografata e TrekMail non ne registra il valore nei log.
• L'anteprima stabilisce quali elementi TrekMail può creare o aggiornare. Leggila con attenzione, soprattutto in presenza di un'unione SPF o di un record in conflitto.
• Scollegare Cloudflare impedisce a TrekMail di apportare future modifiche DNS, ma non annulla i record già scritti.

Risoluzione dei problemi

“Questo token API non è valido o è scaduto”

Crea un nuovo token su Cloudflare. Copialo quando Cloudflare lo mostra e incollalo in TrekMail. Proteggilo come una password.

“Il dominio non è stato trovato nel tuo account Cloudflare”

Controlla che il dominio sia stato aggiunto a Cloudflare e abbia lo stato Active.

“Non dispone del permesso di modificare i record DNS”

Il token deve poter modificare il DNS. Creane uno nuovo con Permissions → Add more → Zone → DNS → Edit.

Il DNS risulta ancora in attesa dopo la configurazione

Attendi l'esecuzione della verifica DNS e, se necessario, usa Verifica DNS nella pagina DNS del dominio. La durata della cache dipende dal TTL del record e dal resolver, quindi non considerare garantito un numero fisso di minuti o ore. Prima di applicare di nuovo le modifiche, controlla il record preciso che TrekMail segnala come assente o in conflitto.

Per conoscere i passaggi e i permessi attuali di Cloudflare, consulta gestione dei record DNS e permessi dei token API.