SOAP teenuse testimine - Revision history

Paavo at 12:03, 6 December 2016

2016-12-06T12:03:08Z

← Older revision		Revision as of 15:03, 6 December 2016
Line 3:		Line 3:
	\|}		\|}

	~~Krediidiinfo~~ AS SOAP teenuse testimine kasutades <tt>curl</tt> programmi ning [[KiCompany]] teenust. Analoogselt saab testida ka teisi ~~Krediidiinfo~~ AS SOAP teenuseid.		Creditinfo AS SOAP teenuse testimine kasutades <tt>curl</tt> programmi ning [[KiCompany]] teenust. Analoogselt saab testida ka teisi Creditinfo AS SOAP teenuseid.

	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.		Autentimiseks saab kasutada sertifikaadi ja selle võtme paari kui ka http basic authentication kasutajat ning parooli. Peale paroolide või sertifikaadi olemasolu, peab Creditinfo Eesti AS kliendihaldus olema andnud õiguse kasutada [[KiCompany]] teenust.

	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.		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.
Line 12:		Line 12:
	== Võrgu test ==		== Võrgu test ==

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


Line 51:		Line 51:
	== curl kasutamine ==		== curl kasutamine ==

	Testimiseks on mugav kasutada käsurea programmi <tt>curl</tt>. ~~Krediidiinfo AS~~ SOAP teenuse kasutamiseks peab <tt>curl</tt> olema kompileeritud SSL toega ning oskama https protokolli. Veenduge selles käsuga <tt>curl --version</tt>, tulemus:		Testimiseks on mugav kasutada käsurea programmi <tt>curl</tt>. Creditinfo SOAP teenuse kasutamiseks peab <tt>curl</tt> olema kompileeritud SSL toega ning oskama https protokolli. Veenduge selles käsuga <tt>curl --version</tt>, 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		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
Line 59:		Line 59:
	=== curl SOAP päring kasutades autentimiseks HTTP Basic Authentication'it ===		=== 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".		Creditinfo poolt on teile väljastatud kasutajanimi ja parool, siin näites olgu kasutajanimi "1234" ning parool "abc123".

	curl -d @data.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki>		curl -d @data.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki>
Line 70:		Line 70:
	=== curl SOAP päring kasutades autentimiseks sertifikaati ja võtit ===		=== 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 <tt>cert.pem</tt>. Välja näeb umbes selline:		Päringu tegemiseks on esiteks vaja Creditinfo poolt väljasatud sertifikaadi faili PEM formaadis, antud näites on failinimeks <tt>cert.pem</tt>. Välja näeb umbes selline:
	<pre>		<pre>
	-----BEGIN CERTIFICATE-----		-----BEGIN CERTIFICATE-----
Line 174:		Line 174:
	curl -d @data.txt -u 1234:abZZ23 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki>		curl -d @data.txt -u 1234:abZZ23 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki>
	<pre>		<pre>
	~~Krediidiinfo~~ veebiteenuse kasutaja autentimine ebaõnnestus! Abi saamiseks võtke ühendust ~~Krediidiinfoga~~ telefonil (+372) 6659600.		Creditinfo veebiteenuse kasutaja autentimine ebaõnnestus! Abi saamiseks võtke ühendust Creditinfoga telefonil (+372) 6659600.
	</pre>		</pre>

Kart at 08:42, 13 June 2013

2013-06-13T08:42:48Z

← Older revision		Revision as of 11:42, 13 June 2013
Line 1:		Line 1:
			{\| align="right"
			\| [[Image:Flag of the United Kingdom.svg\|border\|30px]] [[SOAP_service_testing\|In English]]
			\|}

	Krediidiinfo AS SOAP teenuse testimine kasutades <tt>curl</tt> programmi ning [[KiCompany]] teenust. Analoogselt saab testida ka teisi Krediidiinfo AS SOAP teenuseid.		Krediidiinfo AS SOAP teenuse testimine kasutades <tt>curl</tt> programmi ning [[KiCompany]] teenust. Analoogselt saab testida ka teisi Krediidiinfo AS SOAP teenuseid.

Rait: /* Õnnestunud päring */ näide lühemaks tehtud

2009-09-18T07:58:22Z

Õnnestunud päring: näide lühemaks tehtud

