Apps: Forenklet integrasjon for sluttbrukersystemer

[RonnyB71]

Overordnet beskrivelse

Dagens api endepunkter i en Altinn 3 applikasjon er like på tvers av alle applikasjoner. Dette innebærer at modellene ikke eksponeres siden disse varierer per applikasjon. Man eksponerer i praksis en blob med data og må kommunisere format (XSD eller Json Schema) på andre måter. Api endepunktene er knyttet til den definerte prosessen i applikasjonen og fungerer i praksis på den måten at man oppretter en instans, legger til data, validerer og fullfører prosessen. Dette kan gjøres med minimum to api kall i dag, men er litt avhengig av definerte prosessen. I tillegg kommer evt. feilhåndtering og opprydding av instanser og data hvis man av en eller annen grunn ikke klarer å sende inn skjema. Før et slutbbrukersystem kan benytte apiene må man autentisere seg via Maskinporten samt veksle inn token man får der til et Altinn token.

Dokumentasjon for innsending av data fra sluttbrukersystem

Forventet resultat

Det er identifisert behov for forenklinger knyttet til innsending fra sluttbrukersystemer:

• Unngå innveksling til Altinn token
• Kunne eksponere modellene på api endepunktene
• Kunne sende inn alle nødvendige data med ett kall, og kun hvis validering lykkes, så blir det opprettet data i Altinn. Evt. feil returneres som en liste og må korrigeres før ny innsending kan foretas
• Foreta en rettighetssjekk for innlogget bruker for f. eks. å kunne enable/disable funksjonalitet i sluttbrukersystemet.
• Kunne støtte en info side til sluttbruker uten komponenter med datamodell bindinger for å informere om at dette er en tjeneste som ikke kan/skal benyttes med frontend.
• Kunne benytte systembruker mot app api'ene
• Egen swagger for sluttbrukersystem endepunkter - hvilke api endepunkter gjelder for vår frontend?

Hvordan vil det virke?

Gjennomføring

Oppgaver

Beta Give feedback

1. Simplified app swagger and documentation for end user systems Altinn/app-lib-dotnet#692
   kind/feature-request status/triage +2
   
2. Support user defined metadata when posting data element Altinn/app-lib-dotnet#783
   kind/user-story org/dibk status/draft status/triage +4
3. Authorization scenarios and mechanisms analysis Altinn/app-lib-dotnet#763
   +0
   
4. Automatic info-page (metadata) for apps Altinn/app-lib-dotnet#760
   kind/feature-request status/triage +2
   

Avhengigheter

Beta Give feedback

1. Fremtidig løsning for sluttbrukersystemer Altinn/altinn-authentication#200
   kind/analysis +1
2. Support system user in Storage Altinn/altinn-storage#501
   3 of 7
   kind/user-story +1
   

[martinothamar]

Analyse fra team Core ifbm Storage: Altinn/altinn-storage#471