ephorte Integration Services (eis) produktbeskrivelse Versjon 2 31.10.2012 Gecko Informasjonssystemer AS Robert Vabo
INNHOLDSFORTEGNELSE INNHOLDSFORTEGNELSE... 2 COPYRIGHT... 3 EPHORTE INTEGRATION SERVICES... 4 LISENSIERING / BEGRENSNINGER... 4 PRODUKTBESKRIVELSE... 4 Integrasjon mot ephorte... 4 Tjenestene... 4 Oversikt over tjenestene... 6 Teknologi... 6 Teknisk løsning... 7 Side 2
COPYRIGHT Informasjon i dette dokumentet inkludert URLer og andre henvisninger til Internet web sider kan endres uten varsel. Informasjon i dette dokumentet kan ikke kopieres eller distribueres uten at det er inngått en eksplisitt avtale med Gecko Informasjonssystemer AS om dette. 2012 Gecko Informasjonssystemer AS. Alle rettigheter reservert. ephorte er et registrert varemerke i Norge Side 3
EPHORTE INTEGRATION SERVICES LISENSIERING / BEGRENSNINGER ephorte Integration Services (eis) er en egen lisensiert modul til ephorte/ncore. Gecko Informasjonssystemer AS innehar alle og fulle eierrettigheter til disse systemene og lisensierer kun ut helt eller delvis bruksrett til sine kunder. Det er derved ikke tiltatt å utvikle integrasjoner, teste integrasjoner eller i drifts sette integrasjon mot eis uten at den brukte instansen av eis er riktig lisensiert. eis lisensieres enten per integrasjon (per integrert system) eller per installasjon av eis (Enterprise). Den som driver integrasjonsarbeid eller drifter en integrasjon mot eis har ansvar for at de nødvendige lisensavtaler og rettigheter for bruk av ephorte og eis foreligger. Videre så forbeholder Gecko Informasjonssystemer AS retten til å gjøre nødvendige endringer i eis og dennes integrasjonsgrensesnitt. eis utvikles slik at den normalt skal tilby bakover kompatibilitet mot tidligere versjoner av løsningen, men dette kan ikke garanteres i en hver sammenheng. Dersom en ny versjon av eis skulle medføre behov for tilpasninger av etablerte integrasjoner som benytter denne, vil dette bli varslet tidlig slike at problemer kan unngås. Det påpekes spesielt at en planlagt slik endring vil være innføring og bruk av teknisk lisenskontroll via lisensnøkler og/eller sertifikater. PRODUKTBESKRIVELSE INTEGRASJON MOT EPHORTE ephorte er et saksbehandlings- og arkivsystem som støtter norsk arkivstandard Noark-5. Systemet består av komplett arkivfunksjonalitet, dokumenthåndtering og saksbehandlingsfunksjonalitet, samt en rekke spesialmoduler. For de virksomheter som benytter ephorte, har systemet normalt en sentral plass i virksomheten. Dette skyldes at ephorte håndterer langtidslagring av alle arkivverdige dokumenter som behandles og produseres av virksomheten. De fleste av disse dokumentene lagres direkte i eller produseres ved hjelp av ephorte, men også andre systemer produserer og fanger opp arkivverdige dokumenter. De fleste virksomheter har derfor et eller flere system som har behov for å integrere seg mot ephorte på en eller annen måte. Historisk sett har ephorte tilgjengeliggjort mange integrasjonsmetoder. Gjennom tiden har det meldt seg et behov for å forbedre integrasjonsflatene og samle de ulike tjenestene i et felles rammeverk. Dette er nå gjort ved hjelp av ephorte Integration Services. TJENESTENE ephorte Integration Services består av et sett med ulike integrasjonstjenester som kan benyttes av de system som skal integrere seg mot ephorte. Tjenestene som skal samlet dekke de til dels svært forskjellige behov som finnes. En enkel skisse viser hvilke tjenester eis består av og hva slags type systemer som vil kan aktuelle for integrasjon mot ephorte via tjenestene. Side 4
Andre system Kontorstøtte Fagsystem Arbeidsflyt Samhandling Innsynsportaler Skjema Object model services Function services Feeds services Noark-4 Webservices ephorte Integration Services ephorte Object model ephorte Side 5
OVERSIKT OVER TJENESTENE Object model services Function services Feeds services Dette er en fullstendig objektmodell for ephorte. Det betyr at man gjennom dette API-et kan utvikle løsninger som kan foreta alle former for operasjoner mot ephorte. Dette gjelder både mulighet for å søke frem og opprette/endre/slette metadata og dokumenter i ephorte. Dette er et sett med høynivå tjenester utviklet for at andre system enkelt skal kunne utføre spesielle funksjoner i ephorte via eis. Dette er en endringslogg over endringer som er skjedd i ephorte. Andre system kan gjennom tjenesten spørre etter bestemte endringer i ephorte og foreta egne aksjoner ved bestemte hendelser. Tjenesten returnerer xml-formaterte svar basert på Atom eller RSS 2.0 avhengig av hva klienten ønsker. Disse xml formatene er åpne standarder uavhengig av plaftform og utviklingsmiljø. Noark-4 Webservices Dette er en offentlig standard som definerer et sett tjenester for kommunikasjon mellom fagsystem og sak/arkivsystem basert på Noark- 4. Dette er tjenester for å opprette sak og dokument og hente informasjon om sak/saksoversikt. Man kan også gjøre enkle søk ved hjelp av tjenestene. TEKNOLOGI Objektmodellen i ephorte Integration Services er et integrasjonsgrensesnitt basert på Windows Communication Foundation (WCF) fra Microsoft. WCF er et abstraksjonslag for å lage nettverksbaserte tjenester i.net. Objektmodellen er implementert slik at de underliggende protokollene som blir brukt er basert på W3C standarder som HTTP,WS-* etc - altså klassiske tjenesteorienterte protokoller for alle plattformer. Teknologiene som benyttes i Feeds-kommunikasjonen er standard HTTP forespørsler av tekstdokumenter med xml-basert innhold i forhold til Atom-\RSS-standarden. Disse xml-formatene er åpne standarder uavhengig av plattform og utviklingsmiljø. Innenfor RSS-formatet finnes det dessverre litt forskjellige måter å implementere dette på. Vi anbefaler derfor bruk av Atom. Side 6
TEKNISK LØSNING ephorte Integration Services skal støtte alle former for integrasjoner mot ephorte, både interne systemers behov for tilgang til saksarkivet og eksterne løsningers behov for innsyn og leveranser til arkivet. I de fleste virksomheter vil ephorte inneholde sensitiv informasjon og sensitive dokumenter. Dette stiller særdeles strenge krav til autentisering og sikker kommunikasjon. En forenklet skisse viser sammenheng mellom eis og ulike systemer. eis og eis Proxy Normalt settes eis opp internt og interne systemer som skal integreres mot ephorte vil kommunisere med denne interne forekomsten av eis. Dersom eksterne systemer (foreløpig kun einnsyn) skal kommunisere med eis, installeres eis Internet Connector (tidligere eis Proxy) opp i en egnet sone og tilgjengeliggjøres for eksterne system. All trafikk mellom eis og eis Internet Connector er enveis, det vil si at den alltid er initiert fra eis som henter forespørsler fra eis Internet Connector og levere resultater tilbake. Kommunikasjonen er beskyttet og kryptert. Autorisering av systemer Sertifikater og kommunikasjon Brukerautentisering Alle systemer som skal integreres mot eis, både interne og eksterne, skal autoriseres av eis. Det betyr at eis har registrert hvilke system som tillates å kommunisere med eis og hvilke rettigheter systemet har med hensyn til leserettigheter, skriverettigheter, brukerautorisering, med mer. Alle systemer som skal kommunisere med eis skal kjøres på maskiner utstyrt med gyldige sertifikater for formålet. All kommunikasjon mellom eis og andre system vil være beskyttet og kryptert. eis har støtte for brukerautorisering, dvs at andre system tillates å gjøre forespørsler og foreta oppdateringer mot eis som en bestemt bruker, person eller virksomhet. Alternativet er å opptre som en anonym bruker. Side 7
Kontakt eekundestotte@evry.com for hjelp Brukerautentiseringen gjøres ikke av eis. eis settes opp til å godta at bestemte system kan foreta egen brukerautentisering. eis vil da godta bruker som benyttes uten å foreta egen autentisering. Brukeren må derimot være etablert i ephorte og gitt tilganger til metadata og dokumenter her. eis har støtte for: ephorte-brukere, dvs brukere som er registrert og gitt rettigheter i ephorte utvalgsmedlemmer som er registrert i ephorte kunder som er registrert i ephorte eller ephorte-godkjente registre anonyme brukere Side 8