Skip to content

Test client for web services using enterprise certificate

Notifications You must be signed in to change notification settings

Altinn/ec-client-dotnet

Repository files navigation

Formål for klient

"EC Endpoint Client" er laget for å gjøre det enklere å teste EC endepunkter.

Bruk av klient

Valg av endepunkt og tjeneste

For å velge endepunkt og tjeneste, må bruker først velge tjeneste-område:

Når bruker har valgt område vil han få opp mulighet til å velge hvilket endepunkt han vil gjøre forespørsler mot.

Bruk av klient mot tjenester

Etter å ha valgt endepunkt, kan bruker gjøre kall til tjenester for endepunktet. Man kan velge mellom miljøer man vil gjøre kall mot og hvilke sertifikater man vil bruke.

Miljø

For å velge hvilket miljø bruker skal gjøre kall mot, klikk på Endpoints drop-down lista, og velg ønsket miljø.

Installasjon av miljøer.

Dersom man vil teste mot et miljø som ikke finnes i EndPoints listen, må man gjøre en endring i «EC EndPoint Client.exe.config» filen. Under <client> er det en liste med endpoints som ser slik ut:

<endpoint address="https://st01.altinn.basefarm.net/ArchiveExternal/ReporteeArchiveExternalEC.svc" binding="customBinding"  bindingConfiguration="X509Binding" contract="ReporteeArchive.IReporteeArchiveExternalEC" name="ST01"/> 

Denne konfigurasjonen beskriver et tjeneste endpoint for et spesifikt miljø, som er beskrevet i «address». «Name» beskriver hva som vil vises i EndPoints dropdown listen. Dersom bruker for eksempel vil gjøre et kall til ReporteeArchiveExternalEC.svc i AT05 miljøet, må han kopiere denne konfigurasjonen, og endre den til følgende:

<endpoint address="https://at05.altinn.basefarm.net/ArchiveExternal/ReporteeArchiveExternalEC.svc" binding="customBinding"  bindingConfiguration="X509Binding" contract="ReporteeArchive.IReporteeArchiveExternalEC" name="AT05"/> 

Når bruker så starter klienten og åpner ReporteeArchiveExternalEC endepunktet, vil AT05 være blant valgene i EndPoints listen. Dette endringen må gjøres for hvert service-endepunkt bruker ønsker å gjøre kall mot.

Sertifikat

Ved å trykke på Certificate knappen kan bruker velge hvilket sertifikat han vil gjøre forespørselen med.

Dette åpner et vindu med liste over de sertifikater som eksisterer i brukers Certificate store.

For å velge sertifikat, klikk på sertifikatet i listen, og lukk vindu.

Installasjon av sertifikat.

Installasjon av sertifikat gjøres på vanlig måte. Klienten henter ut sertifikater fra aktive windows-brukers certificate-store. Man kan sette et default certificate ved å modifisere «EC Endpoint Client.exe.config» fila, under <behaviours><behavior name= «CustomBehavior»><clientCredentials><clientCertificate findvalue=« Thumbprint »>, hvor Thumbprint er thumbprint av sertifikatet man vil bruke som default. Sertifikatet med korresponderende thumbprint vil da automatisk lastes hver gang man starter klienten, sålenge det ligger i brukers Certificate Store.

Shipment

Når et kall gjøres til tjeneste kreves det vanligvis at et shipment-objekt fylles ut.

«Show Shipment» - For å fylle ut et shipment-objekt, klikk på Show Shipment knappen. «Save Shipment»/«Load Shipment» - Noen Shipment objekter er mer komplekse enn andre. Disse kan lagres til en fil, og hentes inn i programmet på nytt. Disse blir lagret til et XML-serialisert objekt, og filene kan redigeres.

Bruker-informasjon

Brukernavn og passord fylles ut i Username og Password tekstboksene.

For tjenester for EC brukere er tekstboksene merket «Username» og «Password». For tjenester med agency brukere er tekstboksene merket «AgencyUsername» og «AgencyPassword».

Utfør tjenestekall

Når shipmentdata og brukerinformasjon er fyllt ut, kalles tjenesten ved å klikke på Invoke Service.

Resultat

Når man har gjort tjenestekall vil resultatet vises i vinduet.

«Show Result» knappen viser siste resultat i vinduet. «Save Result» knappen lagrer resultatet til en fil.

Soap Data

Når man har gjort et tjenestekall kan man se Soap Request og Soap Reply ved å velge dem fra «Soap Messages» menyen.

«Show» viser Soap data i en viewer. «Save» lagrer Soap data til en fil. Det er kun siste Soap melding som vises.

REST

«Environment» - miljøet man ønsker å teste i. Typisk TT02 eller PROD.

«AppKey» - api-nøkkel (GUID) man får ved bestilling av tilgang til API-et og angitte ressurser .

«HTTP Method» - angir om requesten er en post (oppretter), put (oppdaterer) eller delete (sletter).

«Username/Password» - brukernavn og passord for virksomhetsbrukeren som er tilknyttet valgt sertifikat. Denne opprettes i Altinn-portalen.

«Target method» -starter med api/ og angir hvilken ressurs eller hvilket element man vil kjøre requesten mot (eksempel: api/my/messages)

«Run» – sender requesten til valgt Altinn-miljø/ressurs

«Select certificate» – velger hvilket av de installerte sertifikatene som skal brukes

«Login» – autentiserer sertifikat, brukernavn og passord og returnerer sesjonscookie ved 200 OK

«Response headers» - headerne som returneres fra Altinn etter en request

«Request body» - her kan man angi body for request som sendes til valgt ressurs (for eksempel ved POST av skjema)

«Response body» - viser responsen fra Altinn

About

Test client for web services using enterprise certificate

Topics

Resources

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages