Välj metod för att överföra användaruppgifter till Skolverket
Innan ni kan genomföra de nationella proven digitalt behöver ni föra över uppgifter om era användare till Skolverket. Det finns tre olika sätt att föra över användaruppgifterna på. Ni kan välja det sätt som passar er verksamhet bäst.
För att en användare ska kunna logga in i Skolverkets provplattform måste uppgifter om vem användaren är och vilken roll den har på skolan finnas i provplattformen före provgenomförandet. Det är huvudmannens ansvar att uppgifterna förs över till provtjänsten. Det kommer att kunna ske på tre sätt. Vilket sätt som blir aktuellt beror bland annat på hur många elever som finns i organisationen och organisationens tekniska förutsättningar.
Alternativ 1: Låt Skolverket hämta uppgifterna automatiskt via ett API
Detta alternativ innebär att ni samlar ihop relevanta uppgifter och tillgängliggör dem enligt datamodellen i standarden SS 12000. Då kan Skolverket automatiskt hämta data från er server. Genom en prenumeration kommer Skolverkets server att veta när det finns data att hämta. Skolverket tillämpar standarden SS 12000.
För att klienterna och servrarna ska kunna utbyta information behövs autentisering. Det kommer att ske via ömsesidig autentisering med mTLS (mutual Transport Layer Security) – en lösning som Skolverket har testat och arbetar med att färdigställa.
Diskussionsforum om SS 12000, eID i skolan (kräver inlogg)
Länk till annan webbplats.
Alternativ 2: Skicka uppgifterna till Skolverket automatiskt via ett API
Detta alternativ innebär att ni samlar ihop de uppgifter som Skolverket behöver och som sedan skickas från er klient till Skolverkets provisionerings-API (Application Program Interface).
De uppgifter som förs över till Skolverket ska följa datamodellen i standarden SS 12000. Skolverket validerar om uppgifterna har förts över på ett korrekt sätt utifrån datamodellen.
För att klienten och servern ska kunna utbyta information behövs autentisering. Det kommer att ske via ömsesidig autentisering med mTLS.
API-specifikation för Provisionerings-API, GitHub Länk till annan webbplats.
Alternativ 3: Ladda upp en Excel- eller CVS-filer manauellt
När uppgifter ska föras över till Skolverket, inför genomförande av bedömningsstöd och nationella prov, kommer manuell filinläsning kunna användas av er som saknar möjlighet att tillämpa maskinell överföring. Detta alternativ innebär att ni samlar ihop relevanta uppgifter i en fil som sedan läses in via ett manuellt gränssnitt som Skolverket kommer att tillhandahålla i god tid innan överföring ska ske.
De uppgifter som förs över till Skolverket ska följa datamodellen i standarden SS 12000. Skolverket validerar om uppgifterna har förts över på ett korrekt sätt utifrån datamodellen.
Filmallen anger de uppgifter som behövs för att genomföra provisionering via filinläsning. Några kompletterande attribut tillkommer under året.
Mall för överföring av uppgifter via filinläsning Version 0.8
Excel, 51 kB, öppnas i nytt fönster.
Standarden SS 12000
För att säkerställa att olika system kan fungera tillsammans och för att underlätta administrationen hos huvudmännen rekommenderar Skolverket standarden SS 12000.
Innan ni för över användaruppgifter
När ni har valt metod för att föra över uppgifter till Skolverket behöver ni se till att alla uppgifterna i Skolenhetsregistret är korrekta, att det står vem som är huvudman i Skolverkets huvudmannaregister samt att det finns en digital fullmakt för den som ska föra över uppgifterna.
Ange vem som är huvudman i Skolverkets huvudmannaregister
Om huvudmannen är en kommun eller XX behöver huvudmannen ange vem som är xx i Skolverkets huvudmannaregister för digitala nationella prov. Om huvudmannen är ett aktiebolag finns firmatecknare redan i Bolagsverkets register och Skolverket inhämtar uppgifter därifrån.
Skaffa en digital fullmakt via Mina Ombud hos Bolagsverket
XX för kommunala och xx skolhuvudmän samt firmatecknare för enskild huvudman behöver tilldela fullmakt i Bolagsverkets tjänst Mina Ombud till de personer som ska kunna använda Skolverkets e-tjänst administration provtjänsten.
Säkerställ att skolenhetsregistret är korrekt
För att elever på en skolenhet ska kunna genomföra proven hämtar Skolverkets provtjänst flera uppgifter från skolenhetsregistret och uppgifter måste vara korrekta.
Ny rubrik behöver läggas till
Uppgifter som behöver överföras till Skolverket
Om användaruppgifterna finns på olika ställen behöver ni sammanställa uppgifterna innan de förs över till Skolverkets provtjänst. Eftersom uppgifterna behöver uppdateras vid förändringar kommer överföringar av uppgifter att ske upprepade gånger.
Attributlista
För närvarande gäller attributlistan ”Attributlista för Skolverkets provisionerings-API” för alternativen provisionerings-API och provisionering enligt standarden SS 12000. Listan finns som pdf och i Excelformat. I attributlistan finns federationsanvändarnamn EPPN (eduPersonPrincipalName) som är en unik identifierare som kopplar en persons inloggning i skolan till en användare i provtjänsten.
Attributlista för Skolverkets provisionerings-API (uppdaterad den 3 juli 2023) Excel, 25 kB.
En del grundskolor, sameskolor och specialskolor grupperar ämnena biologi, fysik och kemi som NO (naturorienterande ämnen) samt historia, geografi, religion och samhällskunskap, som SO (samhällsorienterande ämnen) i sina skoladministrativa system. Dessa gruppbeteckningar kommer inte att godkännas när huvudmannen överför uppgifter om elevernas undervisningsgrupper till Skolverkets provtjänst. Det beror på att eleverna skriver prov i varje enskilt ämne. Eleverna behöver därför tillhöra undervisningsgrupper med rätt specifik ämneskod.
Om din skola använder gruppbeteckningarna NO och SO i dag behöver detta ändras i ert administrativa system. Ni behöver se till att alla elever i årskurs 6 och 9 i grundskolan och sameskolan samt årskurs 8 och 10 i specialskolan tillhör undervisningsgrupper med följande specifika ämneskoder.
Specifika ämneskoder för NO-ämnen:
- Biologi: GRGRBIO01
- Kemi: GRGRKEM01
- Fysik: GRGRFYS01
Specifika ämneskoder för SO-ämnen:
- Geografi: GRGRGEO01
- Historia: GRGRHIS01
- Religionskunskap: GRGRREL01
- Samhällskunskap: GRGRSAM01
Om ni skickar eller om Skolverket hämtar uppgifter från er via API behöver det administrativa systemet vara uppdaterat med de korrekta specifika ämneskoderna innan uppgifterna överförs till Skolverkets provtjänst. En bra tidpunkt för att uppdatera systemet kan vara under sommaren.
Om din skola överför användaruppgifter via fil behöver du ange vilka undervisningsgrupper och specifika ämneskoder som varje elev tillhör i den fil som ni laddar upp i Skolverkets e-tjänst Administration provtjänsten. E-tjänsten kommer att vara tillgänglig i god tid före provtillfällena.
Autentisering vid maskinell överföring
För att alla användaruppgifter ska överföras säkert till Skolverkets provtjänst används autentisering mellan servrar och klienter. Vi har tagit fram ett särskilt API som utfärdar en så kallad auktoriseringstoken till klienter efter autentisering.
Du som huvudman måste uppfylla ett av följande krav för att kunna överföra uppgifter till Skolverkets provtjänst:
- Ansluta dig till en TLS-federation som är ansluten till Fidus och se till att ert klientcertifikat är med i TLS-federationens metadataregister.
- Skaffa ett klientcertifikat från en certifikatutfärdare som är godkänd av Fidus. Detta utreds och mer information kommer under höstterminen 2023.
TLS-federation Länk till annan webbplats.
Oavsett vilket krav du väljer, måste klientcertifikatet ha en koppling till huvudmannens organisationsnummer. Varje huvudman måste alltså ha minst ett klientcertifikat.
Detaljerad teknisk beskrivning av autentisering, GitHub Länk till annan webbplats.
Uppgifterna ska föras över senast 30 dagar före provgenomförande
Fullständiga och korrekta användaruppgifter behöver vara tillgängliga för Skolverket i god tid före genomförandet av de första digitala nationella proven och bedömningsstöden. Uppgifterna ska ha förts över till Skolverket senast 30 dagar innan respektive prov eller bedömningsstöd ska genomföras. Detta ger Skolverket och huvudmännen tid att upptäcka och rätta till eventuella fel.
Om det finns särskilda skäl kan uppgifter om en enskild elev eller skolpersonal lämnas senare. Med särskilda skäl avses till exempel att en elev byter skola, att skolpersonal drabbas av sjukdom eller att något annat oväntat inträffar som skolan inte har kunnat förutse. Dessa förändringar kan ske senast sju kalenderdagar före provtillfället. Det finns dock inget hinder för att huvudmannen lämnar information samlat inför proven vid början av terminen eller en gång varje kalenderhalvår.
För kommunal vuxenutbildning på gymnasial nivå gäller samma riktlinjer som för övriga skolformer, med tillägget att uppgifter kommer att kunna överföras till Skolverket löpande under året.
Personuppgiftshantering i provtjänsten
I nuläget ansvarar Skolverket för personuppgiftshanteringen i provtjänsten för digitala nationella prov och bedömningsstöd. Det innebär att vi ansvarar för de personuppgifter som lämnas direkt till oss och som förs över till provtjänsten. När huvudmännen i sin tur får tillgång till uppgifterna i provtjänsten behöver Skolverket upprätta ett personuppgiftsbiträdesavtal med huvudmännen. Just nu utreder vi hur ett sådant upprättande ska kunna genomföras på ett effektivt sätt.
Skolverket håller även på att göra en konsekvensbedömning för hela provtjänsten och dess personuppgiftshantering. När konsekvensbedömningen är klar återkommer vi med mer detaljerad information om hur ansvarsfrågan av personuppgifter kommer att se ut inför digitala nationella prov. Vi planerar att vara klara med konsekvensbedömningen under hösten 2023.
Det kan behövas ytterligare verktyg och tjänster för att ansluta till och använda provtjänsten. Dessa har huvudmannen möjlighet att själv välja och använda på egen hand. Det kan till exempel handla om verktyg och tjänster för överföring av användaruppgifter (provisionering) samt inloggning och autentisering. För dessa verktyg och tjänster kan huvudmannen behöva ansvara för personuppgiftshanteringen, och personuppgiftsansvaret mellan huvudmannen och vald leverantör kommer behöva utredas från fall till fall. Huvudmannen kan även behöva göra en egen konsekvensbedömning av personuppgiftshanteringen innan sådana verktyg och tjänster börjar användas.
Webbinarium: Tekniska förutsättningar inför digitala nationella prov (tid: 40 min)
Filmen riktar sig till tekniskt ansvariga och tekniskt kunniga som arbetar med överföring av uppgifter och inloggning till Skolverkets provtjänst.
I det här webbinariet nämns årskurs 3. Observera att de nationella proven i årskurs 3 inte ska omfattas av digitaliseringen i nuläget. Läs mer om förändringen här