Hvordan komme i gang
Klienten er tilgjengelig som en NuGet-pakke. Denne vil oppdateres jevnlig etter hvert som ny funksjonalitet legges til.
For å installere NuGet-pakken, gjør følgende:
- Velg TOOLS -> NuGet Package Manager -> Manage Nuget Packages for Solution…
- Søk etter oppslagstjeneste.
- Ønsker du pre-release, må du sørge for at det står Include Prerelease i drop-down menyen rett over søkeresuløtatene (der det står Stable Only).
- Velg oppslagstjeneste og trykk Install.
Konfigurasjon
OppslagstjenesteKonfigurasjon initieres med hvilket miljø man ønsker å kjøre mot, FunksjoneltTestmiljø eller Produksjonsmiljø, samt tilhørende sertifikat til gitt miljø.
Proxy
For å bruke proxy setter man ProxyHost
,ProxyPort
og ProxyScheme
i konfigurasjonen:
På vegne av
For å gjøre oppslag på vegne av en annen virksomhet settes organisasjonsnummeret til gitt bedrift i OppslagstjenesteKonfigurasjon.SendPåVegneAv
:
Eksempel på kall
Det er bare tre kall du kan gjøre mot oppslagstjenesten; hente endringer, hente personer og hente printsertifikat. Her er et minimumseksempel på hva du må ha når du har fått hentet sertifikatene som er installert.
Installere sertifikater
For å sende forespørsler til Oppslagstjenesten trenger du å installere sertifikater på maskinen. Grunnen til at de skal installeres er i hovedsak sikkerhet. Når du installerer ditt private avsendersertifikat på datamaskinen så blir du spurt om passord. Dette skjer kun én gang, og etter dette kan du bruke sertifikatet i koden uten å eksponere passordet.
Installere avsendersertifikat/virksomhetssertifikat
Avsendersertifikatet brukes av Virksomhet for å signere forespørsler som går til Oppslagstjenesten.
- Dobbeltklikk på sertifikatet (Sertifikatnavn.p12)
- Velg at sertifikatet skal lagres i Current User og trykk Next
- Filnavn skal nå være utfylt. Trykk Next
- Skriv inn passord for privatekey og velg Mark this key as exportable …, trykk Next
- Velg Automatically select the certificate store based on the type of certificate
- Next og Finish
- Får du spørsmål om å godta sertifikatet så gjør det.
- Du skal da få en dialog som sier at importeringen var vellykket. Trykk Ok.
Finne installert sertifikat
OppslagstjenesteKlient
tar inn OppslagstjenesteKonfigurasjon
, som igjen tar inn thumbprint direkte:
For å finne thumbprint så er det lettest å gjøre det vha Microsoft Management Console (mmc.exe).
- Start mmc.exe (Trykk windowstast og skriv mmc.exe)
- Velg File -> Add/Remove Snap-in…
- Merk Certificates og trykk Add >
- Velg My user account og trykk Finish
- Åpne mappe for sertifikat og finn avsendersertifikat: Åpne noden Certificates - Current User - Personal - Certificates
- Dobbeltklikk på sertifikatet du installerte
- Velg Details, scroll ned til Thumbprint og kopier
- VIKTIG: Hvis du får problemer i kode med at sertifikat ikke finnes, så kan det hende du får med en usynling BOM(Byte Order Mark). Slett derfor denne med å sette peker før første tegn i thumbprint i en teksteditor. Hvis det var en BOM der så forsvant ikke det første synlige tegnet i thumbprint.
Ønsker du å sende inn sertifikater du har allerede har initialisert, kan du kalle konstruktøren som tar inn X509Certificate2
.
Async/Sync
Alle operasjonene/metodene i Oppslagstjenesten har både synkrone og asynkrone metoder. Velg det som passer din applikasjon. Klienten initialiserer på samme måte og det er kun gitt metode som styrer hvorvidt den er asynkron eller ikke.
Asynkrone metoder
Metodene som er asynkrone returnerer en Task<>
av objektet den synkrone metoden returnerer. Man kan await`e
svaret direkte eller ventet på at Task-en
skal bli ferdig på annet vis.