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.
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.
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.
Legg inn valideringssertifikat i certificate store
Valideringssertifikat vil være sertifikatet som brukes for å validere svar fra Oppslagstjenesten.
Hvis du skal kjøre mot Difis testserver(https://kontaktinfo-ws-ver2.difi.no/kontaktinfo-external/ws-v4), så skal du bruke Test_Difi.cer. Høyreklikk og lagre til disk.
- 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 noden Certificates - Current User - Trusted People - Certificates_
- Høyreklikk på Trusted People og velg All Tasks -> Import…
- Trykk Next
- Finn mottaker-sertifikatet (Sertifikatnavn.cer) og legg det til. Trykk Next
- Sertifikatet skal legges til i Trusted People
- Next og Finish
- Du skal da få en dialog som sier at importeringen var vellykket. Trykk Ok.
Finne installert sertifikat
OppslagstjenesteKlient
har støtte for å ta 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
- Avsendersertifikat: Åpne noden Certificates - Current User - Personal - Certificates
- Valideringssertifikat: Åpne noden Certificates - Current User - Trusted People - 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
.