Come configurare un dominio personalizzato in SMARTFENSE – SMARTFENSE

Questo articolo spiega come configurare un dominio personalizzato affinché gli utenti accedano alla piattaforma tramite un indirizzo proprio dell'organizzazione, invece del dominio standard assegnato da SMARTFENSE. Include l'ordine corretto dei record DNS e cosa verificare prima di attivarlo.

Questa funzionalità è disponibile a partire dal piano Standard.

Definizioni

Dominio standard: l'indirizzo che SMARTFENSE Le assegna per impostazione predefinita (ad esempio, istanza.takesecurity.com). È sempre disponibile, anche se si configura un dominio proprio.
Dominio personalizzato: un dominio di proprietà della Sua organizzazione che viene aggiunto per accedere alla piattaforma con il proprio indirizzo.
Dominio principale: il dominio che la piattaforma utilizza in ogni momento per l'accesso e per i link che invia (e-mail, campagne). Può essercene solo uno alla volta ed è possibile modificarlo in qualsiasi momento.
DNS target: il valore generato dalla piattaforma al momento della registrazione di un dominio personalizzato. Il Suo dominio deve puntare a quel valore tramite un record CNAME (o ALIAS/ANAME, nel caso di un dominio radice).

Prima di iniziare

Tenga presenti questi punti prima di avviare la configurazione:

Ogni istanza supporta un solo dominio personalizzato. Per registrarne uno diverso, deve prima eliminare quello esistente.
Il dominio che desidera utilizzare deve essere validato come dominio aziendale, con il suo nome esatto. Se desidera utilizzare un sottodominio (ad esempio, sicurezza.miaazienda.com), deve validare quel sottodominio. Avere validato il dominio radice (miaazienda.com) non abilita i suoi sottodomini.
Sono necessari due record DNS diversi: un record TXT per validare il dominio aziendale e un record che faccia puntare il dominio alla piattaforma (CNAME per un sottodominio, ALIAS o ANAME per un dominio radice).
Stabilisca se utilizzerà un dominio radice o un sottodominio, poiché la procedura cambia:
- Sottodominio: un nome DNS che ha un record CNAME non può avere nessun altro record contemporaneamente. Per questo motivo, il record TXT di validazione del sottodominio deve essere eliminato prima di creare il CNAME.
- Dominio radice: i record CNAME non possono essere creati su un dominio radice, quindi il Suo provider DNS deve supportare record di tipo ALIAS o ANAME. Questi record coesistono con gli altri record del dominio, pertanto il record TXT di validazione viene mantenuto. Alcuni provider, come GoDaddy, non offrono ALIAS né ANAME per il dominio radice: in tal caso, l'opzione consigliata è utilizzare un sottodominio.

Se non gestisce il DNS della Sua organizzazione, chieda la creazione dei record al Suo reparto IT e condivida con loro questo articolo.

Dove configurarlo

Vada su Configurazione > Organizzazione > Domini aziendali. Nella parte superiore si trova la sezione dei domini aziendali e, nella parte inferiore, la sezione Domini personalizzati.

Passo 1: Validare il dominio come dominio aziendale

Nella sezione Domini aziendali, aggiunga il dominio esatto che desidera utilizzare come dominio personalizzato.
Copi il codice di validazione mostrato dalla piattaforma. Inizia con smartfense-domain-verification= ed è specifico per ogni dominio aggiunto.
Nel Suo provider DNS, crei un record di tipo TXT con questi valori:
- Tipo: TXT.
- Nome / Host: dipende dal dominio da validare:
  - Se è un sottodominio, inserisca solo la parte del sottodominio. Ad esempio, per sicurezza.miaazienda.com, inserisca sicurezza.
  - Se è un dominio radice, a seconda del provider, inserisca @ oppure lasci il campo vuoto.
- Valore: il codice di validazione copiato al passo precedente.
- TTL: il valore predefinito.
Attenda la propagazione della modifica e validi il dominio dalla piattaforma.

Per i dettagli completi, consulti la guida: Come validare un dominio in SMARTFENSE.