@@ Line 130: / Line 130: @@
 <SOAP-ENV:Body>
 <ns1:findCompaniesResponse>
-<companies SOAP-ENC:arrayType="ns1:CompanyIDData[10]" xsi:type="ns1:CompanyIDDataArray">
+<companies SOAP-ENC:arrayType="ns1:CompanyIDData[2]" xsi:type="ns1:CompanyIDDataArray">
 <item xsi:type="ns1:CompanyIDData">
 <regCode xsi:type="ns1:regCode">11517686</regCode>
@@ Line 138: / Line 138: @@
 <regCode xsi:type="ns1:regCode">90006012</regCode>
 <name xsi:type="xsd:string">KREDIIDI JA EKSPORDI GARANTEERIMISE SITHASUTUS KREDEX</name>
 </item>
 </companies>
@@ Line 176: / Line 144: @@
 </SOAP-ENV:Envelope>
 </pre>
 === Vigased päringud ===

Rait: /* SOAP päringu näide */

2009-09-18T07:57:09Z

SOAP päringu näide

← Older revision		Revision as of 10:57, 18 September 2009
Line 37:		Line 37:
	<m:findCompanies xmlns:m="urn:KiCompany" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">		<m:findCompanies xmlns:m="urn:KiCompany" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
	<name xsi:type="xsd:string">kredi</name>		<name xsi:type="xsd:string">kredi</name>
	<count xsi:type="xsd:int">10</count>		<count xsi:type="xsd:int">2</count>
	</m:findCompanies>		</m:findCompanies>
	</SOAP-ENV:Body>		</SOAP-ENV:Body>
Line 43:		Line 43:
	</pre>		</pre>

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

	== curl kasutamine ==		== curl kasutamine ==

Rait: /* Võrgu test */ typo

2009-09-18T07:55:53Z

Võrgu test: typo

← Older revision		Revision as of 10:55, 18 September 2009
Line 8:		Line 8:
	== Võrgu test ==		== Võrgu test ==

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


