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ètreValeur
Entity IDhttps://auth.syllabus.fr/saml/metadata
ACS URLhttps://auth.syllabus.fr/saml/acs
Attributs requismail, givenName, sn, eduPersonAffiliation
Redirect URI OIDChttps://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

À autoriserProtocoleUsage
syllabus.fr, *.syllabus.frHTTPS 443site, cours, API
vm.syllabus.frWSS 443 (WebSocketterminal et IDE
auth.syllabus.frHTTPS 443connexion 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é

SujetEngagement
HébergementScaleway, datacenters de Paris, France
RGPDAccord de sous-traitance art. 28, registre des traitements fourni
ConservationTraces d’activité 12 mois, notes jusqu’à fin de scolarité + 1 an
SauvegardesQuotidiennes, chiffrées, conservées 30 jours, second site en France
Disponibilité99,5 % par mois en période scolaire, maintenance hors cours
ChiffrementTLS 1.2+ en transit, AES-256 au repos
DPOdpo@syllabus.fr
Mentions légales →