In provider come GoDaddy, Namecheap o Cloudflare, il campo Host aggiunge automaticamente il dominio. Se si inserisce @ per un sottodominio, il record viene creato sul dominio radice e la validazione non riesce. Se si inserisce il nome completo, il record può risultare duplicato (ad esempio, sicurezza.miaazienda.com.miaazienda.com).

Passo 2: Registrare il dominio personalizzato

Nella sezione Domini personalizzati, prema il pulsante Nuovo dominio personalizzato.
Nel campo Dominio, selezioni il dominio aziendale validato al passo 1. L'elenco mostra solo i domini validati che non sono ancora stati registrati come personalizzati.
Prema Registra.

La piattaforma genera un DNS target per quel dominio e lo aggiunge alla tabella Domini personalizzati, con lo stato Registrato. Copi quel valore per il passo successivo.

Se non dispone di domini aziendali validati disponibili, premendo Nuovo dominio personalizzato la piattaforma mostra l'avviso: "Importante: non dispone di domini aziendali validati disponibili. Aggiunga e validi un dominio aziendale prima di registrare un dominio personalizzato."

Passo 3: Far puntare il dominio alla piattaforma

La procedura dipende dal fatto che il dominio personalizzato sia un sottodominio o un dominio radice.

Se è un sottodominio (ad esempio, sicurezza.miaazienda.com)

Nel Suo provider DNS, elimini il record TXT di validazione di SMARTFENSE creato al passo 1 per quel sottodominio (quello che inizia con smartfense-domain-verification=).
Crei un record di tipo CNAME con questi valori:
- Tipo: CNAME.
- Nome / Host: lo stesso utilizzato al passo 1 (ad esempio, sicurezza).
- Valore / Punta a: il DNS target riportato nella tabella Domini personalizzati.
- TTL: il valore predefinito.

Eliminando il record TXT, il controllo periodico dei domini contrassegnerà il sottodominio come Non validato nella sezione Domini aziendali dopo 7 giorni. È un comportamento previsto e non influisce sul dominio personalizzato già registrato, che continua a funzionare normalmente.

Se è un dominio radice (ad esempio, miaazienda.com)

Prima di continuare, verifichi che il Suo provider DNS offra record ALIAS o ANAME per il dominio radice. GoDaddy, ad esempio, non li offre; in tal caso, utilizzi un sottodominio.

Non elimini il record TXT di validazione. Il dominio radice deve rimanere validato.
Crei un record di tipo ALIAS o ANAME con questi valori:
- Tipo: ALIAS o ANAME, a seconda del nome utilizzato dal Suo provider.
- Nome / Host: @ oppure il campo vuoto, a seconda del provider.
- Valore / Punta a: il DNS target riportato nella tabella Domini personalizzati.
- TTL: il valore predefinito.

Non modifichi né elimini altri record esistenti sul dominio radice, come quelli di posta (MX) o i record TXT di altri servizi.

Se utilizza Cloudflare, configuri il record come Solo DNS (nuvola grigia), senza proxy. Con il proxy attivo, la piattaforma non può rilevare il record.

Passo 4: Verificare la propagazione e attendere l'emissione del certificato

Prima di impostare il dominio come principale, devono essere soddisfatte due condizioni: il record DNS deve essere propagato e il certificato di sicurezza (HTTPS) del dominio deve essere emesso. Questo perché, premendo Segna come principale, la piattaforma accede tramite HTTPS al nuovo dominio per verificare che raggiunga la Sua istanza.

Verificare la propagazione del record

La propagazione di una modifica DNS può richiedere da alcuni minuti a diverse ore. Per verificarla:

Acceda a uno strumento di verifica della propagazione DNS. Può trovare diverse opzioni gratuite cercando "verifica propagazione DNS" nel Suo browser.
Inserisca il dominio completo (ad esempio, sicurezza.miaazienda.com) e selezioni il tipo di record:
- CNAME se si tratta di un sottodominio. Il risultato deve mostrare il DNS target indicato dalla piattaforma.
- A se si tratta di un dominio radice con ALIAS o ANAME. Questi record non vengono mostrati come tali nelle interrogazioni pubbliche: il risultato deve mostrare gli stessi indirizzi IP restituiti dal DNS target interrogandolo con il tipo A.
Esegua l'interrogazione.
Verifichi che la maggior parte dei server restituisca il risultato atteso.

