Dette er en beskrivelse av integrasjonen mellom Ladok (det svenske studentinformasjonssystemet, SIS) og Inspera Assessment. En forutsetning for å integrere disse to er bruk av AMQP1.0. Institusjonen kan velge å sette opp sin egen integrasjon eller, som de fleste gjør, benytte seg av Ladok-konsortiets "LIS-adapter".

Sette opp integrasjon mot LIS-adapteren f.o.m. 2023

Her beskriver vi dels hvordan vi etablerer kommunikasjon mellom deres Ladok-køer og Inspera, og dels hva som må gjøres for å få riktig informasjon.

Opprette kommunikasjon mellom Ladok og Inspera

Forskjellen fra tidligere prosess er at vi nå bruker toveis SSL for å opprette kommunikasjonen mellom Ladok og Inspera. Informasjonen vi trenger er:

• insperaReadQueue
  • for eksempel: /topic/lis.uu::inspera.lis.uu
• insperaWriteQueue
  • for eksempel: /topic/inspera.uu
• ladokQueueDomain
  • for eksempel: lis.test.ladok.se
• ladokQueuePort
  • vanligvis port 5671

Med denne informasjonen setter vi opp et sertifikat som vi returnerer til den som utførte bestillingen. 

For at kommunikasjonen skal kunne opprettes, må brannmuren deres åpnes for Inspera Assessment sine IP-adresser (innkommende trafikk).

For en oversikt over utgående IP-adresser, se List of DNS names and IP addresses

Oppdatering vil være nødvendig siden disse kan endres i fremtiden. Kontakt Service Desk dersom integrasjonen slutter å fungere.

Håndtere studentinformasjon

For å få Ladok-informasjonen tilgjengelig i Inspera må institusjonen sikre at riktig informasjon sendes til Inspera.

1. Institusjonen må sikre at SSO sender med Ladok StudentUID ved innlogging 
2. Hvis dere har brukt Inspera tidligere og har studentbrukere, må disse mappes mot en Ladok StudentUID for å kunne se både gamle og fremtidige prøver. Les mer om dette i avsnittet om å mappe eksisterende studenter. 
3. Inspera oppdaterer studentinnlogging for å bruke LadokId
4. Inspera slår på integrasjonen

Opprette eksamensansvarlig i Inspera Assessment

For at en prøve som er opprettet via integrasjonen skal bli synlig i IA, kreves det at en admin/eksamensansvarlig er koblet til prøven. Dette er rett og slett en standardbruker hvis bruker-ID brukes for alle Ladok-prøver som kommer fra deres køer. Opprett en bruker i modulen Brukeradministrasjon

1. Opprett en "Ladokintegrasjons"-bruker via Brukeradministrasjon

   

2. Brukeren må ha minst Admin-rollen. 

3. Kopier UserID for denne brukeren (bruk URL-lenken) og send den til Inspera.

   

Dette innebærer at alle prøver som opprettes via denne integrasjonen, får denne brukeren som eier. Alle administratorer med utvidet tilgang kan se disse prøvene og kan legge til medarbeidere/organisasjon på dem. 

Overføring av medarbeidere, som sensorer og eksamensvakter, er IKKE en del av integrasjonen.

Legge til aktivitetstype-oppretter på prøven i Inspera

Hvis det ofte er samme person som jobber med eksamensadministrasjon både i Ladok og i Inspera, kan det være hensiktsmessig å aktivere funksjonen som legger til den som opprettet aktivitetstilfellet i Ladok på prøven i Inspera med rollen Admin. 

Når en bruker setter opp et nytt aktivitetstilfelle med typen "Digital tentamen (LIS)" eller "Digital Omtentamen (LIS)" i Ladok, er en av meldingene som sendes til Inspera:

education.activityoccasion.createdby

Denne meldingen inneholder blant annet følgende informasjon:

