Java integrasjon

Her finner du eksempel på steg for steg oppsett av en webapp i Tomcat som gjør identifisering med IPS basert på det vedlagte eksemplet i Java integrasjons-biblioteket.

Som et eksempel refererer denne veiledningen til at webapp'ene i tomcat ligger under /tomcat/webapps/ katalogen. Eksempelet forutsetter med andre ord at Tomcat er installert og satt opp. "Bytt ut" /tomcat/webapp/ med din tilsvarende path. Eksempelet forutsetter også at lokale tomcat går på port 80, og er tilgjengelig på http://locahost/. Eksempelet forutsetter også at din brukerstedsID er 512. Denne bytter du ut med din tildelte brukerstedsID.

Nedlasting

Opprett en katalog (for eksempel) /buypass.
Last ned Støttebibliotek for integrasjon, og lagre filen i /buypass.
Pakk ut filene, slik at du får en /buypass/BP-Java-WIRI-[versjonsnummer]/. Nødvendige .jar filer ligger nå under /buypass/BP-Java-WIRI-[versjonsnummer]/lib/

Opprett webapp'en i Tomcat og legg inn eksempelkodene

Opprett en katalog /tomcat/webapp/wipstest/WEB-INF/lib/.
Kopier innholdet fra /buypass/BP-Java-WIRI-[versjonsnummer]/lib/ til /tomcat/webapp/wipstest/WEB-INF/lib/. Sørg for at tomcat brukeren har nødvendige rettigheter i katalogene.
Kopier filene id.jsp og idresponse.jsp fra /buypass/BP-Java-WIRI-[versjonsnummer]/lib/sample inn i /tomcat/webapp/wipstest/

Nøkler og sertifikater

Opprett en katalog /buypass/keysandcert
Last ned ditt private nøkkellager (.zip fil), og lagre .zip filen i /buypass/keysandcert
Last ned IPS offentlige nøkkel (Nøkler og sertifikater), og lagre .zip filen i /buypass/keysandcert
Pakk ut de to ovennevnte .zip filene, slik at du nå får to filer; 512keystore og 177974_bpvsauthp10.cer i katalogen /buypass/keysandcert.

Konfigurasjon av applikasjonen

Konfigurasjonsparameterene bør leses og tilordnes WipsRemoteConfig i en boot-strap mekanisme, som f.eks. i en HttpServlet som eksekveres på oppstart av tomcat. For eksempelets skyld, legges dette inn "øverst" i første .jsp fil, for å illustrere hvordan man tilordner konfigurasjonen i integrasjonsbiblioteket. Denne konfigurasjonen bør leses fra eget parameter lager (fil/base/environment/etc) i stedet for at det er hardkodet.

Under tilordnes keystore path, sertifikat path og brukerstedsID. BrukerstedsID trengs kun å oppdateres for direkte operasjoner. Konfigurasjonen under justerer kun såkalte B-kategoriserte parametere, pluss én M parameter (se Konfigurasjon av støttebibliotek).

Eksempelet under forutsetter at alias for nøkkellageret er lik brukerstedsID'en (512), og passordet er test123. For å kunne bruke WipsRemoteConfig, må du også legge til
linjen:

<%@ page import="cnl.wips.remote.config.*" %>

sammen med de andre import statementene i filen id.jsp.

Tomcat på Windows

Hvis du kjører på Windows, og har flere disker, bruk drive-navnet foran alle PATH'er, f.eks. "c:/buypass/keysandcert/177974_bpvsauthp10.cer"

Legg inn følgende linjer øverst (på linje 4) i /tomcat/webapp/wipstest/id.jsp filen:

WipsRemoteConfig.setProperty("cnl.wips.remote.merchantid", "512");
WipsRemoteConfig.setProperty("cnl.wips.remote.keystore.path", "/buypass/keysandcert/512keystore");
WipsRemoteConfig.setProperty("cnl.wips.remote.keystore.alias", "512");
WipsRemoteConfig.setProperty("cnl.wips.remote.keystore.pwd", "test123");
WipsRemoteConfig.setProperty("cnl.wips.remote.bp_cert_path", "/buypass/keysandcert/177974_bpvsauthp10.cer");

ResponseUrl er satt til å være http://localhost/wipstest/idresponse.jsp i filen id.jsp, som skal stemme med strukturene i dette eksempelet.

I filen /tomcat/webapp/wipstest/id.jsp finnes det en HTML form helt nederst. Riktig "action" adresse for denne er "https://secure.test4.buypass.no/wips/service". Bytt eventuelt ut "http://localhost:8080/wips/servlet/cnl.wips.web.servlet.WipsServlet" med denne adressen.

Restart Tomcat, eventuelt deploy/reload denne applikasjonen gjennom Tomcat Manager Application.

Test

Du skal nå kunne gå inn på http://localhost/wipstest/id.jsp for å starte identifisering. Du trenger et Test4 Smartkort fra Leverandøren, eller en Buypass ID i mobil for Test4 for å kunne gjennomføre en identifisering.

Du kan også teste at integrasjonen fungerer uten Smartkort ved å trykke "Avbryt" i identifiseringsbildet. Du skal da havne tilbake til idresponse.jsp, med melding om at identifiseringen ble avbrutt.

Forutsatt at du har f.eks. et Test4 Smartkort fra Leverandøren, kan du sette dette i kortleseren, taste PIN-kode, og du blir rutet tilbake til http://localhost/wipstest/idresponse.jsp som viser deg informasjon om eieren av Smartkortet.

Buypass Developer Space