Interroghi sempre il nome completo del dominio che intende utilizzare. Se interroga il dominio radice dopo aver configurato un sottodominio, vedrà altri record e il risultato non sarà rappresentativo.

Attendere l'emissione del certificato

Il certificato di sicurezza viene richiesto automaticamente una volta che il record punta alla piattaforma. La sua emissione può richiedere fino a un'ora. Attenda questo tempo prima di proseguire con il passo 5.

Passo 5: Impostare il dominio come principale

Nella tabella Domini personalizzati, prema Segna come principale nella riga del dominio.
La piattaforma mostra la finestra di dialogo Segna dominio come principale. Prima di applicare la modifica, verifica tramite HTTPS che il dominio punti già correttamente alla Sua istanza.
Se la Sua istanza ha integrazioni che dipendono dal dominio principale, la finestra di dialogo mostra un avviso. In tal caso, prema Accetta solo dopo aver registrato il nuovo indirizzo presso il provider corrispondente.

Da quel momento, i link generati dalla piattaforma iniziano a utilizzare il nuovo dominio principale.

Integrazioni interessate dal cambio di dominio principale

Alcune integrazioni utilizzano indirizzi di reindirizzamento costruiti a partire dal dominio principale. Modificandolo, la piattaforma utilizzerà il nuovo dominio in questi indirizzi; pertanto, dovrà registrarli nella configurazione del provider corrispondente, altrimenti l'accesso o tali integrazioni potrebbero smettere di funzionare. Le integrazioni interessate sono:

Single sign-on (SSO) con Microsoft Entra ID, Google, Auth0, Okta, Keycloak o SAML.
App di Microsoft Teams.
Importazione di utenti da Google.
Server di posta personalizzato di Google.
Vanta.

Altre integrazioni, come il pulsante di segnalazione di phishing o l'importazione di utenti da Microsoft Entra ID, non sono interessate dal cambio di dominio principale.

Aggiornamento dell'URI di reindirizzamento in Microsoft Entra ID

Se la Sua istanza utilizza Microsoft Entra ID per l'autenticazione (single sign-on), il cambio di dominio principale influisce direttamente su questa integrazione. Se la utilizza solo per importare utenti, non è necessario eseguire questi passaggi. L'URI di reindirizzamento registrato in Azure viene costruito a partire dal dominio principale e smette di funzionare non appena la modifica viene applicata.

L'URI di reindirizzamento segue questo formato:

https://<nuovo-dominio>/complete/azuread-oauth2/

Prima di confermare il cambio di dominio in SMARTFENSE, esegua questi passaggi nel portale di Azure:

Acceda al portale di Microsoft Azure e apra l'applicazione registrata per SMARTFENSE.
Vada su Panoramica e selezioni l'opzione URI di reindirizzamento.
Aggiunga il nuovo URI, costruito con il nuovo dominio, come URL di risposta.
Prema Salva.

Esegua questi passaggi prima di premere Accetta nella finestra di conferma di SMARTFENSE. Se conferma la modifica senza aggiornare l'URI, gli utenti non potranno autenticarsi tramite Entra ID.

Per ulteriori informazioni sulla configurazione di questa integrazione, consulti il Passo 2 dell'articolo: Come importare utenti e gruppi da Microsoft Entra ID.

Tabella dei domini personalizzati

Per ogni dominio, la tabella mostra le colonne Dominio, DNS target, Stato (Registrato o Principale) e Azioni (Segna come principale, Elimina). Il dominio standard compare sempre nella tabella, senza DNS target, e non può essere eliminato. Quando non è il dominio principale, dispone dell'azione Segna come principale, che consente di tornare a utilizzarlo.

Risoluzione dei problemi

Durante la validazione del dominio aziendale compare il messaggio "Non è stato possibile validare il dominio". La piattaforma non trova il record TXT di validazione sul nome esatto del dominio. Il dettaglio tecnico del messaggio può variare a seconda del caso, ma la causa da verificare è la stessa. Controlli che il record TXT sia stato creato su quel nome e non sul dominio radice: per un sottodominio, il campo Host deve contenere solo la parte del sottodominio, senza @. Lo verifichi con uno strumento di verifica della propagazione DNS, interrogando il dominio completo con il tipo TXT.

