Guide des enseignants et des référents
Comment déposer une appli HTML, lire son rapport de sécurité et la mettre en ligne pour vos élèves.
En bref
Athéna Forge permet à un enseignant de mettre en ligne une appli HTML qu'il a créée, après une analyse de sécurité automatique et la validation d'un référent.
| Quoi | Adresse |
|---|---|
| La forge (dépôt, rapports, publication) | forge.moncollege-valdoise.eu |
| Une appli publiée | nom-du-depot.apps.moncollege-valdoise.eu |
| Rôle | Ce qu'il fait |
|---|---|
| Enseignant | Crée un dépôt, y dépose son fichier HTML, corrige si le rapport est rouge |
| Référent | Relit le rapport et publie l'appli en créant une version |
| Administrateur | Active les comptes et les place dans la bonne équipe |
L'enseignant ne peut pas publier lui-même : seuls les membres de l'équipe referents le peuvent, administrateur compris.
Enseignant : déposer son appli
Avoir un compte
Inscrivez-vous sur la forge avec votre adresse académique (@ac-versailles.fr, @valdoise.fr ou @moncollege-valdoise.fr). Aucun e-mail de confirmation n'arrive : prévenez votre référent, qui fait activer le compte et vous ajoute à l'équipe enseignants.
Créer le dépôt
- Cliquez sur + en haut à droite, puis sur Nouveau dépôt.
- Dans Propriétaire, choisissez applis, pas votre nom.
- Un dépôt créé à votre nom n'est jamais analysé ni publié, sans aucun message d'erreur.
- Si applis n'apparaît pas, vous n'êtes pas encore dans l'équipe enseignants.
- Donnez un nom court : il devient l'adresse de l'appli.
Quiz Fractionsdonneraquiz-fractions.apps.moncollege-valdoise.eu. - Cliquez sur Créer le dépôt.
Déposer le fichier
- Dans le dépôt, cliquez sur Ajouter un fichier, puis Téléverser un fichier.
- Glissez votre fichier HTML. Son nom n'a pas d'importance s'il est seul ; s'il y en a plusieurs, la page d'accueil doit s'appeler
index.html. - Ajoutez les images, sons ou polices utilisés par l'appli, si elle en a.
- Cliquez sur Valider les modifications.
Moins d'une minute plus tard, le rapport de sécurité est disponible.
Enseignant : lire le rapport
Le rapport se trouve dans l'onglet Tickets du dépôt, dans le ticket « Rapport de sécurité Athéna Forge ». Un nouveau commentaire s'ajoute à chaque dépôt de fichier.
| Verdict | Ce que ça veut dire | Que faire |
|---|---|---|
| Vert | Aucun problème détecté | Prévenir le référent |
| Orange | Points à vérifier, publication possible | Prévenir le référent, qui les relira |
| Rouge | Publication bloquée | Corriger le fichier et le déposer à nouveau |
Problèmes courants et corrections
| Message du rapport | Correction |
|---|---|
| Clé OpenAI, Anthropic, Google… trouvée | Retirer la clé du code. Une appli publiée ne doit jamais contenir de clé d'API : n'importe qui pourrait la lire et l'utiliser. |
| Traceur (Google Analytics, Facebook…) | Supprimer le script de suivi. |
| Formulaire envoyé vers un autre site | Garder les réponses dans le navigateur, ou proposer un export de fichier. |
| Requête vers un domaine non autorisé | L'appli appelle un service extérieur. Demander au référent si ce domaine peut être autorisé. |
| Type de fichier interdit (.php, .py…) | Seules les pages statiques sont acceptées : HTML, JS, CSS, images, sons, polices. |
| Pas de fichier index.html | Renommer la page d'accueil en index.html quand il y a plusieurs fichiers HTML. |
| innerHTML, eval… (orange) | Pas bloquant. Le référent vérifie que l'appli n'affiche pas du texte saisi sans le filtrer. |
Astuce : vous pouvez coller le rapport dans l'IA qui a généré votre appli en lui demandant de corriger ces points.
Référent : relire et publier
Relire
Ouvrez le dépôt, puis le ticket « Rapport de sécurité Athéna Forge » dans l'onglet Tickets. Sur un rapport orange, ouvrez l'appli et vérifiez les points signalés. Sur un rapport rouge, rien ne peut être publié : renvoyez l'enseignant vers les corrections.
Publier
- Dans le dépôt, ouvrez l'onglet Publications.
- Cliquez sur Nouvelle publication.
- Saisissez une étiquette :
v1pour la première, puisv2,v3… - Cliquez sur Publier.
La forge refait l'analyse, puis met l'appli en ligne si le rapport n'est pas rouge. Un commentaire du ticket donne l'adresse de l'appli, à transmettre à l'enseignant.
Mettre à jour
L'enseignant dépose sa nouvelle version, puis vous créez une nouvelle publication (v2…). Tant que ce n'est pas fait, les élèves continuent de voir l'ancienne version.
Publication refusée ?
Le ticket en donne la raison. Les cas habituels :
- vous n'êtes pas dans l'équipe referents ;
- le rapport est devenu rouge.
Une publication refusée n'est pas reprise automatiquement : créez-en une nouvelle avec une autre étiquette.
Retirer une appli
Ce n'est pas encore possible depuis la forge : demandez à l'administrateur.
Administrateur : comptes et réglages
Activer un compte
La forge n'envoie aucun e-mail.
- Connecté en
admin-forge, ouvrez Administration → Comptes utilisateurs. - Cliquez sur le crayon à côté du compte, cochez Ce compte est activé, puis enregistrez.
Placer le compte dans une équipe
- Ouvrez les équipes de l'organisation applis.
- Choisissez enseignants (déposer des applis) ou referents (publier).
- Dans Ajouter un membre, saisissez l'identifiant de la personne.
Les deux étapes sont nécessaires : un compte activé mais hors équipe ne peut pas choisir applis comme propriétaire de dépôt.
Autoriser un domaine externe
Une appli qui appelle une API publique (météo, open data) est bloquée tant que son domaine n'est pas autorisé. Pour l'autoriser :
- Ajoutez le domaine dans
allowlist.txtdu dossierathena-forge. - Lancez
./deploy.sh.
Cette liste vaut pour l'analyse et pour toutes les applis publiées. N'y ajoutez que des services publics, sans compte et sans traceur.
Retirer une appli
Supprimez le dossier /var/www/forge-apps/<nom> sur le serveur.
Charte
En déposant une appli, l'enseignant s'engage à respecter ces règles :
- aucune donnée personnelle d'élève n'est envoyée hors du navigateur (nom, résultats, photos) ;
- aucun traceur ni outil de mesure d'audience ;
- aucune clé d'API, aucun mot de passe dans le code ;
- aucun contenu inadapté à des collégiens ;
- uniquement des contenus dont il a le droit d'usage (images, sons, textes).
Les applis sont isolées : chacune a sa propre adresse et ne peut contacter que les domaines autorisés. Les données saisies par un élève restent dans son navigateur.
Questions fréquentes
- Je ne vois pas « applis » dans Propriétaire.
- Votre compte n'est pas encore dans l'équipe enseignants. Demandez à l'administrateur.
- J'ai déposé mon fichier mais il n'y a pas de rapport.
- Le dépôt a sans doute été créé à votre nom. Recréez-le avec applis comme propriétaire.
- Mon appli fonctionnait sur mon ordinateur mais pas une fois publiée.
- Elle charge probablement une ressource depuis un domaine non autorisé (police, script, API). Le rapport le signale ; voyez avec le référent.
- Les élèves perdent leurs résultats.
- Une appli publiée n'a pas de serveur pour enregistrer des données. Les résultats restent dans le navigateur de l'élève et disparaissent si on change d'appareil ou si on efface l'historique. Pour les conserver, prévoyez un export en fichier.
- Puis-je modifier l'appli d'un collègue ?
- Ne le faites pas : travaillez toujours dans votre propre dépôt. Pour repartir de son appli, téléchargez son fichier et déposez-le dans un nouveau dépôt.