Her finner du steg for steg veiledning for hvordan du setter opp miljøet slik at du kan kjøre eksempelkoden for h.h.v. identifisering og signering.

Det første, og mest omfattende eksempelet, viser hvordan du kan kjøre eksemplene kun v.h.a. enkle ASPX-filer i IIS 5.1, uten å benytte Visual Studio.

Det andre, og kortere, eksempelet viser hvordan du i stedet kan laste inn Visual-Studio-løsningen som følger med .NET integrasjonsbiblioteket, for så å kjøre disse eksemplene direkte fra Visual Studio.

Hvordan kjøre eksempelkoden i IIS 5.1 under Windows XP Professional

Dette trenger du:

Test4 Smartkort fra Buypass, eller en Buypass ID i mobil for Test4
BP-WipsDotNet-1.0_090526.zip fra denne siden under "Nedlastinger"/".NET biblioteker"
aspx-sample-identify.zip og aspx-sample-sign-getcontent.zip fra denne siden, under "Nedlastinger"/"Eksempelkode"
Testnøkler for din brukerstedsID og IPS Sertifikat for test.
Ditt private nøkkellager skal være sendt til Bedriftens Sertifikatbestiller og Aktiveringskode mottaker. Hvis du ikke har mottatt dette, kontakt Buypass Kundeservice.
Internet Information Services (IIS).
Dersom du har XP Pro, men ikke har installert IIS, kan denne installeres ved å gå til "Start"/"Settings"/"Control Panel"/"Add or Remove Programs"/"Add/Remove Windows Components" og krysse av for "Internet Information Services (IIS). Du kan da ha behov for en XP Pro installasjons CD.
Windows Vista kommer med IIS 7. Denne kan også brukes.
.NET 2.0 Framework.
Dersom du ikke allerede har dette, kan det lastes ned fra Microsoft

1. Pakk ut nøkler og sertifikater

Opprett katalogen C:\CERTS og legg her IPS-sertifikatet (177974_bpvsauthp10.cer) og testnøklene for din brukerstedsID

2. Pakk ut ASPX-filene og .NET bibliotekene

Opprett katalogen C:\WIPSSAMPLE, og pakk ut filene aspx-sample-identify.zip og/eller aspx-sample-sign-getcontent.zip her, slik at ASPX-filene ligger direkte i katalogen C:\WIPSSAMPLE.

Opprett katalogen C:\WIPSSAMPLE\BIN

Pakk ut eller åpne filen BP-WipsDotNet-1.0_090526.zip. Under katalogen BP-WipsDotNet-1.0_090526/wips/bin/Release vil du finne to DLL-filer: BouncyCastle.Crypto.dll og BuypassWips.dll. Disse må kopieres og legges i katalogen C:\WIPSSAMPLE\BIN som du nettopp opprettet.

3. Gjør katalogen tilgjengelig i IIS (Forutsatt at IIS er installert).

Høyre-klikk "My Computer" og velg "Manage".

Gå til "Services and Applications" -> "Internet Information Services" -> "Web Sites" og høyreklikk "Default Web Site". I pop-up-menyen som dukker opp, velg "New" -> "Virtual Directory...", "Next".

For "Virtual Directory Alias", skriv inn "wipssample" og trykk "Next".

For "Directory" velg browse, og manøvrer deg frem til C:\WIPSSAMPLE, eller skriv inn direkte "C:\WIPSSAMPLE" og trykk "Next".

Sørg for at "Read" og "Run scripts (such as ASP)" er krysset av, og trykk "Next" og "Finish".

Under "Default Web Site" skal nå "wipssample" dukke opp. Høyreklikk denne og velg "Properties".

Velg "tab'en" for "ASP.NET". Sørg for det er gjort et valg for ASP.NET version, og at dette valget er 2.0 eller høyere.

Når dette er gjort, trykk "Apply" og "OK".

Sørg for at IIS er startet, eventuell restart denne for sikkerhets skyld: Høyreklikk "Internet Information Services" velg "All tasks" og Start eller Restart IIS.

4. Teste identifisering.

Åpne først filen C:\WIPSSAMPLE\Id.aspx i en editor for å sjekke at konfigurasjonen er satt riktig.

int merchantId = 512;

WipsRemoteConfig.SetProperty("cnl.wips.remote.ips.hostname", "secure.test4.buypass.no");
WipsRemoteConfig.SetProperty("cnl.wips.remote.ips.protocol", "https");
WipsRemoteConfig.SetProperty("cnl.wips.remote.ips.direct_protocol", "https");

WipsRemoteConfig.SetProperty("cnl.wips.remote.merchantid", merchantId.ToString());
WipsRemoteConfig.SetProperty("cnl.wips.remote.bp_cert_path", "C:\\certs\\177974_bpvsauthp10.cer");
WipsRemoteConfig.SetProperty("cnl.wips.remote.keystore.path", "C:\\certs\\[your key repository path]");

WipsRemoteConfig.SetProperty("cnl.wips.remote.keystore.pwd", "test123");

Dersom du ikke har brukerstedsID 512, må du antakeligvis endre disse to linjene:

int merchantId = 512;
WipsRemoteConfig.SetProperty("cnl.wips.remote.keystore.pwd", "test123");