Il provider DNS non consente di creare il record CNAME su un sottodominio. Probabilmente esiste ancora il record TXT di validazione o un altro record con lo stesso nome. Lo elimini e crei nuovamente il CNAME.

Il provider DNS non consente di creare il record CNAME su un dominio radice. È il comportamento previsto: i domini radice non supportano i record CNAME. Utilizzi un record ALIAS o ANAME. Se il Suo provider non li offre (ad esempio, GoDaddy), utilizzi un sottodominio come dominio personalizzato.

Premendo Segna come principale compare il messaggio "Il dominio non punta ancora alla piattaforma". Può dipendere da una di queste cause:

Il record non si è ancora propagato o non punta al DNS target corretto. Verifichi la propagazione come indicato al passo 4 e controlli che il valore corrisponda esattamente al DNS target della tabella.
Il certificato di sicurezza non è ancora stato emesso. Attenda fino a un'ora dopo che il record punta alla piattaforma e riprovi.

Se il record è propagato correttamente e l'errore persiste dopo un'ora, contatti il Supporto per verificare lo stato del certificato.

Il sottodominio compare come Non validato in Domini aziendali dopo aver configurato il CNAME. È il comportamento previsto dopo l'eliminazione del record TXT di validazione del sottodominio. Non influisce sul dominio personalizzato. Se il dominio radice compare come Non validato, verifichi che il suo record TXT di validazione non sia stato eliminato.

Domande frequenti

Il dominio standard smette di funzionare? No. Rimane sempre disponibile.

È possibile registrare più domini personalizzati? No. Ogni istanza supporta un solo dominio personalizzato. Se si tenta di registrarne un altro, la piattaforma indica che è stato raggiunto il numero massimo consentito. Per registrare un dominio diverso, elimini prima quello esistente; se è il dominio principale, imposti prima il dominio standard come principale.

È necessario mantenere validato il dominio radice se utilizzo un sottodominio come dominio personalizzato? Non è necessario per il dominio personalizzato, ma è consigliato. La piattaforma utilizza i domini aziendali validati per riconoscere la Sua organizzazione a partire dall'indirizzo e-mail dei Suoi utenti, ad esempio nelle segnalazioni di e-mail sospette.

Quanto tempo occorre perché sia disponibile? Dipende dalla propagazione della modifica DNS, che può richiedere da alcuni minuti a diverse ore. Una volta che il dominio punta alla piattaforma, il certificato di sicurezza (HTTPS) viene emesso automaticamente e può richiedere fino a un'ora in più. Solo allora è possibile impostare il dominio come principale.

Come si torna a utilizzare il dominio standard? Imposti il dominio standard come principale dalla tabella. Se desidera inoltre smettere di utilizzare un dominio personalizzato, lo elimini; prima deve smettere di essere il dominio principale.

Perché non è possibile eliminare il dominio principale? Per evitare che la piattaforma resti senza un indirizzo di accesso valido. Imposti un altro dominio come principale e, successivamente, potrà eliminare quello precedente.

💡 Buone pratiche

Stabilire innanzitutto se il dominio da utilizzare è un dominio radice o un sottodominio, poiché da questo dipendono il valore del campo Host, il tipo di record e la necessità di eliminare il record TXT di validazione.
Validare come dominio aziendale esattamente lo stesso dominio che verrà utilizzato come dominio personalizzato.
Mantenere validato il dominio radice dell'organizzazione, anche se il dominio personalizzato è un sottodominio.
Verificare la propagazione del record CNAME o ALIAS/ANAME e attendere fino a un'ora per l'emissione del certificato prima di impostare il dominio come principale.
Registrare il nuovo indirizzo presso i provider di single sign-on e le altre integrazioni interessate prima di confermare il cambio di dominio principale.
Informare gli utenti del cambio di indirizzo di accesso e mantenere il dominio standard come alternativa in caso di problemi DNS.