Kom i gang med testing

Formålet med denne siden er å støtte de som utvikler egne integrasjoner mot eFormidling å teste at disse fungerer som de skal.

1. Teststrategier
   1. Teste i et lokalt mock-miljø
   2. Teste i eFormidlings testmiljø
      1. Teste i eFormidlings testmiljø med ekte organisasjonsnummer
      2. Teste i eFormidlings testmiljø med syntetisk organisasjonsnummer
   3. Teste i eFormidlings produksjonsmiljø
2. Test-oppsett
   1. Tilrettelegging for test av eFormidlings meldingstjeneste
   2. Tilrettelegging for test av Altinn Digital Post
   3. Lenker til testmiljø
3. Neste steg

Teststrategier

Det er flere mulige strategier for å teste eFormidling og de passer gjerne i ulike faser av arbeidet med å ta i bruk eFormidling.

Teste i et lokalt mock-miljø

eFormidling tilbyr oppsett for et lokalt mock-miljø som lar en teste integrasjonspunktet. Alle eksterne tjenester er mocket bort. Mock-miljøet anbefales som en støtte for utvikling og tidlig brøytetesting. Det er viktig å merke seg at testing i Mock-miljøet ikke er tilstrekkelig for å verifisere at en integrasjon mot eFormidling fungerer. Se beskrivelse av hvordan en kan ta i bruk mock-miljøet:

• efm-mocks (ekstern lenke)

Teste i eFormidlings testmiljø

For å verifisere at en integrasjon mot eFormidling fungerer er det nødvendig å teste i eFormidlings testmiljø.

For å teste i eFormidlings testmiljø må en installere et integrasjonspunkt og konfigurere det til å benytte testmiljø. Vanlig installasjonveiledning kan følges, men før en går i gang må en sørge for å ha en fullverdig testvirksomhet. En må først velge om en ønsker å bruke ekte eller syntetisk organisasjonsnummer. Dersom en ikke har et behov for å benytte ekte organisasjonsnummer i sitt testmiljø anbefales bruk av syntetisk organisasjonsnummer.

Teste i eFormidlings testmiljø med ekte organisasjonsnummer

Testmiljøet for eFormidlings meldingstjeneste er realisert ved hjelp av en egen meldingstjeneste i Altinn Formidlings produksjonsmiljø. Altinn Formidlings produksjonsmiljø støtter bare ekte organisasjonsnummer.

For Altinn Digital Post og KS SvarUt og SvarInn benyttes testmiljø som bare støtter syntetiske organisasjonsnummer. En kan dermed ikke benytte ekte organisasjonsnummer mot alle meldingstjenestene som brukes av eFormidling. En kan likevel benytte alle meldingstjenestene ved å legge inn brukernavn og passord for testvirksomhet hos Altinn Digital Post med et annet organisasjonsnummer enn det integrasjonspunktet kjører. Det samme gjelder KS SvarUt og SvarInn.

Teste i eFormidlings testmiljø med syntetisk organisasjonsnummer

For å bruke syntetisk organisasjonsnummer må en bytte testmiljøet for eFormidlings meldingstjeneste til et alternativt testmiljø. En må i så fall overstyre konfigurasjon av eFormidlings meldingstjeneste fra test-meldingstjenesten i Altinn Formidlings produksjonsmiljø til en tilsvarende test-meldingstjeneste i Altinn Formidlings testmiljø. Dette oppnår en med å legge følgende konfigurasjon i integrasjonspunktet:

difi.move.dpo.streamingserviceUrl=https://tt02.altinn.no/ServiceEngineExternal/BrokerServiceExternalBasicStreamed.svc?wsdl
difi.move.dpo.brokerserviceUrl=https://tt02.altinn.no/ServiceEngineExternal/BrokerServiceExternalBasic.svc?wsdl
difi.move.dpo.serviceCode=4192
difi.move.dpo.serviceEditionCode=270815

Med et slikt oppsett kan en bruke samme syntetiske organisasjonsnummer på tvers av meldingstjenestene så lenge en passer på når en bestiller tilganger og testvirksomhet: alt må bestilles til samme organisasjonsnummer, det er ingen sentral koordinering av dette.

Teste i eFormidlings produksjonsmiljø