Line 25:		Line 25:

	Samuti peaks olema võimalik ühenduda sama serveri tcp porti <tt>80</tt>, kust leiab [http://www.w3.org/TR/wsdl wsdl] failid ning sellesama wiki. Kui test ei õnnestu, tuleks pöörduda oma võrguadministraatori poole.		Samuti peaks olema võimalik ühenduda sama serveri tcp porti <tt>80</tt>, kust leiab [http://www.w3.org/TR/wsdl wsdl] failid ning sellesama wiki. Kui test ei õnnestu, tuleks pöörduda oma võrguadministraatori poole.


	== SOAP päringu näide ==		== SOAP päringu näide ==

Sass: moved Testimine123 to SOAP teenuse testimine

2009-09-17T12:33:25Z

moved Testimine123 to SOAP teenuse testimine

← Older revision	Revision as of 15:33, 17 September 2009
(No difference)

Sass: v2

2009-09-17T12:20:48Z

Show changes

Sass: nipetnäpet

2009-09-16T13:34:51Z

nipetnäpet

← Older revision		Revision as of 16:34, 16 September 2009
Line 7:		Line 7:
	Testimaks, ega mõni tulemüür vahele ei sega võib kasutada programmi netcat:		Testimaks, ega mõni tulemüür vahele ei sega võib kasutada programmi netcat:
	nc -z -vv services.krediidiinfo.ee 443		nc -z -vv services.krediidiinfo.ee 443
	või		või mõnes opsüsteemis
	netcat -z -vv services.krediidiinfo.ee 443		netcat -z -vv services.krediidiinfo.ee 443

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

	Samuti peaks olema võimalik ühenduda ka porti 80, kust leiab wsdl failid.		Samuti peaks olema võimalik ühenduda ka porti 80, kust leiab wsdl failid. Kui test ei õnnestu, tuleks pöörduda oma võrgu administraatori poole.


	~~Esiteks~~ on vaja sertifikaadi faili PEM formaadis, antud näites on failinimeks <tt>cert.pem</tt>. Välja näeb umbes selline:		Päringu tegemiseks on esiteks vaja sertifikaadi faili PEM formaadis, antud näites on failinimeks <tt>cert.pem</tt>. Välja näeb umbes selline:
	<pre>		<pre>
	-----BEGIN CERTIFICATE-----		-----BEGIN CERTIFICATE-----
Line 29:		Line 29:
	-----END CERTIFICATE-----		-----END CERTIFICATE-----
	</pre>		</pre>


	Teiseks ka sertifikaadi võtme faili PEM formaadis, siin failinimeks <tt>key.pem</tt>. See fail on salajane ning ei tohi kellegagi jagada ning kindlasti emaili teel või muul krüptimata viisil mitte vahendada!		Teiseks ka sertifikaadi võtme faili PEM formaadis, siin failinimeks <tt>key.pem</tt>. See fail on salajane ning ei tohi kellegagi jagada ning kindlasti emaili teel või muul krüptimata viisil mitte vahendada!
Line 76:		Line 77:
	-d võti määrab päringu, @ failinime ees ütleb curl'ile, et tegemist on päringufaili, mitte päringu endaga.		-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 ~~asukohta~~. Tuleb kasutada "absolute path"-i, curl ei otsi faili antud kataloogist, seetõttu ka <tt>$PWD</tt> antud näites.		--cert võti määrab sertifikaadi faili asukoha. Tuleb kasutada "absolute path"-i. curl ei otsi faili antud kataloogist, seetõttu ka <tt>$PWD</tt> antud näites.
	Kui võti on krüpteeritud, saab võtme ette anda nagu näites serdifikaadi ~~faili~~ taga, eraldades selle failinimest kooloniga. Kui parooli käsureal ei määra, küsitakse seda peale curli käivitamist.		Kui võti on krüpteeritud, saab võtme ette anda nagu näites serdifikaadi failinime taga, eraldades selle failinimest kooloniga. Kui parooli käsureal ei määra, küsitakse seda vajadusel peale curli käivitamist.

	--key määrab võtmefaili asukoha. Kui sertifikaat ja võtmefail on üheks liidetud, siis seda võtit vaja ei ole.		--key määrab võtmefaili asukoha. Kui sertifikaat ja võtmefail on üheks liidetud, siis seda võtit vaja ei ole.

Sass: ver1

2009-09-16T13:01:17Z

ver1

New page

KiCompany SOAP teenuse testimine kasutades <tt>curl</tt> programmi ning autentimiseks sertifikaadi ja selle võtme paari. Kui see test kliendi keskkonnas õnnestub, siis saab väita, et kliendile väljastatud sertifikaat toimib ning õigused KiCompany kasutamiseks paigas.

Vaja läheb kahte või kolme faili ning toimivat SSL toega curl programmi. Keskkond, millest päring tehakse, peab saama ühendada services.krediidiinfo.ee serverisse porti 443, Krediidiinfo AS poolt ei ole IP põhiseid piiranguid sellele teenusele.

Testimaks, ega mõni tulemüür vahele ei sega võib kasutada programmi netcat:
nc -z -vv services.krediidiinfo.ee 443
või
netcat -z -vv services.krediidiinfo.ee 443

Positiivne tulemus on:
Connection to services.krediidiinfo.ee 443 port [tcp/https] succeeded!

Samuti peaks olema võimalik ühenduda ka porti 80, kust leiab wsdl failid.

Esiteks on vaja sertifikaadi faili PEM formaadis, antud näites on failinimeks <tt>cert.pem</tt>. Välja näeb umbes selline:
<pre>
-----BEGIN CERTIFICATE-----
MIIEPpuguyIHJPOHuiGIOGilUYGOIGIYFGuyFUYGpioghIPUgpuigÜkGA1UEBhMC
RUUxETAPiugUIOuphLBLUpuGIUIGigIPUbhpuiGIPYBuYBUKBLJYHFGuohGDVQQK
Ew9LcmVkaWlkaWluZm8gQVMxCzAJBgNVBAsTAklUMSEwHwYDVQQDExhzZXJ2aWNl
cy5rcmVkaWlkaWluZm8uZWUxITAfBgkqhkiG9w0BCQEWEml0QGtyZWRpaWRpaW5m
by5lZTAeFw0wOTglgkGIOUGpguPIUgvIpiughphPhOPOUhpBHIUGMQswCQYDVQQG
EwJFRTEQMA4GA1UECBMHRXN0b25pYTEQMA4GA1UEBxMHVGFsbGlubjEYMBYGA1UE
VMtxvrdTVDhtRBDJrdYRBDRVBDTJrbDJBYYJRdYrdjbyRBUYRdBYJRdRRbUJrRYJ
MTCMjfgukfgKGYGOYOUYGOygouYalsuUUGS4OCtgtrmzLw==
-----END CERTIFICATE-----
</pre>

Teiseks ka sertifikaadi võtme faili PEM formaadis, siin failinimeks <tt>key.pem</tt>. See fail on salajane ning ei tohi kellegagi jagada ning kindlasti emaili teel või muul krüptimata viisil mitte vahendada!

Samas võib selle faili sisu otsa liita <tt>cert.pem</tt> failile <tt>(cat key.pem >> cert.pem)</tt>, siis ei pea võtmefaili <tt>curl</tt>'le eraldi ette näitama. Näeb umbes selline välja, DSA variandi puhul on natuke rohkem erinevusi:
<pre>
-----BEGIN RSA PRIVATE KEY-----
Proc-Type: 4,ENCRYPTED
DEK-Info: DES-EDE3-CBC,C1AA09832249D61D

P85/RJFo2AX638mWtcOTglgkGIOUGpguPIUgvIpiughphPhOPOUhi0I+l5s+JSn5c
jx69XBvi5L+Ytci9RW3zUiWrUDv89IY6DEmwluLX39/gX0TW7U+wos5b7ng/sNLQ
tMyzCtIDACoGb5xHl48c3vY3JUzhrzQWNt2vuFjpGJI1lSOH8h0MdbQEA8iFKIOZ
ng0po3SPW8c5wJtnLuKy8uZWUxITAfBgkqhkiG9w0BCQEWEml08uZWUxITAfBgkq
oHeRz6KkZyXo7vbCbDXSFTuSHiwVwslF7hHbmmiPc4RYxB2EWfTjSUe8Fti9SWPa
iJY0OisiQbePnEigZhfRboVZmQZFPWopgy8uZWUxITAfBgkqhkiG9w0BCQEWEml0
8W1aXSBnNqtla1fmKKId9OkhiAZvavtKug8C9i27R2KR63h6uwq3ktwYtV1YWTHK
Orx8Mf3HIGXpRSJJqjvZUu+xNrM06VcVajY9SJmt7OYXvSo5nKYguwbfGNh/FA7F
Eo1KoKhQeGvWfCQzhEobc/QyegnklbaCUZhePoiL0Jk6Otgsav+2AA==
-----END RSA PRIVATE KEY-----
</pre>

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

Kolmandaks on vaja soap päringut, hoiame seda teksifailis nimega <tt>data.txt</tt>, faili sisu järgnev:
<pre>
<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">krediidiinfo</name>
<count xsi:type="xsd:int">10</count>
</m:findCompanies>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</pre>

Antud päring otsib firmasid, mis algavad stringiga <tt>krediidiinfo</tt> ning ei kuva rohkem kui 10 esimest vastust. (Päring on tasuline!)

Päringu teostamine:
<pre>
curl -d @data.txt -cert $PWD/cert.pem:abcd1234 --key $PWD/key.pem https://services.krediidiinfo.ee/soap.php?name=KiCompany
</pre>

-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 asukohta. Tuleb kasutada "absolute path"-i, curl ei otsi faili antud kataloogist, seetõttu ka <tt>$PWD</tt> antud näites.
Kui võti on krüpteeritud, saab võtme ette anda nagu näites serdifikaadi faili taga, eraldades selle failinimest kooloniga. Kui parooli käsureal ei määra, küsitakse seda peale curli käivitamist.

--key määrab võtmefaili asukoha. Kui sertifikaat ja võtmefail on üheks liidetud, siis seda võtit vaja ei ole.

Õnnestunud tulemus (lisatud reavahetused loetavuse parandamiseks):
<pre>
<?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[1]" xsi:type="ns1:CompanyIDDataArray">
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">10256137</regCode>
<name xsi:type="xsd:string">KREDIIDIINFO AS</name>
</item>
</companies>
</ns1:findCompaniesResponse>
</SOAP-ENV:Body></SOAP-ENV:Envelope>
</pre>