Page Comparison

...

Dette er et proxy-api som i hovedsak gjenspeiler DigEks API’et fra FS.
https://www.fellesstudentsystem.no/brukersider/teknisk/fsws-dok/rest/digitaleksamen.html#digeks_liste Hoved funksjonen er er at den bygger en Authentiisering og authorisasjonslag

Dokumentasjonen til dette API’et er å finne her : https://api-sikt.intark.uh-it.no/catalog/api/81ecdc41-73ed-48c4-acdc-4173ed88c4e9?q=digex

Hoved funksjonen er er at den bygger en Authentiisering og authorisasjonslag på toppen av den eksisterende API’et fra FS.
Brukeren av dette API’et er eksamensystemer.

Nøkkel info

...

• Eksamensystem X skal kunne utføre en av disse operasjoneroperasjonene:

  • Hent liste av eksamener

  • Hent info for en eksamen

  • Registrere sensur for en eksamen

  • Testregistrere sensur for en eksamen

  • Registrere oppmøte for en eksamen

  • Hent begrunnelser for eksamen

  • Registrere begrunnelse gitt til en kandidat for en eksamen

  • Hent klager for eksamen

  • Registrere et vedtak for klagesensur (Registrere et vedtak for eksamen)

  • Registrere gruppeid for kandidater

  • Hent eksamener filtrert på hjelpemiddel

  • Hent klager endret siden tidspunkt

  • Hent begrunnelsesforespørsler endret siden tidspunkt

...

Tilgangsstyring og logging

• Integrasjonen loger til Humio med detaljert logging av prosessen.

• Integrasjonen er knyttet logg-oversikten som vil logge følgende data:

  • errorMessage (tekst)

  • host

  • httpStatus

  • institusjonsId

  • method

  • orgId

  • orginal_user

  • remote_address

  • request_uri_inn

  • success (boolsk)

  • tjeneste

  • user

  • vurdId (examID)

• Tilgangstyringen (autentisering via API-keys) skjer via Gravitee. Authorisasjonen håndteres via Auth-modulen vår.

Forretningsregler

Behandlingstid/responstid og volum

• Behandlingstid/responstid: ca. 1ms

• Frekvens: HTTPS-‘listener’ repeterbar fillagerstrøm for datastrømmestrategi

• Volum (målt: 27 Jul 2022 ): gj.sn. ca. 66k hits daglig

Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse

...

/eksamen/liste
/eksamen/<system>/<ID>
/eksamen/sensur/<system>/registrer
/eksamen/sensur/<system>/valider
/eksamen/oppmote/<system>/registrer
/eksamen/begrunnelser/<SYSTEM>/<ID>
/eksamen/begrunnelser/<SYSTEM>
/eksamen/klager/<SYSTEM>/<ID>
/eksamen/vedtak/<SYSTEM>
/eksamen/gruppeid/<SYSTEM>/registrer
/eksamen/hjelpemiddel
/eksamen/klager/<SYSTEM>
/eksamen/begrunnelse/<SYSTEM>

Tilgangsstyring og logging

• Integrasjonen loger til Humio med detaljert logging av prosessen.

• Integrasjonen er knyttet logg-oversikten som vil logge følgende data:

  • errorMessage (tekst)

  • host

  • httpStatus

  • institusjonsId

  • method

  • orgId

  • orginal_user

  • remote_address

  • request_uri_inn

  • success (boolsk)

  • tjeneste

  • user

  • vurdId (examID)

• Tilgangstyringen (autentisering via API-keys) skjer via Gravitee. Authorisasjonen håndteres via Auth-modulen vår.

Forretningsregler

Behandlingstid/responstid og volum

• Behandlingstid/responstid: ca. 1ms

• Frekvens: HTTPS-‘listener’ repeterbar fillagerstrøm for datastrømmestrategi

• Volum (målt: 27 Jul 2022 ): gj.sn. ca. 66k hits daglig

Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse

• Hva skjer ved overload i kø?

  • Det finnes ikke noe kø her, men en overload av kall fra eksamensystemer er mulig og vil føre til feilede kall.

• Hva skjer med ufullstendige meldinger?

  • Det finnes ikke noe meldinger, men ufullstendige eller invalide kall vil føre til feilmeldinger. Enten fra Mule eller fra FS-API’et.

• Inneholder meldingene personopplysninger?

  • Ja i form av navn, e-postadresse eller brukernavn.

• Noe om viktige feil/situasjoner som må passes ekstra på (som kan ha stor konsekvens) :

  • Det mest sannsynlige er at tjenesten faller bort. Dette kan skje ved flere nivåer. Enten Gravitee i front, Mule tjenesten selv eller feil i FS. En slik utfall kan i verste fall ødelegge for eksamengjennomføring. Ingen av kallene/operasjonene i dette API'et er nødvendig for selve gjennomføringen av eksamen, men for oppsett. Det er alltid noen “last-minute” endringer som vil bli rammet om denne integrasjonen ikke fungerer.

  • Feil i data levert fra FS kan rote til opprettelse av prøver i eksamensystemene.

  • Da dette API’et brukes også til å sette sensur, feil som f.eks. sette på feil karakter til en student, vil ha store omdømme konsekvenser.

Kommentarer