Voor het instellen van vertaalde subdomeinen zijn de juiste DNS-, SSL/TLS- en origin-configuraties vereist. Om het oplossen van problemen te vereenvoudigen, biedt Linguise nu een debugger voor subdomeinvertalingen die uw configuratie controleert en eventuele configuratie- of verbindingsproblemen aangeeft.
De debugger helpt u te achterhalen wat de oorzaak is van een mislukte configuratiecontrole en geeft de relevante foutinformatie weer, zodat u het probleem kunt oplossen en uw configuratie opnieuw kunt controleren.
Wat controleert de Subdomain Translation Debugger?
De debugger controleert de DNS-configuratie, SSL/TLS-verbindingen en de oorspronkelijke website (origin). Hij verifieert het domeineigendom, vertaalde CNAME-records van subdomeinen, A/AAAA-records, certificaten en de beschikbaarheid van HTTPS.
Het controleert ook of de oorsprong publiekelijk bereikbaar is en retourneert een bruikbaar HTTP-antwoord. Elke controle retourneert een status en, indien van toepassing, een foutcode.
Inzicht in diagnostische resultaten
De debugger gebruikt verschillende statussen om het resultaat van elke controle weer te geven.
Mislukt
Een 'Mislukt'-status betekent dat de debugger een configuratie- of verbindingsprobleem heeft gedetecteerd dat moet worden opgelost. Controleer de foutcode en diagnostische details om het betreffende onderdeel te identificeren, zoals DNS, SSL/TLS of de oorspronkelijke website. Nadat u het probleem hebt opgelost, voert u de configuratiecontrole opnieuw uit om het resultaat te verifiëren.
Waarschuwing
Een waarschuwingsstatus betekent dat de website bereikbaar is, maar dat de respons ervan een betrouwbare vertaling kan belemmeren of op een mogelijk configuratieprobleem kan duiden. Bekijk de diagnostische details en controleer de configuratie van de bronwebsite, server of het netwerk, zoals aangegeven. Zodra het probleem is opgelost, voert u de configuratiecontrole opnieuw uit.
Onbekend
Een onbekende status betekent dat de debugger geen betrouwbaar resultaat voor de controle heeft kunnen vaststellen. Probeer eerst de configuratiecontrole opnieuw. Als de status blijft bestaan, bekijk dan de diagnostische informatie en onderzoek of een onderliggend DNS-, TLS- of verbindingsprobleem de oorzaak is.
Overgeslagen
De status 'Overgeslagen' betekent dat de controle niet kon worden uitgevoerd omdat een eerdere, vereiste controle is mislukt. Een TLS-controle kan bijvoorbeeld worden overgeslagen als de vertaalde hostnaam niet via DNS kan worden opgelost. De status 'Overgeslagen' betekent dat de controle niet kon worden uitgevoerd omdat een eerdere controle is mislukt. Los eerst de eerder mislukte controle op en voer vervolgens de installatiecontrole opnieuw uit.
DNS-fouten
DNS-fouten treden op wanneer de records die nodig zijn om uw vertaalde subdomeinen of oorspronkelijke website te verbinden, ontbreken, onjuist zijn of niet kunnen worden opgelost.
Onjuiste of ontbrekende subdomein-CNAME
Deze foutmelding betekent dat een hostnaam in een vertaalde taal niet wordt omgezet naar het vereiste Linguise CNAME-doel.
Controleer de DNS-configuratie voor de betreffende taalhostnaam en zorg ervoor dat de CNAME-record verwijst naar het Linguise doel dat tijdens de installatie is opgegeven. Als de record ontbreekt of naar het verkeerde doel verwijst, moet u deze bijwerken bij uw DNS-provider. De debugger kan de volgende fouten melden:
- DNS_CNAME_NXDOMAIN: de vertaalde hostnaam kan niet worden opgelost.
- DNS_CNAME_MISMATCH: de CNAME verwijst naar een onjuiste bestemming.
Verificatie van domeineigendom
Deze foutmelding betekent dat het vereistelinguise TXT-record ontbreekt of dat de waarde ervan niet overeenkomt met de huidige verificatiewaarde. De debugger kan DNS_TXT_MISMATCH melden wanneer het TXT-record niet de verwachte verificatiewaarde bevat.
Open je DNS-provider en controleer delinguise.<domain> TXT-record. Voeg het record toe als het ontbreekt, of werk de waarde ervan bij naar de verificatiewaarde die door Linguisewordt verstrekt.
Verwijder geen irrelevante TXT-records van uw domein. Nadat de DNS-wijziging is doorgevoerd, voert u de configuratiecontrole opnieuw uit.
Oorspronkelijke domein DNS-fout
Deze foutmelding betekent dat het oorspronkelijke domein niet verwijst naar een bruikbaar openbaar A- of AAAA-record. Controleer uw DNS-records en zorg ervoor dat het domein naar het juiste openbare IP-adres verwijst.
Als het record ontbreekt of onjuist is, werk het dan bij via uw DNS-provider. Wacht tot de DNS-wijzigingen zijn doorgevoerd en voer de configuratiecontrole vervolgens opnieuw uit.
SSL/TLS-fouten
SSL/TLS-fouten treden op wanneer Linguise geen geldige, beveiligde HTTPS-verbinding kan maken met het vertaalde subdomein of de oorspronkelijke website.
Vertaalde subdomein SSL/TLS-fout
Deze foutmelding betekent dat Linguise geen geldige TLS-verbinding met de vertaalde hostnaam tot stand kon brengen.
Controleer of de hostnaam een geldig, niet-verlopen SSL-certificaat heeft dat exact overeenkomt met de hostnaam. Controleer ook of de certificaatketen compleet is en of HTTPS beschikbaar is op poort 443.
Als u een CDN, reverse proxy of WAF gebruikt, controleer dan de TLS-configuratie en zorg ervoor dat deze de verbinding niet blokkeert. Nadat u de configuratie hebt gecorrigeerd, voert u de installatiecontrole opnieuw uit.
Oorspronkelijke SSL/TLS-fout van de website
Deze foutmelding betekent dat Linguise geen geldige HTTPS-verbinding met de oorspronkelijke website tot stand kon brengen.
Controleer het broncertificaat op vervaldatum, onjuiste hostnaam, onvolledige certificaatketen of andere TLS-configuratieproblemen. Als uw website gebruikmaakt van een CDN of reverse proxy, controleer dan ook of het juiste certificaat wordt gebruikt voor de oorspronkelijke verbinding. Corrigeer het certificaat of de TLS-configuratie en voer de controle opnieuw uit.
Fouten op de oorspronkelijke website
Oorsprongsfouten treden op wanneer Linguise de oorspronkelijke website niet goed kan bereiken of geen bruikbaar antwoord van de website ontvangt.
Oorsprong-bestemmingsfout
Deze foutmelding betekent dat de geconfigureerde oorsprong verwijst naar een bestemming die Linguise niet kan bereiken. Zorg ervoor dat het domein verwijst naar een publiekelijk bereikbare bestemming.
Als de oorsprong een privé-, loopback- of link-local-adres gebruikt, moet u de oorsprongconfiguratie bijwerken naar een publiek bereikbare bestemming en vervolgens de configuratiecontrole opnieuw uitvoeren.
Oorspronkelijke HTTP-fouten
Deze foutmelding betekent dat Linguise de oorspronkelijke website wel kan bereiken, maar een HTTP-respons ontvangt die een betrouwbare vertaling kan belemmeren.
Veelvoorkomende oorzaken zijn onder andere time-outs bij aanvragen, authenticatievereisten, snelheidsbeperking, omleidingen of serverfouten. Controleer de website van herkomst en bekijk uw server-, firewall-, WAF-, authenticatie- en snelheidsbeperkingsconfiguratie.
Zorg ervoor dat de oorspronkelijke website een geldig antwoord kan geven op verzoeken van Linguiseen voer vervolgens de configuratiecontrole opnieuw uit.
Diagnostische en runtimefouten
Diagnostische fouten en runtimefouten hebben betrekking op de debugger of het bijbehorende diagnoseproces en duiden niet per se op een probleem met de DNS-, TLS- of oorspronkelijke configuratie.
CORE_CHECKER_FAILED
Deze foutmelding betekent dat de diagnostische controle niet succesvol is afgerond. Probeer de controle opnieuw en bekijk de diagnostische details, indien beschikbaar. Als de fout zich blijft voordoen, controleer dan of er configuratie- of verbindingsproblemen zijn die het diagnoseproces beïnvloeden.
DIAGNOSTIC_CONFIG_CHANGED
Deze foutmelding betekent dat de diagnostische configuratie is gewijzigd tijdens de controle, waardoor het resultaat mogelijk niet langer geldig is. Voer de diagnose opnieuw uit met de huidige configuratie om ervoor te zorgen dat de controle de meest recente instellingen gebruikt.
DIAGNOSTISCHE_DEADLINE_OVERSCHREDEN
Deze foutmelding betekent dat de diagnostische bewerking niet binnen de toegestane tijd is voltooid. Probeer de configuratiecontrole opnieuw en bekijk de diagnostische details om te bepalen of de controle wordt vertraagd door de huidige configuratie of de internetverbinding.
DIAGNOSTIC_DOMAIN_NOT_FOUND
Deze foutmelding betekent dat de diagnose het geconfigureerde domein niet kon vinden of oplossen. Controleer of het domein correct is geconfigureerd en of de DNS-records openbaar beschikbaar zijn. Nadat u eventuele DNS- of domeinconfiguratieproblemen hebt opgelost, voert u de controle opnieuw uit.
DIAGNOSTIC_INVALID_REQUEST
Deze foutmelding betekent dat het diagnostische verzoek niet kon worden verwerkt omdat het verzoek ongeldig was. Probeer de configuratiecontrole opnieuw en zorg ervoor dat de diagnose wordt uitgevoerd met de huidige configuratie en geldige verzoekgegevens.
DIAGNOSTISCHE_SONDE_MISLUKT
Deze foutmelding betekent dat een individuele diagnostische test niet succesvol is afgerond. Probeer de diagnose opnieuw en bekijk de beschikbare details om te achterhalen welke test is mislukt en of het probleem verband houdt met de huidige configuratie of de verbinding.
DIAGNOSTIC_FAILED
Deze foutmelding betekent dat het algehele diagnoseproces geen geldig resultaat heeft opgeleverd. Probeer de configuratiecontrole opnieuw en bekijk de beschikbare diagnostische gegevens, waaronder de betreffende hostnaam, aanvraag-ID en tijdstempel, om de oorzaak te achterhalen.
Als de fout aanhoudt na het opnieuw proberen en controleren van de relevante configuratie, geef dan de foutcode en de details van het diagnostisch verzoek door aan Linguise ondersteuning voor verder onderzoek.
Hoe los ik dit probleem op?
Bij het oplossen van een probleem met een mislukte installatiecontrole, dient u de problemen in de volgorde te verhelpen die door de diagnostische resultaten wordt aangegeven:
- Domeineigendom en DNS: Zorg ervoor dat de vereiste TXT-, CNAME- en A/AAAA-records correct zijn geconfigureerd en publiekelijk bereikbaar zijn.
- SSL/TLS: Controleer de relevante certificaten, hostnaamconfiguratie, certificaatketen en HTTPS-beschikbaarheid.
- Oorsprong: Zorg ervoor dat de originele website publiekelijk bereikbaar is en dat de server, firewall, WAF, authenticatie en rate-limiting configuratie Linguise toegang tot de website verlenen.
- Voer de installatiecontrole opnieuw uit: Nadat u de benodigde correcties hebt toegepast en de DNS-wijzigingen de tijd hebt gegeven om te worden doorgevoerd, voert u de installatiecontrole opnieuw uit.
Het oplossen van een eerdere DNS- of verbindingsfout kan ook afhankelijke TLS- of oorsprongsfouten verhelpen, evenals controles die eerder als overgeslagen waren gemarkeerd.
Met de debugger voor subdomeinvertalingen kunt u gemakkelijker DNS-, SSL/TLS- en origin-problemen opsporen en oplossen die van invloed zijn op vertaalde subdomeinen. Bekijk de gerapporteerde fout, pas de aanbevolen oplossing toe en voer 'Controleer de configuratie' opnieuw uit om te bevestigen dat uw configuratie correct werkt.
Als het probleem aanhoudt nadat u de aanbevolen stappen voor probleemoplossing hebt gevolgd, neem dan contact op met Linguise de ondersteuning voor verdere hulp.