<ns0:extensionField>
<ns0:fieldName>education.activityoccasion.createdby</ns0:fieldName>
<ns0:fieldType>string</ns0:fieldType>
<ns0:fieldValue>institusjons-ID@larosate.se</ns0:fieldValue>
</ns0:extensionField>

Denne verdien, institusjons-ID@larosate.se, tilsvarer EPPN og leses av Inspera. Når verdien kan matches mot en brukerprofil i Inspera og den brukeren har rollen Admin, legges vedkommende til som Admin på den innkommende prøven. Hvis verdien ikke finnes eller hvis brukeren ikke har rollen Admin, legges i stedet "eksamensansvarlig" til som Admin.

Det er opp til institusjonen å sikre at brukeren har "riktige" verdier på sine profiler. I Inspera kan dere finne verdien for brukeren i modulen Brukeradministrasjon 

Legge til organisasjon/enhet på prøven i Inspera

Hvis institusjonen bruker enheter for å distribuere eksamenstilfeller i Inspera, kan disse legges til automatisk ved hjelp av informasjon fra Ladok.

Forutsetninger:

• Organisasjonsstrukturen som skal brukes må være nøyaktig den samme i Inspera og i Ladok 
• Verdien på externalId på organisasjonsenheten i Inspera må være nøyaktig den samme som verdien på organisasjonen som sendes fra Ladok

Når informasjon om en ny prøve kommer til Inspera, leses informasjonen om organisasjonsenhet inn og verdien populerer prøvens side for innstillinger. Du kan lese mer i artikkelen om å tildele eksamens- eller prøvetilfeller til organisasjonsenhet om hva funksjonen gjør. 

Alternativer for aktivitetstilfeller

Når en institusjon velger å aktivere denne funksjonen i Ladok, vil de ulike alternativene opprettes som separate eksamenstilfeller i Inspera. Så hvis det for eksempel er to (2) alternativer i Ladok, vil det finnes to (2) eksamenstilfeller i Inspera. 

Mappe eksisterende studenter

I de tilfeller der dere har studentkontoer i Inspera med eksamenshistorikk som dere ønsker at de fortsatt skal ha tilgang til, vil dere trolig måtte oppdatere studentenes kontoer med Ladok StudentUID. Dette gjelder med mindre dere har sendt med dette i SSO-innloggingen allerede før overgang til Ladok-integrasjonen. 

Vår anbefalte prosess for å håndtere eksisterende studenter og deres historikk er følgende:

1. Institusjonen setter opp og begynner å sende med Ladok StudentUID i deres SAML-assertion. Dere kan lese mer om dette i Sunets dokumentasjon om Ladok StudentUID. 
2. Institusjonen melder fra til Inspera om hvilket attributt dere sender Ladok StudentUID i (vanligvis LIN) og hvilket prefiks dere bruker for Ladok StudentUID (eller om dere ikke bruker prefiks). 
   Steg 3-5 kan enten utføres av dere selv, eller dere kan kontakte Inspera Service Desk for å få hjelp til å oppdatere studentenes kontoer i Inspera
3. Gjør en eksport av "studentkontoer" med tilhørende SSO-ID (POST /v1/fileExport/ med resourceType "allUsers"). 
4. Mappe eksisterende SSO-ID med Ladok StudentUID. Hvis dere ønsker at Inspera skal hjelpe dere med å oppdatere studentkontoene, opprett en liste, helst en CSV-fil med formatet SSO-ID, Ladok StudentUID. 
5. Oppdatere studentkontoer i Inspera med Ladok StudentUID 
6. Inspera oppdaterer deres SSO-oppsett på Inspera sin side slik at vi bruker Ladok StudentUID som identifikator i stedet for tidligere verdi  

Tidligere prosess (før 2023)

For å kunne koble sammen LIS-adapter og Inspera Assessment, må du som kunde sende følgende informasjon til Inspera: 

• Endpoint (host + part)
• Queue name
• Username
• Password

Merk: Dere som kunde må sende informasjon for både lesekø reading queue (hvorfra IA henter prøveinformasjon) og skrivekø writing queue (for resultatoverføring).