Accès réseau et pare-feu

Cette page s'adresse à l'équipe informatique qui ouvre Maketools sur le réseau de l'entreprise : proxy, pare-feu, filtrage d'URL, navigateurs gérés et LMS.

Les adresses à autoriser

Tout passe en HTTPS (port 443). Autorisez ces deux adresses, ou simplement *.maketools.ai :

Pourquoi deux adresses. Les jeux s'exécutent dans un cadre isolé (sandbox), servi par une adresse distincte du site, qui ne pose aucun cookie et n'est reliée à aucune API : un jeu ne peut ni lire la session du joueur, ni appeler l'API, ni modifier l'interface (voir le trust center). Si play.maketools.ai est bloqué, le site s'ouvre mais le jeu ne se charge pas.

Si votre proxy inspecte le trafic chiffré, il doit laisser passer sans les modifier les en-têtes de sécurité des réponses (Content-Security-Policy en particulier) : le cadre du jeu ne s'exécute qu'avec eux.

Ce que Maketools ne charge pas

Aucun script, police ni traceur d'un tiers : les polices sont servies par Maketools, et la politique de sécurité du site refuse tout script venu d'ailleurs. D'autres adresses ne servent que si vous utilisez la fonction correspondante :

Les emails (codes de connexion, invitations, notifications) partent d'une adresse d'un sous-domaine de maketools.ai : si votre filtre de messagerie fonctionne par liste blanche, autorisez les expéditeurs de *.maketools.ai.

Cookies et stockage

Le site ne pose que des cookies strictement nécessaires, propres à maketools.ai (session, sécurité de la connexion), et garde dans le navigateur quelques préférences (langue, thème, organisation choisie). Les jeux, servis par play.maketools.ai, ne posent aucun cookie et n'écrivent rien dans le navigateur. Le détail est dans la politique de confidentialité.

Un jeu affiché dans la page d'un LMS utilise en plus un cookie partitionné, rangé par le navigateur sous le site du LMS : c'est lui qui évite à l'apprenant de se reconnecter à chaque lancement. Une politique de navigateur qui refuse les cookies partitionnés empêche ce mode ; le mode « nouvelle fenêtre » reste alors possible (voir l'intégration LMS).

Fenêtres surgissantes

Autorisez les fenêtres surgissantes pour votre LMS : la connexion d'un apprenant à un jeu affiché dans le LMS se fait dans une petite fenêtre du site, et un paquet en mode fenêtre ouvre le jeu dans une fenêtre à part.

Jeux affichés dans votre LMS

• Déclarez dans Maketools chaque adresse de votre LMS qui affiche le jeu (l'interface du LMS et, si elle est différente, l'adresse qui sert le contenu SCORM) : partout ailleurs, la page de jeu refuse d'être affichée en cadre.
• Si le LMS isole le contenu SCORM dans un cadre sandbox, ce cadre garde allow-scripts, allow-same-origin, allow-popups et allow-popups-to-escape-sandbox, et délègue allow="autoplay; fullscreen" pour le plein écran.

Le pas à pas est dans l'intégration LMS.

Appels de Maketools vers vos systèmes

Deux fonctions font appeler vos serveurs par ceux de Maketools :

• le SSO OpenID Connect (échange du code de connexion, clés de signature) ;
• le connecteur xAPI (envoi des statements à votre LRS).

Les serveurs de Maketools n'ont pas d'adresse IP fixe : un fournisseur d'identité ou un LRS hébergé chez vous qui n'accepte que des adresses autorisées refusera ces appels. Pour la connexion, choisissez alors SAML, qui passe par le navigateur de l'utilisateur et n'appelle jamais votre fournisseur (voir SSO). Pour xAPI, le LRS doit être joignable depuis Internet en HTTPS. Les services en ligne (Entra ID, Okta, Google Workspace, LRS hébergés) ne sont pas concernés.

Navigateurs

Maketools fonctionne dans les versions récentes de Chrome, Edge, Firefox et Safari, sur ordinateur et sur téléphone, avec JavaScript activé. Pour un jeu affiché dans un LMS, voir les navigateurs vérifiés.

Liste de contrôle

• maketools.ai et play.maketools.ai (ou *.maketools.ai) autorisés en HTTPS
• En-têtes de sécurité non modifiés par le proxy
• Fenêtres surgissantes autorisées pour le LMS
• Cookies partitionnés acceptés par les navigateurs gérés (mode intégré dans le LMS)
• Adresses du LMS déclarées dans Maketools (Statistiques › Connecteur LMS)
• Expéditeurs *.maketools.ai acceptés par la messagerie
• SSO en SAML si votre fournisseur d'identité filtre les adresses IP