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.