Portée et conditions préalables
Cette procédure concerne l'itinéraire de domaine personnalisé Avis et fidélité décrit dans le guide de Yotpo. CNAME guide d'authentification. Nous ne prétendons pas que tous les produits Yotpo, y compris les SMS et les e-mails, utilisent la même configuration. L'itinéraire documenté utilise SendGrid derrière Yotpo et nécessite des enregistrements spécifiques au domaine fournis par le support. Demandez au propriétaire des avis ou du programme de fidélité de confirmer le domaine exact indiqué dans les paramètres de messagerie du produit avant de demander des enregistrements.
Configurer l'itinéraire documenté
- Étape 1. Enregistrez le produit, le compte, destiné à être visible à partir du domaine et de la propriété DNS existante. Identifiez toute autre application utilisant déjà SendGrid pour ce domaine.
- Étape 2. Demandez l'ensemble CNAME du domaine auprès du support Yotpo Reviews ou du support Yotpo Loyalty. Indiquez le domaine exact des paramètres de messagerie et divulguez une intégration SendGrid existante afin que le support puisse fournir une structure d'enregistrement non conflictuelle.
- Étape 3. Copiez chaque hôte et cible fournis dans la zone DNS faisant autorité. L'illustration de Yotpo comprend un CNAME lié à l'enveloppe et deux DKIM CNAME, mais ses chaînes d'hôte et de valeur sont uniques par domaine. L'illustration n'est pas une configuration pour votre compte.
- Étape 4. Conservez les types d'enregistrement. Ne remplacez pas un CNAME demandé par un Enregistrement TXT ou écraser un sélecteur délégué à un autre expéditeur. Chez un propriétaire CNAME , les enregistrements ordinaires conflictuels doivent être résolus avant de publier la nouvelle délégation.
- Étape 5. Demandez à l'assistance Yotpo de valider les enregistrements publiés et de terminer l'activation. La publication DNS à elle seule ne constitue pas la dernière étape documentée.
- Étape 6. Déclenchez un message d'avis ou de fidélité représentatif une fois que l'assistance a confirmé l'achèvement. Capturez les identités obtenues avant de déployer la configuration sur un autre produit ou une autre vitrine.
Risques spécifiques au produit
Si la validation du domaine échoue toujours, comparez le propriétaire DNS et la cible CNAME avec le dernier ensemble publié par le support, et non avec une ancienne capture d'écran. Si un sélecteur SendGrid existant est occupé, revenez à la prise en charge de la structure alternative correcte au lieu de supprimer une intégration fonctionnelle. Un lien de suivi fonctionnel ou un nom d'affichage de marque ne peut pas établir DKIM alignement. Conservez l'identifiant du dossier de support avec l'enregistrement de modification afin que les questions de clé ou de domaine ultérieures puissent être liées à la délégation d'origine.
Prouver l'itinéraire à la réception
Utilisez une boîte aux lettres externe approuvée et enregistrez le message brut complet avec son horodatage et son identifiant de message. Aucun test de locataire en direct n'est revendiqué dans ce guide. Ce qui suit est une feuille de travail d'acceptation à remplir pendant la mise en œuvre, et non un enregistrement des résultats observés.
- Champ de preuve : visible depuis ; Ce qu'il faut enregistrer : adresse et domaine réels ; Question d'acceptation : s'agit-il de l'identité de l'expéditeur prévu ?
- Champ de preuve : Enveloppe ; Ce qu'il faut enregistrer : Return-Path et signalé par le récepteur SPF domaine; Question d'acceptation : quel domaine SPF a-t-il réellement authentifié ?
- Champ de preuve : SPF ; Ce qu'il faut enregistrer : résultat du récepteur de confiance et identité évaluée ; Question d'acceptation : est-ce que cela a réussi et cette identité s'aligne-t-elle ?
- Champ de preuve : DKIM ; Ce qu'il faut enregistrer : chaque d= domaine, s= résultat du sélecteur et du récepteur ; Question d'acceptation : est-ce qu'au moins une signature de passage s'aligne ?
- Champ de preuve : DMARC; Ce qu'il faut enregistrer : résultat du récepteur et politique applicable ; Question d'acceptation : existe-t-il un chemin de dépassement aligné ?
- Champ de preuve : itinéraire ; Ce qu'il faut enregistrer : produit, compte et type de message ; Question d'acceptation : le test a-t-il utilisé le chemin de production ?
DMARC a besoin d’au moins un chemin SPF ou DKIM aligné et passant. Une signature transmise provenant d'un domaine de service non lié ne suffit pas. Un alignement strict nécessite une égalité exacte des domaines ; l’alignement détendu utilise la relation organisation-domaine applicable. Vérifiez les paramètres d'alignement réels du domaine avant de déclarer le succès. Un sous-domaine n'est pas une correspondance stricte automatique. SPF utilise l'identité SMTP , pas le nom d'affichage ou Reply-To. Consultez le glossaire d'alignement lors de l'enregistrement de la décision.
Utiliser Authentication-Results du système de réception auquel vous faites confiance, et non un en-tête fourni par un expéditeur arbitraire. Capturez toutes les signatures plutôt que de vous arrêter au premier échec. Pour le courrier transféré, comparez un test direct avec une copie transférée : le transfert peut modifier l'évaluation SPF ou altérer le contenu signé. Ne diagnostiquez pas ces effets en ajoutant l'adresse du transitaire à l'autorisation de votre fournisseur.
Diagnostiquer les pannes sans élargir l’accès
Comparez d'abord DNS faisant autorité avec les noms d'enregistrement configurés exacts, puis vérifiez la visibilité récursive et la validation du service. Un nom erroné, une clé tronquée ou CNAME en conflit ne sont pas corrigés en attendant les caches. Conservez une seule stratégie SPF chez un propriétaire et vérifiez la limite de dix termes de recherche DNS pour les inclusions et les redirections évaluées avant de fusionner un autre expéditeur. Les sélecteurs DKIM appartiennent à des configurations de signature individuelles ; n'écrasez pas l'enregistrement d'une autre application pour forcer un résultat de validation.
Si l'authentification réussit mais que la livraison est mauvaise, inspectez séparément la réponse, la réputation, le contenu et les autorisations d'envoi du destinataire. Le pass DMARC ne promet pas d’acceptation ou de placement dans la boîte de réception. Si aucun des deux chemins ne s’aligne, arrêtez l’expansion et corrigez la configuration réelle de l’expéditeur. N'affaiblissez pas la politique DMARC de l'ensemble du domaine pour masquer une seule défaillance de produit.
Remise et récupération
Enregistrez la différence DNS approuvée, les résultats de la recherche publique, l'état du service et la feuille de calcul des messages reçus expurgés avec un propriétaire nommé. Gardez les informations d’identification et les clés privées hors des tickets. En cas d'échec, suspendez la tâche d'envoi concernée ou utilisez un itinéraire précédemment testé sous le contrôle du propriétaire du service. Restaurer uniquement les enregistrements modifiés appartenant à cette intégration ; conserver les clés publiques nécessaires aux messages en vol. Retestez après une restauration, une rotation de clé, une migration de domaine ou un changement de relais sortant. Fermez la modification uniquement lorsque le propriétaire du produit et l'administrateur de messagerie peuvent expliquer la chaîne d'identité observée.
Confirmer la limite du fournisseur
L'illustration CNAME de la source est spécifique au domaine et ses métadonnées de produit incluent des espaces réservés inachevés pour d'autres produits Yotpo. Traitez uniquement les instructions explicites d'avis/de fidélité comme prises en charge ici. L'authentification de domaine délègue un rôle d'envoi ; cela n’établit pas qu’un auteur individuel est digne de confiance ou que chaque message est sûr.
Travailler sur un cas de diagnostic fictif
Cas écrit fictif uniquement : YO-01 suppose que Reviews a besoin reviews@shop.example mais s1._domainkey.shop.example délègue déjà à une autre application SendGrid approuvée. Aucun message Yotpo n'a été capturé, les résultats de l'enveloppe et DKIM sont donc inconnus. Le propriétaire des avis doit divulguer la collision au support, obtenir l'ensemble alternatif spécifique au domaine et conserver l'autre application avant de la tester. Un exemple de fidélité ou SendGrid sans rapport ne peut pas fermer cette route. Aucun locataire, DNS , commande de serveur ou message n'a été utilisé pour ce cas.
Séparez un message qui passe de la préparation à l'application
RFC 9989 La section 7.4 nécessite DKIM valide pour une publication de domaine p=reject et met en garde contre l'interopérabilité du courrier indirect. Un seul résultat SPF aligné ne justifie pas en soi le déploiement d’une politique de rejet. Examinez tous les itinéraires légitimes et la propriété des politiques séparément de la configuration de ce fournisseur.