SOAP service testing: Difference between revisions

Revision as of 12:00, 15 June 2012

Krediidiinfo AS SOAP service is tested using curl software and the KiCompany service. Other Krediidiinfo AS SOAP services can also be tested in the same way.

Authentication is possible using the certificate/key pair as well as the HTTP Basic Authentication user name and password. In addition to the password or certificate, the user needs to have been issued a permission to use the KiCompany service by Krediidiinfo AS customer service.

If the following tests in the client's environment are successful, it can be stated that the certificate or password issued to the client is valid, and the permissions to use KiCompany are correctly set.

Võrgu test

Keskkond, millest päring tehakse, peab saama ühenduda services.krediidiinfo.ee serverisse tcp porti 443. Krediidiinfo AS poolt ei ole IP põhiseid piiranguid sellele serverile.

Testimaks, ega mõni tulemüür vahele ei sega võib kasutada programmi netcat:

nc -z -vv services.krediidiinfo.ee 443

Mõnes operatsioonisüsteemis on binaari nimi teine:

netcat -z -vv services.krediidiinfo.ee 443

Positiivne tulemus on:

Connection to services.krediidiinfo.ee 443 port [tcp/https] succeeded!

Näited negatiivsetest tulemustest on:

nc: connect to services.krediidiinfo.ee port 443 (tcp) failed: Connection refused

nc: connect to services.krediidiinfo.ee port 443 (tcp) failed: Connection timed out

Samuti peaks olema võimalik ühenduda sama serveri tcp porti 80, kust leiab wsdl failid ning sellesama wiki. Kui test ei õnnestu, tuleks pöörduda oma võrguadministraatori poole.

SOAP päringu näide

Esiteks peab teadma, mis teenuse pihta päring teha. Antud näites kasutame KiCompany teenust, seega päringu URI on https://services.krediidiinfo.ee/soap.php?name=KiCompany.

Teiseks on vaja SOAP päringut ennast, hoiame seda teksifailis nimega data.txt, faili sisu järgnev:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <SOAP-ENV:Body>
    <m:findCompanies xmlns:m="urn:KiCompany" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
      <name xsi:type="xsd:string">kredi</name>
      <count xsi:type="xsd:int">2</count>
    </m:findCompanies>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Antud päring otsib firmasid, mis algavad stringiga kredi ning ei kuva rohkem kui kaks esimest vastust. (Päring on tasuline!)

curl kasutamine

Testimiseks on mugav kasutada käsurea programmi curl. Krediidiinfo AS SOAP teenuse kasutamiseks peab curl olema kompileeritud SSL toega ning oskama https protokolli. Veenduge selles käsuga curl --version, tulemus:

curl 7.19.6 (x86_64-redhat-linux-gnu) libcurl/7.19.6 NSS/3.12.4.1 Beta zlib/1.2.3 libidn/0.6.14 libssh2/0.18
Protocols: tftp ftp telnet dict ldap ldaps http file https ftps scp sftp
Features: GSS-Negotiate IDN IPv6 Largefile SSL libz

curl SOAP päring kasutades autentimiseks HTTP Basic Authentication'it

Krediidiinfo AS poolt on teile väljastatud kasutajanimi ja parool, siin näites olgu kasutajanimi "1234" ning parool "abc123".

curl -d @data.txt -u 1234:abc123 https://services.krediidiinfo.ee/soap.php?name=KiCompany

-d määrab päringu. @ märk failinime ees ütleb curl'ile, et tegemist on päringufaili, mitte päringu endaga.

-u määrab kasutaja ja parooli, mis on eraldatud kooloniga.

curl SOAP päring kasutades autentimiseks sertifikaati ja võtit

Päringu tegemiseks on esiteks vaja Krediidiinfo AS poolt väljasatud sertifikaadi faili PEM formaadis, antud näites on failinimeks cert.pem. Välja näeb umbes selline:

Teiseks sertifikaadi võtme faili PEM formaadis, siin failinimeks key.pem. See fail on salajane ning kindlasti emaili teel või muul krüptimata viisil mitte vahendada!

Samas võib selle faili sisu otsa liita cert.pem failile (cat key.pem >> cert.pem), siis ei pea võtmefaili curl'le eraldi ette näitama. Paljud programmid nõuavad just kokku liidetud varianti. Näeb umbes selline välja, DSA variandi puhul on natuke rohkem erinevusi:

Peab teadma ka sertifikaadi võtme parooli, kui võti on krüpteeritud. Antud näites olgu parool abcd1234.

Päringu teostamine:

curl -d @data.txt -cert $PWD/cert.pem:abcd1234 --key $PWD/key.pem https://services.krediidiinfo.ee/soap.php?name=KiCompany

-d võti määrab päringu, @ failinime ees ütleb curl'ile, et tegemist on päringufaili, mitte päringu endaga.

