OS2sofd

- Om OS2sofd: https://www.sofd.io/
- Brugervejledning: https://www.sofd.io/brugervejledning/
- Arkitektur: https://www.sofd.io/arkitektur/
- Implementeringsdrejebøger: https://www.sofd.io/implementation-guides/
- Drejebog: OPUS-kommune: https://www.sofd.io/implementation-guides/opus-loen-integration/
- Drejebog: SD-kommune: https://www.sofd.io/implementation-guides/sd-loen-integration/
- Brugerstyring: https://www.sofd.io/idm/
- Forudsætninger og forberedelse: https://www.sofd.io/idm/prerequisites/
- Processer og hændelser: https://www.sofd.io/idm/processes/
- Personinaktivering: https://www.sofd.io/idm/person-inactivation/
- Konfiguration: https://www.sofd.io/idm/configuration/
- Login og SAML: https://www.sofd.io/login/
- API: https://www.sofd.io/api/
- OData (læsning): https://www.sofd.io/api/odata/
- REST-API: https://www.sofd.io/api/rest/
- Fremtidig API-udvikling: https://www.sofd.io/api/strategi/
- Integrationer: https://www.sofd.io/integrationer/
- On-premise agenter: https://www.sofd.io/agents/
- Brugerkonto Agent: https://www.sofd.io/agents/user-account-agent/
- AD Writeback Agent: https://www.sofd.io/agents/ad-writeback-agent/
- AD Replikator Agent: https://www.sofd.io/agents/ad-replikator/
- AD indlæsningsintegration: https://www.sofd.io/agents/ad-indlaesningsintegration/
- OPUS indlæsningsintegration: https://www.sofd.io/agents/opus-indlaesningsintegration/
- Indlæsning af skoleelever: https://www.sofd.io/agents/skoleelev-indlaesning/
- OS2vikar - Brugerkonto Agent: https://www.sofd.io/agents/os2vikar-agent/
- Download: https://www.sofd.io/downloads/
- Ændringslog: https://www.sofd.io/changelog/
- Support og kontakt: https://www.sofd.io/support/


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](https://www.sofd.io/download/OS2sofd%20student%20dispatcher.exe) |  |

## 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](../../downloads/).

### 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`.