Etter dette er gjort, ogId.aspxer lagret, kan du åpne en nettleser og skrive inn addressenhttp://localhost/wipssample/Id.aspx.

Du skal da bli sendt videre til Buypass' identifiseringsside. Etter at du har satt inn kortet og tastet PIN, skal du bli redirigert tilbake "til http://localhost/wipssample/IdResponse.aspx", hvor kortholderens navn og buypassId vises - identifisering er utført.

5. Teste signering av PDF-dokument.

Åpne først filen C:\WIPSSAMPLE\signreq.aspx i en editor for å sjekke at konfigurasjonen er satt riktig.

Igjen, dersom du ikke har brukerstedsID 512, må du antakeligvis endre disse to linjene:

int merchantId = 512;
WipsRemoteConfig.SetProperty("cnl.wips.remote.keystore.pwd", "test123");

Du må også ha tilgjengelig et eller annet PDF-dokument som skal signeres, og oppdatere denne linjen i aspx-scriptet:

String docPath = "c:/wipssample/tmp/test_kontrakt.pdf";

Dokumentet vil bli lest inn og kryptert av signreq.aspx og det blir så lagt på sesjonen.
Buypass signerings applet'en henter så ut dokumentet igjen via getcontent.aspx.

String IIS_VirtualDirectory = "wipssample";
String baseUrl = this.Page.Request.Url.Scheme + "://" + this.Page.Request.Url.Authority + "/" + IIS_VirtualDirectory;
srd.AddElement("ContentUri", baseUrl + "/getcontent.aspx?what=document");

Når dette er gjort, og signreq.aspx er lagret, kan du forsøke å åpne en nettleser og gå til:http://localhost/wipssample/signreq.aspx.

Dersom IIS ikke har tilgang til å lese i katalogen hvor PDF'en ligger, vil du få en melding ala: Access to the path 'c:\wipssample\tmp\test_kontrakt.pdf' is denied.
I såfall; høyreklikk katalogen i Windows Utforsker, velg "Properties" og "Security".
Under "Group or usernames", Velg "Add". Sørg for at "From this location" er satt til ditt datamaskinnavn, og ikke til intranettet.
Skriv inn "ASPNET", trykk eventuelt først "Check Names" og deretter "OK".

Du får nå opp "ASP.NET Machine Account" som et bruker-valg. Velg denne, og for å kunne kjøre eksempelet, kryss og for "Full Control"/"Allow" og trykk "Apply" og "OK".

Prøv så å laste siden i nettleseren på nytt.

Hvis alt er konfigurert riktig, skal du nå blir sendt videre til Buypass' signeringsside.

Når PIN er tastet og signering utført, skal du bli redirigert tilbake til signresp.aspx som viser informasjon om hvem som har signert dokumentet.

Hvordan kjøre eksempelkoden under Visual Studio's "development server"

Dette trenger du:

Test4 Smartkort fra Buypass, eller en Buypass ID i mobil for Test4
BP-WipsDotNet-1.0_090526.zip fra denne siden under "Nedlastinger"/".NET biblioteker"
Testnøkler for din brukerstedsID og IPS Sertifikat for test.
Disse kan lastes ned fra denne siden under "Nedlastinger"/"Nøkler og sertifikater"
Visual Studio 2008 (Vil antakeligvis også fungere i VS 2005 og i Visual Web Developer Express med noe justeringer)

1. Pakk ut nøkler og sertifikater

Opprett katalogen C:\CERTS og legg her IPS-sertifikatet (177974_bpvsauthp10.cer) og testnøklene for din brukerstedsID

2. Pakk ut BP-WipsDotNet-1.0_090526.zip og åpne i Visual Studio

Pakk ut filen BP-WipsDotNet-1.0_090526.zip.

Under katalogen BP-WipsDotNet-1.0_090526 vil du finne filen WipsDotNetWithDemo.sln. Dobbelklikk denne og løsningen skal bli åpnet i Visual Studio.

Denne Visual Studio løsningen inneholder både kildekoden til støttebiblioteket (prosjektet BuypassWips), og eksempelkode (prosjektet wipsdemo).

3. Teste identifisering og signering

Du må først sørge for at din brukerstedsId, passord til nøkkelfil og andre konfigurasjonsverdier er satt riktig.

Se punktene 4 og 5 ovenfor under "Hvordan kjøre eksempelkoden i IIS 5.1", men i stedet for å endre i .aspx-filene endrer du i filen demo\DemoConfig.cs i prosjektet wipsdemo, som deles av alle aspx-filene.

PDF-filen som skal signeres spesifiseres i demo\signreq.aspx.cs:

DoIt("c:/wips/tmp/test_kontrakt.pdf");

4. Teste identifisering.

Åpne filen "Id.aspx" under prosjektet "wipsdemo" i Solution Explorer, og trykk F5.

Se for øvrig samme punkt ovenfor, for "Hvordan kjøre eksempelkoden i IIS 5.1".

5. Teste signering av PDF-dokument.

Åpne filen "signreq.aspx" under prosjektet "wipsdemo" i Solution Explorer, og trykk F5.

Se for øvrig samme punkt ovenfor, for "Hvordan kjøre eksempelkoden i IIS 5.1".