--cert võti määrab sertifikaadi faili asukoha. Tuleb kasutada "absolute path"-i. curl ei otsi faili antud kataloogist, seetõttu ka $PWD antud näites.
Kui võti on krüpteeritud, saab parooli määrata serdifikaadi failinime taga, eraldades selle failinimest kooloniga.

--key määrab võtmefaili asukoha. Kui sertifikaat ja võtmefail on üheks liidetud, siis seda ei ole vaja määrata.
Seetõttu määrataksegi võtme parool --cert juures, mitte siin.

SOAP päringu tulemused

Õnnestunud päring

Õnnestunud tulemus (lisatud reavahetused loetavuse parandamiseks):

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:KiCompany" 
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:findCompaniesResponse>
<companies SOAP-ENC:arrayType="ns1:CompanyIDData[2]" xsi:type="ns1:CompanyIDDataArray">
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">11517686</regCode>
<name xsi:type="xsd:string">KREDICO OÜ</name>
</item>
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">90006012</regCode>
<name xsi:type="xsd:string">KREDIIDI JA EKSPORDI GARANTEERIMISE SITHASUTUS KREDEX</name>
</item>
</companies>
</ns1:findCompaniesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Vigased päringud

Viga GET parameetris (KiCompany asemel KiCompan):

curl -d @data.txt -u 1234:abc123 https://services.krediidiinfo.ee/soap.php?name=KiCompan

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Server</faultcode>
<faultstring>Incorrect HTTP GET parameter 'name' value!</faultstring>
<faultactor></faultactor>
<detail>
<errorcode>-20002</errorcode>
<line_no>157</line_no>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Vigane kasutaja või parool või sertifikaat:

curl -d @data.txt -u 1234:abZZ23 https://services.krediidiinfo.ee/soap.php?name=KiCompany

Krediidiinfo veebiteenuse kasutaja autentimine ebaõnnestus! Abi saamiseks võtke ühendust Krediidiinfoga telefonil (+372) 6659600.

Kasutajal ei ole õigust KiCompany kasutamiseks, pöörduge kliendihalduse poole:

curl -d @data.txt -u 1234:abc123 https://services.krediidiinfo.ee/soap.php?name=KiCompany

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Server</faultcode>
<faultstring>Access denied for KiCompany!</faultstring>
<faultactor></faultactor>
<detail>
<errorcode>-20003</errorcode>
<line_no>106</line_no></detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

SOAP päring puudub:

curl -u 1234:abc123 https://services.krediidiinfo.ee/soap.php?name=KiCompany

(tulemust pole)

SOAP päringus endas on viga:

curl -d @vigane.txt -u 1234:abc123 https://services.krediidiinfo.ee/soap.php?name=KiCompany

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Bad Request</faultstring>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

või

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:VersionMismatch</faultcode>
<faultstring>Wrong Version</faultstring>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

@@ Line 1: / Line 1: @@
 Krediidiinfo AS SOAP service is tested using <tt>curl</tt> software and the [[KiCompany_en | KiCompany]] service. Other Krediidiinfo AS SOAP services can also be tested in the same way.
-Autentimiseks saab kasutada sertifikaadi ja selle võtme paari kui ka http basic authentication kasutajat ning parooli. Peale paroolide või sertifikaadi olemasolu, peab Krediidiinfo AS kliendihaldus olema andnud õiguse kasutada [[KiCompany]] teenust.
+Authentication is possible using the certificate/key pair as well as the HTTP Basic Authentication user name and password. In addition to the password or certificate, the user needs to have been issued a permission to use the [[KiCompany_en | KiCompany]] service by Krediidiinfo AS customer service.
-Kui järgnevad testid kliendi keskkonnas õnnestuvad, saab väita, et kliendile väljastatud sertifikaat või parool on õige ning õigused [[KiCompany]] kasutamiseks paigas.
+If the following tests in the client's environment are successful, it can be stated that the certificate or password issued to the client is valid, and the permissions to use [[KiCompany_en | KiCompany]] are correctly set.

SOAP service testing: Difference between revisions

Revision as of 12:00, 15 June 2012

Contents

Võrgu test

SOAP päringu näide

curl kasutamine

curl SOAP päring kasutades autentimiseks HTTP Basic Authentication'it

curl SOAP päring kasutades autentimiseks sertifikaati ja võtit

SOAP päringu tulemused

Õnnestunud päring

Vigased päringud

Navigation menu

SOAP service testing: Difference between revisions

Revision as of 12:00, 15 June 2012

Võrgu test

SOAP päringu näide

curl kasutamine

curl SOAP päring kasutades autentimiseks HTTP Basic Authentication'it

curl SOAP päring kasutades autentimiseks sertifikaati ja võtit

SOAP päringu tulemused

Õnnestunud päring

Vigased päringud

Navigation menu

Search