Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

Innledning

...

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

Initiering av flyt

Scheduler (fire ganger hver dag for hvert “objects” og “description”)og for Fs-Leganto …

 

Flyt mønster

Synkron

Tar imot HTTP forespørsler fra eksamen-systemer og videresender dem til FS DigEks

Bruk av meldingskø

Nei

 

Open API

Nei

Men brukes av eksterne systemer

IntArk

JA

Bruker Gravitee. Mule-endepunktet ligger bak Gravitee.

...

  • Detaljert liste av alle innvolverte systemer/tjenester Hva utveksler data? Fra hvor / Til hvor?

System

Data

Brukt API (endepunkter)

ConfigInnholdsinformasjon-databasen

Finner orgShortName (ShortName) i databasen til en gitt institutionID (FsId)

configDB.orgs (fsIdToOrgShortName)

Config-databasen

Finner dokument i databasen til en orgShortName (ShortName) med institutionID (FsId)

configDB.orgs (getSingleOrg)

Auth

Autentiserer brukeren med username, password og apiKey (kilde fra MongoDatabase)

authenticateWithApikey (gravitee)

Auth

Autentiserer brukeren med system ("digex"), username og password (dpClientId og dpGatekeeper er valgfrie). Kilde fra MongoDatabase.

authenticate

Auth

Autentiserer brukeren med API key og password, hvis username er "direkteAPIKEY"

autheiticate directly with apikey

LaaS

Registrerer en indeks org, instanceenvevent-name, remote-adr og request-uri i Humio (for å innta og beholde strømmedata)

do Index

FS (gjennom DigEks API’et)

For detaljer om data sent/mottatt se dokumentasjon til API’et https://api-sikt.intark.uh-it.no/catalog/api/81ecdc41-73ed-48c4-acdc-4173ed88c4e9?q=digex

 

Code Block
/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>

 

 

 

 ext

Sender contents, isbn (ISBN13), description_long, audio_file, image_small, image_large, image_original og source til API mot Alma legget av Team Smile

putInfo

 Bokbasen Extension

Denne metoden brukes for å hente objekter fra Bokbasen database. Den mottar enten en "siden"-verdi (since brukes bare hvis next ikke er angitt) eller en "neste"-verdi (next). Resultatet fra databasen transformeres fra xml til json (den setter pagesize hvis spesifisert, ellers brukes bokbasens standard).

Objektrapporten (bilder og lydfiler) inneholder identifikatorer og referanser til adressen hvor objektene kan lastes ned. Disse referansene vil være gyldige i en begrenset periode.

 getPagedObjectsSince

https://bokbasen.jira.com/wiki/spaces/api/pages/67993638/Objects

 Bokbasen Extension

Denne metoden brukes for å hente beskrivelser fra Bokbasen database. Den mottar enten en “siden”-verdi (since brukes bare hvis next ikke er angitt) eller en "neste" verdi (next). Resultatet fra databasen transformeres fra xml til json.

getPagedDescriptionsSince

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.

...

Behandlingstid/responstid og volum

  • Behandlingstid/responstid: gj. snitt ca. 1ms2s (avhengig av antall objekter/beskrivelser)

  • Frekvens: HTTPS-‘listener’ repeterbar fillagerstrøm Scheduler (fire ganger hver dag for hvert “object” og “description”) for datastrømmestrategi

  • Volum (målt: 27 Jul ): gj.sn. ca. 66k hits 1000 “descriptions” og 300 “objects” daglig

Feilhåndtering, konsekvenser av feil og overordnet risikoanalyse

...