Intégration Confluence
Intégrez vos graphiques Embases directement dans vos pages Confluence via la macro iFrame. Compatible Confluence Cloud et Confluence Data Center / Server.
Confluence Cloud
Sur Confluence Cloud, la macro iFrame est disponible nativement sans aucune configuration administrateur préalable. Commencez par ouvrir la page Confluence où vous souhaitez intégrer le graphique. Cliquez sur le bouton « Modifier » (icône crayon en haut à droite de la page), ou appuyez sur la touche E depuis la vue de la page pour passer directement en mode édition.
Une fois en mode édition, placez votre curseur à l'endroit exact où le graphique doit apparaître dans le contenu de la page. Tapez le caractère / (barre oblique) pour ouvrir le menu de macros : une liste déroulante de suggestions apparaît immédiatement. Commencez à taper « iFrame » dans ce menu — la macro apparaît dans la liste après deux ou trois caractères. Cliquez sur « iFrame » pour la sélectionner.
Un panneau de configuration s'ouvre sur le côté droit de l'écran. Dans le champ « URL », collez l'URL complète de votre embed Embases (format : https://embases.com/e/VOTRE_TOKEN). Dans le champ « Height », entrez 420 (valeur recommandée en pixels). Laissez le champ « Width » à 100% pour que le graphique s'adapte à la largeur de la colonne Confluence. Cliquez sur « Insérer » puis sur « Publier » en haut à droite pour enregistrer la page et rendre l'embed visible.
URL : https://embases.com/e/VOTRE_EMBED_ID
Height : 420
Width : 100%Astuce : Pour un embed privé, copiez l'URL tokenisée depuis votre dashboard Embases (elle inclut le paramètre ?key=...) et collez-la dans le champ URL de la macro.
Confluence Data Center / Server
Sur Confluence Data Center et Confluence Server, un administrateur Confluence doit obligatoirement ajouter le domaine Embases à la liste d'autorisation (allowlist) avant que la macro iFrame puisse charger du contenu externe. Sans cette étape préalable, la macro affiche un message d'erreur indiquant « URL not in allowlist » et le graphique ne se charge pas.
Pour effectuer cette configuration, connectez-vous à Confluence avec un compte administrateur. Dans le menu supérieur, accédez à l'icône en forme d'engrenage (Settings) → « General Configuration » dans le menu de gauche → puis cliquez sur « Allowlist » dans la section Security. Sur la page Allowlist, cliquez sur le bouton « Add » ou « Ajouter ». Dans le champ de saisie, entrez https://embases.com. Assurez-vous que le type sélectionné est « URL prefix » (et non « Expression régulière ») afin que tous les sous-chemins du domaine Embases soient autorisés. Cochez la case « Allow Outgoing » si elle est disponible, puis cliquez sur « Save ».
Le domaine embases.com apparaît désormais dans la liste des domaines autorisés. Les pages Confluence pourront maintenant charger les iFrames pointant vers Embases.
# Chemin admin
Administration → General Configuration → Allowlist
# Valeur à ajouter
https://embases.comInsérer la macro (Data Center / Server)
Une fois que l'administrateur a autorisé le domaine Embases dans l'allowlist, vous pouvez insérer la macro iFrame de la même façon que sur Cloud. Ouvrez la page Confluence en mode édition (bouton « Modifier » ou touche E). Placez votre curseur à l'endroit souhaité dans la page.
Pour insérer une macro sur Confluence Server, cliquez sur le bouton « + » dans la barre d'outils de l'éditeur, puis sélectionnez « Autres macros » dans le menu déroulant. Une fenêtre de recherche de macros s'ouvre. Dans la barre de recherche en haut de cette fenêtre, tapez « iframe » — la macro « iFrame » apparaît dans les résultats. Cliquez dessus pour la sélectionner.
Le panneau de paramètres de la macro s'affiche sur la droite de la fenêtre. Renseignez les champs suivants : URL (collez l'URL de votre embed Embases), Height (entrez 420), Width (laissez 100% ou entrez une valeur en pixels selon votre mise en page). Les champs Frameborder et Scrolling peuvent rester à leurs valeurs par défaut. Cliquez sur « Insérer » pour valider. Le graphique apparaît en aperçu dans l'éditeur. Cliquez sur « Enregistrer » ou « Publier » pour finaliser.
Astuce : Si la macro iFrame n'apparaît pas dans la liste, elle peut être désactivée. L'admin peut l'activer depuis Administration → Manage Macros.
Embeds restreints (Domain Whitelisting)
Si vous avez activé le Domain Whitelisting sur votre embed dans Embases, seuls les domaines que vous avez explicitement autorisés peuvent charger l'iFrame. Confluence charge votre page depuis le domaine de votre instance Confluence : par exemple monentreprise.atlassian.net pour Confluence Cloud, ou l'URL interne de votre serveur pour Confluence Data Center.
Pour configurer cette autorisation, connectez-vous à votre dashboard Embases, puis accédez aux paramètres de l'embed concerné (bouton Paramètres ou icône engrenage à côté de l'embed). Dans la section « Sécurité » → « Domaines autorisés », cliquez sur « Ajouter un domaine » et entrez le domaine de votre instance Confluence sans le protocole (ex : monentreprise.atlassian.net). Cliquez sur « Enregistrer ». Attendez quelques secondes puis rechargez la page Confluence — le graphique doit maintenant s'afficher.
Si l'embed reste invisible après cette configuration, vérifiez que le domaine saisi dans Embases correspond exactement à celui visible dans la barre d'adresse de votre navigateur quand vous consultez Confluence. Toute différence (www. en plus ou en moins, http vs https) empêche le chargement.
Astuce : Pour trouver votre domaine Confluence, regardez l'URL dans votre navigateur quand vous êtes sur Confluence : c'est la partie avant /wiki/ ou /pages/.