La configuration des sous-domaines traduits nécessite une configuration DNS, SSL/TLS et d'origine correcte. Pour faciliter le dépannage, Linguise propose désormais un outil de débogage de la traduction des sous-domaines qui vérifie votre configuration et met en évidence les problèmes de configuration ou de connectivité.
Le débogueur vous aide à identifier la cause de l'échec d'une vérification de configuration et fournit les informations d'erreur pertinentes afin que vous puissiez corriger le problème et vérifier à nouveau votre configuration.
Que vérifie le débogueur de traduction de sous-domaine ?
Le débogueur vérifie la configuration DNS, les connexions SSL/TLS et le site web d'origine. Il vérifie la propriété du domaine, les enregistrements CNAME des sous-domaines traduits, les enregistrements A/AAAA, les certificats et la disponibilité du protocole HTTPS.
Il vérifie également si l'origine est accessible publiquement et renvoie une réponse HTTP exploitable. Chaque vérification renvoie un statut et, le cas échéant, un code d'erreur.
Comprendre les résultats du diagnostic
Le débogueur utilise différents statuts pour afficher le résultat de chaque vérification.
Échoué
Un statut « Échec » signifie que le débogueur a détecté un problème de configuration ou de connectivité nécessitant une résolution. Consultez le code d'erreur et les détails du diagnostic pour identifier le composant concerné, tel que le DNS, le protocole SSL/TLS ou le site web d'origine. Une fois le problème résolu, relancez la vérification de l'installation pour confirmer le résultat.
Avertissement
Un statut d'avertissement signifie que le site web est accessible, mais que sa réponse peut empêcher une traduction fiable ou indiquer un problème de configuration potentiel. Consultez les détails du diagnostic et vérifiez le site web d'origine, le serveur ou la configuration réseau, comme indiqué. Une fois le problème résolu, relancez la vérification de la configuration.
Inconnu
Un statut « Inconnu » signifie que le débogueur n'a pas pu obtenir de résultat fiable pour la vérification. Veuillez d'abord réessayer la vérification de la configuration. Si le problème persiste, consultez les informations de diagnostic et vérifiez si un problème sous-jacent de DNS, de TLS ou de connectivité en est la cause.
Omission
Le statut « Ignoré » signifie que la vérification n'a pas pu être exécutée car une vérification préalable requise a échoué. Par exemple, une vérification TLS peut être ignorée si le nom d'hôte traduit ne peut pas être résolu par le DNS. Dans ce cas, corrigez d'abord la vérification ayant échoué, puis relancez la vérification de configuration.
Erreurs DNS
Les erreurs DNS surviennent lorsque les enregistrements nécessaires à la connexion de vos sous-domaines traduits ou de votre site web d'origine sont manquants, incorrects ou ne peuvent pas être résolus.
CNAME de sous-domaine incorrect ou manquant
Cette erreur signifie que le nom d'hôte d'une langue traduite ne correspond pas à la cible CNAME Linguise requise.
Vérifiez la configuration DNS du nom d'hôte de la langue concernée et assurez-vous que son enregistrement CNAME pointe vers la Linguise fournie lors de l'installation. Si l'enregistrement est manquant ou pointe vers une cible incorrecte, mettez-le à jour auprès de votre fournisseur DNS. Le débogueur peut signaler les erreurs suivantes :
- DNS_CNAME_NXDOMAIN : le nom d'hôte traduit ne peut pas être résolu.
- DNS_CNAME_MISMATCH : le CNAME pointe vers une cible incorrecte.
vérification de la propriété du domaine
Cette erreur signifie que l'enregistrement TXT _linguise est manquant ou que sa valeur ne correspond pas à la valeur de vérification actuelle. Le débogueur peut signaler DNS_TXT_MISMATCH lorsque l'enregistrement TXT ne contient pas la valeur de vérification attendue.
Ouvrez votre fournisseur DNS et vérifiez le _linguise.<domain> Enregistrement TXT. Ajoutez l'enregistrement s'il est manquant, ou mettez à jour sa valeur avec la valeur de vérification fournie par Linguise.
Ne supprimez pas les enregistrements TXT non pertinents de votre domaine. Une fois la modification DNS propagée, relancez la vérification de la configuration.
Erreur DNS du domaine d'origine
Cette erreur signifie que le domaine d'origine ne correspond à aucun enregistrement A ou AAAA public valide. Vérifiez vos enregistrements DNS et assurez-vous que le domaine correspond bien à l'adresse IP publique correcte.
Si l'enregistrement est manquant ou incorrect, mettez-le à jour auprès de votre fournisseur DNS. Attendez que les modifications DNS soient propagées, puis relancez la vérification de la configuration.
Erreurs SSL/TLS
Les erreurs SSL/TLS surviennent lorsque Linguise ne parvient pas à établir une connexion HTTPS sécurisée valide avec le sous-domaine traduit ou le site web d'origine.
Erreur SSL/TLS du sous-domaine traduit
Cette erreur signifie que Linguise n'a pas pu établir de connexion TLS valide avec le nom d'hôte traduit.
Vérifiez que le nom d'hôte possède un certificat SSL valide et non expiré correspondant exactement à ce nom. Assurez-vous également que la chaîne de certificats est complète et que le protocole HTTPS est disponible sur le port 443.
Si vous utilisez un CDN, un proxy inverse ou un WAF, vérifiez sa configuration TLS et assurez-vous qu'elle n'empêche pas la connexion. Après avoir corrigé la configuration, relancez la vérification.
Erreur SSL/TLS du site web d'origine
Cette erreur signifie que Linguise n'a pas pu établir de connexion HTTPS valide avec le site web d'origine.
Vérifiez la validité du certificat d'origine, l'absence d'incohérence du nom d'hôte, la présence d'une chaîne de certificats incomplète ou d'autres problèmes de configuration TLS. Si votre site web utilise un CDN ou un proxy inverse, assurez-vous également que le certificat approprié est utilisé pour la connexion à l'origine. Corrigez le certificat ou la configuration TLS, puis relancez la vérification.
Erreurs du site web d'origine
Les erreurs d'origine se produisent lorsque Linguise ne parvient pas à accéder correctement au site web d'origine ou ne reçoit pas de réponse exploitable de sa part.
Erreur d'origine-destination
Cette erreur signifie que l'origine configurée pointe vers une destination inaccessible à Linguise . Assurez-vous que le domaine pointe vers une destination accessible publiquement.
Si l'origine utilise une adresse privée, de bouclage ou locale au lien, mettez à jour la configuration de l'origine pour utiliser une destination accessible publiquement, puis exécutez à nouveau la vérification de la configuration.
Erreurs HTTP d'origine
Cette erreur signifie que Linguise peut accéder au site web d'origine, mais reçoit une réponse HTTP qui peut empêcher une traduction fiable.
Les causes fréquentes incluent les délais d'attente de requête, les exigences d'authentification, la limitation du débit, les redirections ou les erreurs serveur. Consultez directement le site web d'origine et vérifiez la configuration de votre serveur, pare-feu, WAF, authentification et limitation du débit.
Assurez-vous que le site web d'origine peut renvoyer une réponse valide aux requêtes de Linguise, puis relancez la vérification de la configuration.
Erreurs de diagnostic et d'exécution
Les erreurs de diagnostic et d'exécution sont liées au débogueur ou à son processus de diagnostic et n'indiquent pas nécessairement un problème de configuration DNS, TLS ou d'origine.
ÉCHEC DU VÉRIFICATEUR DE BASE
Cette erreur signifie que l'outil de diagnostic principal n'a pas pu mener à bien la vérification. Veuillez relancer la vérification de la configuration et consulter les détails du diagnostic, le cas échéant. Si l'erreur persiste, vérifiez si un problème de configuration ou de connectivité affecte le processus de diagnostic.
CONFIGURATION_DIAGNOSTIQUE_MODIFIÉE
Cette erreur signifie que la configuration du diagnostic a été modifiée pendant l'exécution de la vérification ; le résultat peut donc ne plus être valide. Relancez le diagnostic avec la configuration actuelle pour vous assurer que la vérification utilise les paramètres les plus récents.
DÉLAI_DE_DIAGNOSTIQUE_DÉPASSÉ
Cette erreur signifie que l'opération de diagnostic n'a pas pu se terminer dans le délai imparti. Veuillez relancer la vérification de la configuration et consulter les détails du diagnostic afin de déterminer si le problème vient de la configuration actuelle ou de la connectivité.
DOMAINE_DIAGNOSTIQUE_INTROUVABLE
Cette erreur signifie que le diagnostic n'a pas pu trouver ou résoudre le domaine configuré. Vérifiez que le domaine est correctement configuré et que ses enregistrements DNS sont accessibles publiquement. Après avoir corrigé tout problème de configuration DNS ou de domaine, relancez la vérification.
DEMANDE_DIAGNOSTIQUE_INVALIDE
Cette erreur signifie que la requête de diagnostic n'a pas pu être traitée car elle était invalide. Veuillez relancer la vérification de la configuration et vous assurer que le diagnostic est exécuté avec la configuration actuelle et des informations de requête valides.
ÉCHEC DE LA SONDE DE DIAGNOSTIC
Cette erreur signifie qu'une sonde de diagnostic n'a pas pu s'exécuter correctement. Veuillez relancer le diagnostic et consulter les informations disponibles pour identifier la sonde défaillante et déterminer si le problème est lié à la configuration ou à la connectivité.
ÉCHEC DU DIAGNOSTIC
Cette erreur signifie que le processus de diagnostic global n'a pas pu produire de résultat valide. Veuillez relancer la vérification de la configuration et consulter les informations de diagnostic disponibles, notamment le nom d'hôte concerné, l'ID de la requête et l'horodatage, afin d'identifier la cause du problème.
Si l'erreur persiste après plusieurs tentatives et vérifications de la configuration, veuillez fournir le code d'erreur et les détails de la demande de diagnostic au support Linguise pour une analyse plus approfondie.
Comment résoudre le problème
Lors du dépannage d'un échec de vérification de configuration, corrigez les problèmes dans l'ordre indiqué par les résultats du diagnostic :
- Propriété du domaine et DNS : assurez-vous que les enregistrements TXT, CNAME et A/AAAA requis sont correctement configurés et résolvables publiquement.
- SSL/TLS: Vérifiez les certificats pertinents, la configuration du nom d'hôte, la chaîne de certificats et la disponibilité du protocole HTTPS.
- Origine: Assurez-vous que le site web d'origine est accessible publiquement et que sa configuration de serveur, de pare-feu, de WAF, d'authentification et de limitation de débit permet Linguise d'y accéder.
- Relancez la vérification de configuration : après avoir appliqué les correctifs nécessaires et laissé le temps aux modifications DNS de se propager, relancez la vérification de configuration.
La correction d'une erreur DNS ou de connectivité antérieure peut également résoudre les erreurs TLS ou d'origine dépendantes, ainsi que les vérifications qui avaient été précédemment marquées comme ignorées.
L'outil de débogage de la traduction des sous-domaines facilite l'identification et la résolution des problèmes DNS, SSL/TLS et d'origine affectant les sous-domaines traduits. Consultez l'erreur signalée, appliquez la solution recommandée et exécutez à nouveau la vérification de la configuration pour confirmer son bon fonctionnement.
Si le problème persiste après avoir suivi les étapes de dépannage recommandées, contactez Linguise le support pour obtenir de l'aide supplémentaire.
