Indlæsning af skoleelever er en on-premise Windows-service, der indlæser elever i OS2sofd. For hver institution læser den medlemmerne af en bestemt AD-sikkerhedsgruppe (typisk vedligeholdt via STIL/OS2skoledata), udtrækker elevens navn og CPR-nummer, og sender eleverne til OS2sofd. Dette dokument beskriver installation og konfiguration.
| Komponent | Servicenavn | Download | Ændringslog |
|---|---|---|---|
| Indlæsning af skoleelever | OS2sofd student dispatcher | Download |
Forudsætninger#
Windows Server#
Servicen skal installeres på en Windows maskine med:
- Netværksmæssig adgang til kommunens AD (læseadgang)
- Netværksmæssig adgang til SOFD Core i skyen via HTTPS
- .NET 6 runtime
AD-sikkerhedsgrupper pr. institution#
For hver institution skal der findes en AD-sikkerhedsgruppe, hvis medlemmer er institutionens elever. Disse grupper vedligeholdes typisk af STIL/OS2skoledata-integrationen. Servicen læser medlemmerne af grupperne og indlæser dem som elever i OS2sofd.
API-nøgle til SOFD Core backend#
Der skal bruges en API-nøgle til OS2sofd backend (udleveres af Digital Identity), så eleverne kan sendes til OS2sofd.
Afklaring af attributter#
Det skal afklares, hvilke AD-attributter der indeholder elevens fulde navn og CPR-nummer (typisk displayName og employeeNumber).
Installation af Windows Service#
Servicen installeres på en server med netværksmæssig adgang til kommunens AD samt til SOFD Core i skyen via HTTPS.
Download service#
Hent installeren via download-linket øverst på siden eller fra den samlede Download-oversigt.
Konfiguration af service#
Konfigurationen foretages i filen appsettings.json i roden af installationsmappen.
| Indstilling | Eksempel | Kommentar |
|---|---|---|
JobSettings.FullSyncCron | 0 30 7 ? * * * | Cron-udtryk for hvornår der synkroniseres. Bør ligge efter, at data er opdateret fra STIL. |
BackendSettings.BackendApiKey | (udleveres) | API-nøgle til OS2sofd backend. |
ActiveDirectorySettings.InstitutionStudentGroupMap | { "131313": "CN=131313_institution_elever,OU=os2skoledata,DC=kommune,DC=dk" } | Kort fra institutionsnummer til den AD-sikkerhedsgruppe, hvis medlemmer er institutionens elever. Der kan angives flere institutioner. |
ActiveDirectorySettings.FullNameField | displayName | AD-attributten, der indeholder elevens fulde navn. |
ActiveDirectorySettings.CprField | employeeNumber | AD-attributten, der indeholder elevens CPR-nummer. |
Serilog | Opsætning af logning (sti, niveau med videre). |
Start af service#
Efter konfiguration startes servicen via Windows Services eller tilsvarende kommandolinjeværktøjer. Servicen hedder OS2sofd student dispatcher.