Documentation technique
Pour les profs
Intégration et sécurité
Ce qu’il faut savoir pour raccorder Syllabus au système d’information de l’établissement.
Authentification unique (SSO
Protocoles pris en charge : SAML 2.0 (Shibboleth, ADFS, fédération Renater), OpenID Connect (Entra ID, Google Workspace, Keycloak), CAS (ENT). EduConnect pour les élèves du secondaire via l’ENT de l’académie.
| Paramètre | Valeur |
|---|---|
| Entity ID | https://auth.syllabus.fr/saml/metadata |
| ACS URL | https://auth.syllabus.fr/saml/acs |
| Attributs requis | mail, givenName, sn, eduPersonAffiliation |
| Redirect URI OIDC | https://auth.syllabus.fr/oidc/callback |
Création et suppression des comptes
Import CSV
Classes et étudiants, depuis l’export de votre logiciel de scolarité
Juste à temps (JIT
Compte créé à la première connexion SSO, rattaché selon l’affiliation
SCIM 2.0
Synchronisation automatique depuis Entra ID ou Keycloak
LDAP / Active Directory
Synchronisation planifiée des groupes en lecture seule
Suppression
Compte désactivé à la fin de licence, données effacées après 12 mois
API REST
API REST en JSON, documentée au format OpenAPI 3.1. Authentification par jeton porteur, une clé par établissement avec des droits limités (lecture des notes, gestion des comptes). Limite : 600 requêtes par minute. Webhooks signés (HMAC-SHA256) pour les événements devoir rendu, examen terminé, alerte ouverte.
curl -H "Authorization: Bearer $PAILLASSE_TOKEN" \ https://api.syllabus.fr/v1/classes/bts-sio-1a/notes?format=csv
Prérequis réseau et postes
| À autoriser | Protocole | Usage |
|---|---|---|
| syllabus.fr, *.syllabus.fr | HTTPS 443 | site, cours, API |
| vm.syllabus.fr | WSS 443 (WebSocket | terminal et IDE |
| auth.syllabus.fr | HTTPS 443 | connexion SSO |
Aucun port autre que 443, aucun logiciel à installer. Le proxy doit laisser passer les connexions WebSocket (en-tête Upgrade) et ne pas couper les sessions inactives avant 10 minutes. Navigateurs : Firefox, Chrome, Edge et Safari des deux dernières versions majeures. Débit : environ 50 kbit/s par terminal, 300 kbit/s par IDE.
Isolation des environnements
- ■Une VM KVM dédiée par étudiant et par séance, jamais partagée
- ■Trafic entre VM d’étudiants bloqué, y compris dans une même classe
- ■Sortie Internet filtrée : fermée par défaut, liste blanche de dépôts (Debian, PyPI, npm) activable par le prof
- ■VM détruite en fin de séance ; seul le dossier de travail est conservé, chiffré
- ■Quotas CPU, mémoire et disque par VM ; arrêt automatique après 30 min d’inactivité
- ■Commandes et connexions journalisées, consultables par le prof et la DSI
Conformité et continuité
| Sujet | Engagement |
|---|---|
| Hébergement | Scaleway, datacenters de Paris, France |
| RGPD | Accord de sous-traitance art. 28, registre des traitements fourni |
| Conservation | Traces d’activité 12 mois, notes jusqu’à fin de scolarité + 1 an |
| Sauvegardes | Quotidiennes, chiffrées, conservées 30 jours, second site en France |
| Disponibilité | 99,5 % par mois en période scolaire, maintenance hors cours |
| Chiffrement | TLS 1.2+ en transit, AES-256 au repos |
| DPO | dpo@syllabus.fr |