Vignette: intégration externe (`externalEmbed`)
| Champ | Valeur |
|---|---|
| Identifiant de la tuile | externalEmbed |
| Libellé dans le tableau de bord | External embed / Einbettung |
| Catégorie | basic |
| Tailles | embedded |
La tuile d’intégration externe affiche directement un outil de réservation ou une autre page tierce dans une application web publiée. Les applications iOS et Android installées affichent la même iframe restreinte dans leur WebView Capacitor.
Données acceptées
Le tableau de bord accepte l’un des éléments suivants :
- Une URL HTTPS publique.
- Un balisage contenant une iframe avec un seul attribut
srcentre guillemets.
Seule l’URL normalisée de l’iframe est enregistrée. Scoutello ignore la largeur, la hauteur, les styles, les autorisations, les paramètres de sandbox, les gestionnaires d’événements, les scripts et tout le balisage environnant fourni par le prestataire. Les adresses HTTP, les identifiants d’authentification, les ports personnalisés, les adresses IP, les hôtes locaux ou internes, les hôtes contrôlés par Scoutello et le code d’iframe mal formé sont refusés. Scoutello n’accède pas à l’URL envoyée, ne la résout pas, ne crée pas de capture d’écran et n’effectue aucune autre vérification de celle-ci.
Le tableau de bord affiche un aperçu local de la configuration et ne contacte volontairement pas le prestataire. Testez le résultat réel dans l’application web publiée.
Chargement, confidentialité et autorisations
L’iframe se charge automatiquement et de manière différée lorsqu’elle s’approche de la zone visible. Le prestataire tiers peut donc être contacté avant toute interaction avec la tuile. Aucun mécanisme intégré de chargement sur clic ou de gestionnaire de consentement n’est disponible.
Avant l’enregistrement, l’organisation doit confirmer que le prestataire est digne de confiance et que les mentions de confidentialité ou la gestion du consentement nécessaires ont été traitées. Cette confirmation consigne une décision de configuration ; elle ne constitue pas un consentement de la part des visiteurs.
Les hauteurs sur mobile et ordinateur peuvent être définies entre 240 et 1 600 pixels. Les valeurs par défaut sont de 640 pixels sur mobile et de 720 pixels sur ordinateur. Les fonctionnalités de paiement et de plein écran du navigateur sont facultatives et désactivées par défaut. L’accès à la caméra, au microphone, à la géolocalisation, au presse-papiers et aux téléchargements, ainsi que la navigation de niveau supérieur, n’est jamais accordé.
L’environnement d’exécution utilise des paramètres de sandbox et de politique de référent contrôlés par le code. Les paramètres de sandbox ou les jetons d’autorisation fournis par les clients ne sont jamais transmis à l’iframe affichée. Consultez la spécification WHATWG des iframes pour connaître le fonctionnement de la sandbox du navigateur.
Limites d’intégration
Les prestataires peuvent interdire l’intégration au moyen d’une directive frame-ancestors de la Content Security Policy ou d’un en-tête X-Frame-Options. Comme les navigateurs ne fournissent pas d’informations interorigines fiables sur les échecs d’intégration, Scoutello ne peut pas vérifier la compatibilité dans le tableau de bord ni toujours distinguer un refus du prestataire d’une page vide fournie par celui-ci.
Si une configuration enregistrée devient invalide, l’expérience visiteur affiche un état d’erreur localisé et sécurisé et, lorsque cela est possible, propose une solution de secours pour ouvrir la page à l’extérieur.
Prestataires nécessitant des scripts
Les scripts arbitraires des prestataires ne peuvent pas s’exécuter dans une page Scoutello. L’envoi contenant uniquement un script est bloqué et propose l’option Demander une intégration du prestataire. La demande recueille le nom du prestataire, l’URL de sa documentation publique, le cas d’utilisation prévu et un exemple de script. Supprimez les secrets, les identifiants privés et les données personnelles avant l’envoi.
L’exemple de script est enregistré uniquement sous forme de texte dans la demande d’assistance ; il n’est jamais affiché ni exécuté. Son approbation ne débloque pas cet extrait. Elle déclenche un travail produit visant à créer un adaptateur de prestataire examiné, hébergé dans un document isolé sur une origine sans cookies et enregistrable séparément, avec une Content Security Policy propre au prestataire et une messagerie vérifiant l’origine. Cette approche suit les recommandations OWASP relatives aux scripts JavaScript tiers.
Liste de contrôle de l’assistance
- Vérifiez que l’adresse est une adresse HTTPS publique et qu’elle appartient au prestataire prévu.
- Vérifiez que le prestataire autorise l’intégration par iframe sur l’origine publiée.
- Activez le paiement ou le plein écran uniquement lorsque la documentation du prestataire l’exige.
- Vérifiez les mentions de confidentialité et le fonctionnement du consentement avant la publication.
- Utilisez la demande d’intégration du prestataire pour les widgets fonctionnant uniquement avec un script ; ne collez jamais de secrets.