En virksomhet som er klar til å ta i bruk eFormidling eller som skal gjøre endringer i oppsettet sitt anbefales å gjøre noen enkle tester i produksjonsmiljøet for å bekrefte at kommunikasjon, tilganger og sertifikatoppsett fungerer som forventet.

Ved testing før første gangs bruk av en ny meldingstjeneste kan det være greit å huske på:

• Dette bør gjøres sammen med en person fra arkivet som er kjent med sak/arkiv/fagsystemet til virksomheten.
• Avtal med servicedesk@digdir.no når dere vil verifisere så vi kan åpne tilganger på vår side. Definer en tidsramme for testing.
• Husk å teste alle meldingstjenester som virksomheten skal benytte
• Test gjerne flere forsendelser per meldingstype og varier størrelse, vedlegg osv.
• NB! Når testing foregår kan virksomheten motta reelle forsendelser i dette tidsrommet. Det er viktig at virksomheten er obs på dette så de ikke går glipp av viktige forsendelser.
• Om noe ikke skulle fungere gi straks beskjed til servicedesk@digdir.no så vi kan fjerne tilganger og feilsøke problemet.
• Reelle forsendelser som mottas under testperioden uten at alt fungerer må sjekkes. Varsle avsender og be de sende på nytt.
• Hvordan vet jeg at det fungerer?
  • Ved forsendelser må en høre med mottaker at meldingen er kommet frem
  • Ved mottak skal meldingene bli pushet fra integrasjonspunktet inn i sak/arkiv/fagsystem
• Når en har verifisert at både mottak og sending av forsendelser fungerer melder en fra til servicedesk@digdir.no.

Test-oppsett

Merk at ved behov for flere installasjoner av integrasjonspunktet (f.eks. to utviklere med hver sin installasjon) i samme miljø så vil en oppleve at installasjonene “stjeler” meldinger fra hverandre dersom de deler testvirksomhet. En kan løse dette ved å bruke kanaler eller ved å å benytte en testvirksomhet per installasjon.

Avhengig av hvilke meldingstjenester som brukes vil det være behov for testbrukere og testvirksomheter å sende til og motta fra:

For å teste varsling og reservasjon for innbyggere kan en selv registrere reservasjon, mobilnummer og/eller e-postadresse for egne testbrukere i kontakt- og reservasjonsregisteret.

For å teste varsling for virksomheter kan en selv registrere mobilnummer og/eller e-postadresse i Altinn.

For å teste på vegne av må en ha to testvirksomheter i Altinn.

Ønskede tilganger bestilles fra:

• eFormidling, eInnsyn og Digital Post til Innbyggere: servicedesk@digdir.no
• Altinn Formidling og Altinn Digital Post: tjenesteeier@altinn.no
• FIKS IO og KS SvarUt og SvarInn: fiks@ks.no

Tilrettelegging for test av eFormidlings meldingstjeneste

Alternativt til selv å sette opp to integrasjonspunkt for å teste eFormidlings meldingstjeneste er det også tilrettelagt for et enklere test-oppsett.

Et integrasjonspunkt som kan sende og motta med organisasjonsnummeret 987464291 er tilgjengelig i eFormidlings testmiljø:

• Enkelt brukergrensesnitt for test-integrasjonspunktet (ekstern lenke)
• Test-integrasjonspunktet (ekstern lenke)

Tilrettelegging for test av Altinn Digital Post

Alternativt til selv å sette opp testvirksomhet for å teste Altinn Digital Post integrasjonspunkt er det også tilrettelagt for et enklere test-oppsett.

Det er opprettet noen testvirksomheter i Altinn som en kan bruke som mottakere. Her vil en kunne logge inn for å finne og se meldinger en har sendt. Disse virksomhetene og brukerne er felles for alle virksomheter i testmiljø. Pass på å ikke sende sensitiv informasjon under testingen med disse virksomhetene.

Brukernavn og passord for testbrukere til virksomhetene over fåes ved å kontakte servicedesk@digdir.no

Lenker til testmiljø

• Altinn https://tt02.altinn.no
• eBoks (Digital Post til Innbyggere) http://demo2-www.e-boks.no/
• Digipost (Digital Post til Innbyggere) http://www.difitest.digipost.no/
• KS SvarUt og SvarInn https://test.svarut.ks.no/tjenester/

Neste steg

• Krav og testbeskrivelser