La configurazione dei sottodomini tradotti richiede una corretta configurazione di DNS, SSL/TLS e origine. Per semplificare la risoluzione dei problemi, Linguise ora offre uno strumento di debug per la traduzione dei sottodomini che verifica la configurazione ed evidenzia eventuali problemi di configurazione o connettività.
Il debugger ti aiuta a identificare la causa dell'errore durante la verifica della configurazione e fornisce le informazioni di errore pertinenti, in modo da poter risolvere il problema e verificare nuovamente la configurazione.
Cosa verifica il debugger di traduzione del sottodominio?
Il debugger controlla la configurazione DNS, le connessioni SSL/TLS e il sito web di origine. Verifica la proprietà del dominio, i record CNAME dei sottodomini tradotti, i record A/AAAA, i certificati e la disponibilità di HTTPS.
Verifica inoltre se l'origine è raggiungibile pubblicamente e restituisce una risposta HTTP utilizzabile. Ogni verifica restituisce uno stato e, se applicabile, un codice di errore.
Interpretazione dei risultati diagnostici
Il debugger utilizza diversi stati per mostrare il risultato di ogni controllo.
Fallito
Lo stato "Non riuscito" indica che il debugger ha rilevato un problema di configurazione o di connettività che deve essere risolto. Controllare il codice di errore e i dettagli diagnostici per identificare il componente interessato, ad esempio DNS, SSL/TLS o il sito Web di origine. Dopo aver risolto il problema, eseguire nuovamente il controllo della configurazione per verificarne il risultato.
Avvertimento
Lo stato di avviso indica che il sito web è raggiungibile, ma la sua risposta potrebbe impedire una traduzione affidabile o segnalare un potenziale problema di configurazione. Esamina i dettagli diagnostici e verifica il sito web di origine, il server o la configurazione di rete, come indicato. Una volta risolto il problema, esegui nuovamente il controllo della configurazione.
Sconosciuto
Lo stato "Sconosciuto" indica che il debugger non è riuscito a stabilire un risultato affidabile per il controllo. Riprovare prima il controllo della configurazione. Se lo stato persiste, esaminare le informazioni diagnostiche e verificare se la causa è un problema sottostante relativo a DNS, TLS o connettività.
Saltato
Lo stato "Ignorato" indica che il controllo non è stato eseguito perché un controllo precedente obbligatorio non è riuscito. Ad esempio, un controllo TLS potrebbe essere ignorato quando il nome host tradotto non può essere risolto tramite DNS. Lo stato "Ignorato" indica che il controllo non è stato eseguito perché un controllo precedente non è riuscito. Correggere prima il controllo precedente non riuscito, quindi eseguire nuovamente il controllo di configurazione.
Errori DNS
Gli errori DNS si verificano quando i record necessari per connettere i sottodomini tradotti o il sito web originale sono mancanti, errati o non risolvibili.
CNAME del sottodominio errato o mancante
Questo errore indica che un nome host in una lingua tradotta non si risolve nel target CNAME Linguise richiesta.
Verifica la configurazione DNS per il nome host della lingua interessata e assicurati che il suo record CNAME punti alla Linguise specificata durante la configurazione. Se il record è mancante o punta a una destinazione errata, aggiornalo presso il tuo provider DNS. Il debugger potrebbe segnalare i seguenti errori:
- DNS_CNAME_NXDOMAIN: impossibile risolvere il nome host tradotto.
- DNS_CNAME_MISMATCH: il CNAME punta a una destinazione errata.
Verifica della proprietà del dominio
Questo errore indica che illinguise è mancante o il suo valore non corrisponde al valore di verifica corrente. Il debugger potrebbe segnalare DNS_TXT_MISMATCH quando il record TXT non contiene il valore di verifica previsto.
Apri il tuo provider DNS e controlla lalinguise.<domain> Record TXT. Aggiungi il record se mancante oppure aggiorna il suo valore con il valore di verifica fornito da Linguise.
Non rimuovere i record TXT non correlati dal tuo dominio. Dopo che la modifica DNS si è propagata, esegui nuovamente il controllo della configurazione.
Errore DNS del dominio originale
Questo errore indica che il dominio originale non si risolve in un record DNS pubblico A o AAAA utilizzabile. Controlla i tuoi record DNS e assicurati che il dominio si risolva nell'indirizzo IP pubblico corretto.
Se il record DNS è mancante o errato, aggiornalo presso il tuo provider DNS. Attendi che le modifiche DNS si propaghino, quindi esegui nuovamente il controllo della configurazione.
Errori SSL/TLS
Gli errori SSL/TLS si verificano quando Linguise non riesce a stabilire una connessione HTTPS sicura valida con il sottodominio tradotto o con il sito web originale.
Errore SSL/TLS del sottodominio tradotto
Questo errore indica che Linguise non è riuscito a stabilire una connessione TLS valida con il nome host tradotto.
Verifica che il nome host disponga di un certificato SSL valido e non scaduto che corrisponda esattamente al nome host. Verifica inoltre che la catena di certificati sia completa e che HTTPS sia disponibile sulla porta 443.
Se utilizzi una CDN, un proxy inverso o un WAF, verifica la configurazione TLS e assicurati che non impedisca la connessione. Dopo aver corretto la configurazione, esegui nuovamente il controllo di installazione.
Errore SSL/TLS del sito web originale
Questo errore indica che Linguise non è riuscito a stabilire una connessione HTTPS valida con il sito web originale.
Verifica la scadenza del certificato di origine, la mancata corrispondenza del nome host, l'incompletezza della catena di certificati o altri problemi di configurazione TLS. Se il tuo sito Web utilizza una CDN o un proxy inverso, verifica anche che venga fornito il certificato corretto per la connessione di origine. Correggi il certificato o la configurazione TLS, quindi esegui nuovamente il controllo di configurazione.
Errori sul sito web di Origin
Gli errori di origine si verificano quando Linguise non riesce a raggiungere correttamente il sito web di origine o non riceve da esso una risposta utilizzabile.
Errore di origine/destinazione
Questo errore indica che l'origine configurata punta a una destinazione a cui Linguise non può accedere. Assicurati che il dominio punti a una destinazione raggiungibile pubblicamente.
Se l'origine utilizza un indirizzo privato, di loopback o link-local, aggiornare la configurazione dell'origine in modo che utilizzi una destinazione raggiungibile pubblicamente, quindi eseguire nuovamente il controllo della configurazione.
Errori HTTP di origine
Questo errore significa che Linguise riesce a raggiungere il sito web originale, ma riceve una risposta HTTP che potrebbe impedire una traduzione affidabile.
Le cause più comuni includono timeout delle richieste, requisiti di autenticazione, limitazione della frequenza delle richieste, reindirizzamenti o errori del server. Controlla direttamente il sito web di origine e rivedi la configurazione del tuo server, firewall, WAF, autenticazione e limitazione della frequenza delle richieste.
Assicurati che il sito web originale sia in grado di restituire una risposta valida alle richieste di Linguise, quindi esegui nuovamente il controllo della configurazione.
Errori diagnostici e di runtime
Gli errori diagnostici e di runtime sono correlati al debugger o al suo processo diagnostico, piuttosto che indicare necessariamente un problema di configurazione DNS, TLS o dell'origine.
CORE_CHECKER_FAILED
Questo errore indica che lo strumento di diagnostica principale non è riuscito a completare correttamente il controllo. Riprovare il controllo della configurazione e, se disponibili, esaminare i dettagli della diagnostica. Se l'errore persiste, verificare se eventuali problemi di configurazione o di connettività potrebbero influire sul processo di diagnostica.
CONFIGURAZIONE DIAGNOSTICA MODIFICATA
Questo errore indica che la configurazione diagnostica è cambiata durante l'esecuzione del controllo, pertanto il risultato potrebbe non essere più valido. Eseguire nuovamente la diagnostica utilizzando la configurazione corrente per assicurarsi che il controllo utilizzi le impostazioni più recenti.
SCADENZA DIAGNOSTICA SUPERATA
Questo errore indica che l'operazione diagnostica non è stata completata entro il tempo consentito. Riprovare il controllo della configurazione e rivedere i dettagli della diagnostica per determinare se il controllo è ritardato dalla configurazione attuale o dalla connettività.
DOMINIO DIAGNOSTICO NON TROVATO
Questo errore indica che lo strumento di diagnostica non è riuscito a trovare o risolvere il dominio configurato. Verificare che il dominio sia configurato correttamente e che i relativi record DNS siano accessibili pubblicamente. Dopo aver corretto eventuali problemi di configurazione DNS o del dominio, eseguire nuovamente il controllo di configurazione.
RICHIESTA DIAGNOSTICA NON VALIDA
Questo errore indica che la richiesta diagnostica non è stata elaborata perché non valida. Riprova il controllo della configurazione e assicurati che la diagnostica venga eseguita con la configurazione corrente e con dettagli di richiesta validi.
SONDA DIAGNOSTICA FALLITA
Questo errore indica che una singola sonda diagnostica non è stata completata correttamente. Riprovare la diagnostica e rivedere i dettagli disponibili per identificare quale sonda ha fallito e se il problema è correlato alla configurazione corrente o alla connettività.
DIAGNOSTICA FALLITA
Questo errore indica che l'intero processo diagnostico non è riuscito a produrre un risultato valido. Riprova il controllo della configurazione e rivedi tutti i dettagli diagnostici disponibili, inclusi il nome host interessato, l'ID della richiesta e la data e l'ora, per identificare la causa.
Se l'errore persiste anche dopo aver riprovato e verificato la configurazione, fornire il codice di errore e i dettagli della richiesta di diagnostica al supporto Linguise per ulteriori indagini.
Come risolvere il problema
Quando si risolve un problema relativo a un controllo di configurazione non riuscito, correggere i problemi nell'ordine indicato dai risultati della diagnostica:
- Proprietà del dominio e DNS: assicurarsi che i record TXT, CNAME e A/AAAA richiesti siano configurati correttamente e risolvibili pubblicamente.
- SSL/TLS: Verificare i certificati pertinenti, la configurazione del nome host, la catena di certificati e la disponibilità di HTTPS.
- Origine: Assicurarsi che il sito web originale sia accessibile pubblicamente e che la configurazione del server, del firewall, del WAF, dell'autenticazione e della limitazione della velocità consenta a Linguise di accedervi.
- Eseguire nuovamente il controllo della configurazione: dopo aver applicato le correzioni necessarie e aver atteso il tempo necessario affinché le modifiche DNS si propaghino, eseguire nuovamente il controllo della configurazione.
La correzione di un precedente errore DNS o di connettività può anche risolvere errori TLS o di origine dipendenti, nonché controlli che in precedenza erano stati contrassegnati come ignorati.
Il debugger per la traduzione dei sottodomini semplifica l'identificazione e la risoluzione dei problemi relativi a DNS, SSL/TLS e origine che interessano i sottodomini tradotti. Esamina l'errore segnalato, applica la soluzione consigliata ed esegui nuovamente il controllo della configurazione per verificare che funzioni correttamente.
Se il problema persiste anche dopo aver seguito le procedure di risoluzione dei problemi consigliate, contatta Linguise l'assistenza per ulteriore supporto.
