SDK 3.1 Strona 1 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

W przypadku pytań dotyczących instalacji do Państwa dyspozycji pozostaje nasz zespół serwisowy pod numerem telefonu: +49 01805 – 69 11 88 (14 eurocentów/min DTAG) Pon.- Pt. w godz. 9.00 -17.00 E- Mail: [email protected] Dziękujemy za zainteresowanie naszymi rozwiązaniami na stronie www.signaturportal.de.

Dokument ten opisuje techniczne moŜliwości korzystania z usług dostępnych na naszym portalu www.signaturportal.de. W niniejszym dokumencie PDF znajdą Państwo takŜe linki do przykładów i nieodpłatnych kodów źródłowych, które udostępniamy w celu korzystania z usług.

Funkcje związane z kwalifikowanym podpisem elektronicznym mogą być wykorzystywane bezpłatnie przez partnerów OEM firmy Mentana-Claimsoft AG w celu uzupełnienia własnych aplikacji odpowiednimi funkcjami lub oferowania własnych usług ASP. Aby zostać partnerem OEM portalu www.signaturportal.de naleŜy jedynie złoŜyć drogą mailową nieformalny wniosek ([email protected]). Jako partner OEM otrzymają Państwo specjalne warunki ePorto dla swoich klientów oraz marŜę za wielkość sprzedaŜy ePorto Państwa klientów.

SDK 3.1 Strona 2 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

Spis treści

I. Jakie usługi są oferowane? .......................................................................................... 3 1) Jakie funkcje oferują webserwisy SOAP? ................................................................ 3 2) Jakie funkcje oferuje platforma usługowa SMTP? ................................................... 3 II. Opis SMTP- platfforma usługowa ............................................................................... 3 1) Usługa generowania podpisów.................................................................................... 3 2) Usługa weryfikacji .................................................................................................... 4 3) Schemat przebiegu dla SMTP- platformy usługowej „sigmail“ (podpis/weryfikacja/archiwum) ..................................................................................... 4 4) Dane techniczne SMTP- platformy usługowej „sigmail“ ........................................... 5 III. Opis webserwisów SOAP ........................................................................................... 6 1) Ogólna specyfikacja webserwisów SOAP................................................................ 6 2) Schemat przebiegu dla serwisów SOAP.................................................................. 6 3) Specyfikacja techniczna serwisu metody 1 do 12 SOAP WS .................................. 7 2.01. Metoda „test“ ................................................................................................... 8 2.02. Metoda „test_param“ ....................................................................................... 8 2.03. Metoda „sign“ .................................................................................................. 9 2.04. Metoda „sign_extern“..................................................................................... 10 2.05. Metoda „verifiy“ ............................................................................................. 11 2.06. Metoda „verifiy_xml“ ..................................................................................... 12 2.07. Metoda „verifiy_extern“ .................................................................................. 13 2.08. Metoda „verifiy_extern_xml“ ......................................................................... 14 2.09. Metoda „balance“........................................................................................... 14 2.10. Metoda „transfer“ .......................................................................................... 15 2.11. Metode „timestamp“....................................................................................... 16 2.12. Metoda „sha256_timestamp“ ......................................................................... 17 2.13. Opis kodów błędów ....................................................................................... 18 VI. Przykładowi klienci dla funkcji 1 bis 12 ..................................................................... 18 1) Kod źródłowy JAVA ............................................................................................... 18 2) Kod Ŝródłowy Sourcen Perl.................................................................................... 19 3) Kod źródłowy .Net .................................................................................................. 19 4) Kod źródłowy C++ ................................................................................................. 19 5) Cold Fusion............................................................................................................ 19 6) Kod źródłowy PHP ................................................................................................. 20

SDK 3.1 Strona 3 HP.BK.10.02.001

Public- Services/Stand 18.08.2008

I. Jakie usługi są oferowane? Istnieją 2 z technicznego punktu widzenia moŜliwości rozwiązań, które oferowane są na portalu Signaturportal.de. Mogą Państwo wykorzystać albo webserwisy SOAP lub zastosować platformę usługową SMTP„sigmail“ 1)

Jakie funkcje oferują webserwisy SOAP? Funkcja

Krótki opis

1.

Podpis

2.

Weryfikacja

Wymaganie podpisów elektronicznych zgodnie z § 2 nr 3 SigG (Niemiecka Ustawa o podpisach), § 14 ust. 3 UStG (Niemiecka Ustawa o podatku obrotowym) Weryfikacja podpisów w formie XML zgodnie z § 15 UstG

3.

Weryfikacja

Weryfikacja kwalifikowana w formie protokołu wyników w sygnowanym

kwalifikowana

dokumencie PDF wraz datownikiem zgodnie z § 2 nr 14 SigG (GDPdU/GoBS)

4.

Datownik

5.

Przekazywanie

Wymaganie datownika zgodnie z § 2 nr 14 SigG dla wszystkich dokumentów (archiwum). Przekazywanie ePorta między kontami (np. jedno główne konto ePorto jest w stanie obsłuŜyć powiązane konta ePorto)

6.

Rejestracja

Rejestracja konta na Sinaturportal.de z własnej aplikacji. Rejestracja klienta na stronie początkowej signaturportal.de nie jest w tym przypadku juŜ konieczna.

2) Jakie funkcje oferuje platforma usługowa SMTP? Platforma usługowa SMTP „sigmail“ umoŜliwia wysyłanie maili przez platformę SMTP przy wykorzystaniu specjalnych funkcji takich jak podpis czy weryfikacja załączników zgodnie z niemieckim prawem (SigG) lub prawem obowiązującym w 27 krajach europejskich oraz w Szwajcarii.

II. Opis SMTP- platfforma usługowa 1) Usługa generowania podpisów Dzięki tej usłudze dokument PDF będący załącznikiem maila (rachunek), jest podpisany bezpośrednio przy wysyłaniu z serwera SMTP do odbiorcy zgodnie z § 14 ust. 3 UStG, § 2 nr 3 SigG. Stosując ustawienia opcjonalne na www.signaturportal.de mogą Państwo skorzystać z dodatkowych funkcji dla tej usługi: a) Utworzyć kopię sygnowanego rachunku w rejestrze IMAP b) Wysłać kopię sygnowanego rachunku na dodatkowy adres mailowy c) Państwa adres mailowy będzie wpisany jako ‚reply to‘ (adres, na który wysyłane będą odpowiedzi)

SDK 3.1 Strona 4 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

d) Stworzyć protokół weryfikacji i dołączyć go do maila (1 ePorto) e) Skonfigurować proxy, aby korzystać z własnej domeny mailowej. f)

Archiwizacja podpisanych rachunków wyjściowych w archiwum

2) Usługa weryfikacji Na platformie usługowej SMTP „sigmail“ tworzone są konta POP3/IMAP, które pozwalają na zastosowanie specjalnych funkcji przy odbiorze poczty. W ten sposób dokument PDF będący załącznikiem maila (rachunek) moŜe być bezpośrednio weryfikowany na serwerze SMTP podczas odbioru maila na adres [email protected] zgodnie z § 15 UStG. Stworzony zostaje protokół wymagany prawem GDPdU/GOBS oraz datownik zgodny z § 2 Nr.14 SigG i dołączone zostają one jako załącznik 2 do maila tak, Ŝe odbierając maila przy uŜyciu lokalnego klienta e-mail równocześnie spełnione są wszystkie zobowiązania podatkowo-prawne.

Stosując ustawienia opcjonalne na www.signaturportal.de mogą Państwo skorzystać z dodatkowych funkcji dla tej usługi: a) opracowywanie archiw ZIP (np. Telekom, 1&1 etc) b) przesyłanie poczty przychodzącej na inne adresy referencyjne i inne adresy mailowe c) stworzenie kopii rachunków weryfikowanych w archiwum online

3) Schemat przebiegu dla SMTP- platformy usługowej „sigmail“ (podpis/weryfikacja/archiwum)

SDK 3.1 Strona 5 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

4) Dane techniczne SMTP- platformy usługowej „sigmail“ Jeśli Państwa aplikacja wspiera ustawienia konta e-mail na platformie SMTP proszę podać następujące dane:

Jeśli muszą Państwo najpierw stworzyć wiadomość mailową w Państwa aplikacji proszę postępować następująco: Aby korzystać z serwera podpisów SMTP, muszą Państwo stworzyć wiadomość SMTP zawierającą określone parametry. Proszę wykorzystać nasze przykłady: www.signaturportal.de/freware/ebilling-signature-php-mail-script.zip

Proszę wziąć pod uwagę, Ŝe dopuszczamy jedynie połączenia SMTP zabezpieczone SSL. Przede wszystkim najpierw muszą Państwo zarejestrować się na stronie www.signaturportal.de i dostarczyć dane uŜytkownika do skryptu! Proszę skonfigurować najpierw standardowego klienta maila, aby wykluczyć źródła błędów związanych z rejestracją konta.

SDK 3.1 Strona 6 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

III. Opis webserwisów SOAP 1) Ogólna specyfikacja webserwisów SOAP Wszystkie oferowane serwisy bazują na otwartych standardach, takich jak Simple Object Access Protocol - 'SOAP' (patrz http://www.w3.org/TR/SOAP/), oraz Web-Service-Description-Language - 'WSDL' (patrz http://www.w3.org/TR/wsdl). SOAP jest protokołem transportu, który opisuje, w jaki sposób serwisy sieciowe wysyłają Państwa wiadomości przez internet. Protokół ten jest niezaleŜny od zawartości wiadomości czy stosowanej platformy rozwoju oraz języka programowania. Standard WSDL jest odpowiedzialny za opis zawartości wiadomości. Definicja ta opisana jest w pliku XML, który stosowany jest do implementacji aplikacji klienta.

Plik WSDL do serwisu podpisów zgodny z niemieckim prawem (SigG) oraz prawem obowiązującym w 27 państwach europejskich oraz Szwajcarii (funkcje 1 do 12) otrzymają Państwo pod: https://www.signaturportal.de/wsdl/smmi_basic.wsdl

Opis oraz URL do serwisu rejestracji (funkcja 6) prześlemy Państwu po kontakcie telefonicznym oraz rejestracji. Proszę zgłosić się pod numerem +49 01850-691188

2) Schemat przebiegu dla webserwisów SOAP

SDK 3.1 Strona 7 HP.BK.10.02.001

Public- Services/Stand 18.08.2008

3) Specyfikacja techniczna serwisu metody 1 do 12 SOAP WS Metoda 1.1

test

Krótki opis Metoda słuŜąca przeprowadzeniu testu połączenia z webserwerem od strony klienta

1.2

test_param

Metoda słuŜąca przeprowadzeniu testu połączenia od strony klienta przy zastosowaniu danych rejestracyjnych do serwisu

1.3

sign

Wymaganie kwalifikowanego podpisu elektronicznego zgodnie z §2 nr 3 SigG w formie podpisu będącego częścią składową dokumentu PDF Dane wejściowe: dokument PDF 1.4 -1.6 Wynik: dokument PDF 1.4 -1.6 z zawartym podpisem

1.4

sign_extern

Wymaganie kwalifikowanego podpisu elektronicznego zgodnie z §2 nr 3 SigG w formie struktury CMS/ PKC#7 Dane wejściowe: dowolny plik Wynik: struktura CMS/ PKC#7

1.5

verify

Wymaganie protokołu weryfikacyjnego: Dane wejściowe: dokument PDF 1.4 -1.6 z zawartym podpisem Wynik: protokół weryfikacyjny w formie dokumentu PDF

1.6

verify_xml

Wymaganie protokołu weryfikacyjnego: Dane wejściowe: dokument PDF 1.4 -1.6 z zawartym podpisem Wynik: protokół weryfikacyjny w formie dokumentu XML

1.7

verify_extern

Wymaganie protokołu weryfikacyjnego: Dane wejściowe: dowolny dokument + struktura CMS/ PKC#7 Wynik: protokół weryfikacyjny w formie dokumentu PDF.

1.8

verify_extern_xml

Wymaganie protokołu weryfikacyjnego: Dane wejściowe: dowolny dokument + struktura CMS/ PKC#7 Wynik: protokół weryfikacyjny w formie dokumentu XML.

1.9

balance

Metoda słuŜąca sprawdzaniu stanu konta ePorto

2.0

transfer

Metoda słuŜąca transferowi ePorta między kontami

2.1

timestamp

Metoda wymuszająca funkcję datownik §2 nr 14 SigG, przy zastosowaniu SHA 256/ mind. RSA 2048 podczas transferu kompletnego dokumentu. Dane wejściowe: dowolny plik Wynik: Timestamp.tsr (dokument zawierający datownik)

2.2

sha256_timestamp

Metoda wymuszająca funkcję datownik §2 nr 14 SigG, przy zastosowaniu SHA 256/ mind. RSA 2048 podczas transferu wartości hash dokumentu. Dane wejściowe: SHA 256 String Wynik: Timestamp.tsr. (dokument zawierający datownik)

SDK 3.1 Strona 8 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

2.01. Metoda „test“ Returns a string

Wywołanie metody „testRequest“ następuje bez podania dalszych parametrów. Wynik zawiera xsd- string jak poniŜej: " Test funktioniert ~:)"

2.02. Metoda „test_param“ - Test text you send to the service. - - Returns some response text

Wywołanie metody „test_param“ następuje przy podaniu następujących parametrów i zawiera: $text :: = tutaj podany moŜe być dowolny tekst Wynik zawiera xsd- string o następującej konstrukcji:

SDK 3.1 Strona 9 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

2.03. Metoda „sign“ - Your UserName - Your GatewayPassword - Your Konto Number - The name of the file you like to put the signature on. - Your file as a binary encoded with base64# - −Optional your signature card region (two-digit ISO Code) − −Optional the language for your signature description (two-digit ISO Code) − − Returns your file (in binary mode encoded with base64) with the signature

Wywołanie metody „signRequest“ następuje przy podaniu następujących parametrów i zawiera: $username

:: = nazwa uŜytkownika na portalu Signaturportal.de

$passwort

:: = hasło gateway (nie hasło login!)

$kontoNr

:: = numer konta portalu Signaturportal.de (np. 1010101010)

$dateiname

:: = nazwa dokumentu, który ma być podpisany (konieczne jest podanie rozszerzenia

“.pdf“) $data

:: = dokument PDF zakodowany w systemie base64Binary

$region

:: = drugi znak kodu ISO danego kraju

$lang

:: = drugi znak kodu ISO języka

SDK 3.1 Strona 10 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

Wynik zawiera odpowiedź response = 200, co oznacza błąd. Proces nie powiódł się lub zwracany zostaje podpisany dokument PDF („xxxx.pdf“) zakodowany w systemie xsd:base64Binary.

2.04. Metoda „sign_extern“ − Your UserName − Your GatewayPassword − Your Konto Number − −The name of the file you like to put the signature on. − Your file as a binary encoded with base64# − −Optional your signature card region (two-digit ISO Code) − −Optional the language for your signature description (two-digit ISO Code) − − −Returns the extern signature of your file (in binary mode encoded with base64)

Wywołanie metody „signRequest“ następuje przy podaniu następujących parametrów: $username

:: = nazwa uŜytkownika na portalu Signaturportal.de

$passwort

:: = hasło gateway (nie hasło login!)

$kontoNr

:: = numer konta portalu Signaturportal.de (np. 1010101010)

SDK 3.1 Strona 11 Public- Services/Stand 18.08.2008 $dateiname $data $region $lang

HP.BK.10.02.001

:: = nazwa dokumentu, który ma być podpisany :: = dokument PKCS#7, który ma być podpisany zakodowany w systemie base64Binary :: = drugi znak kodu ISO danego kraju :: = drugi znak kodu ISO języka

Wynik zawiera odpowiedź response = 200, co oznacza błąd. Proces nie powiódł się lub odpowiedź w formie pliku xsd:base64Binary w formacie PKC#7 File („xxxx.p7s/PkcS/etc.“).

2.05. Metoda „verifiy“ - Your UserName - Your GatewayPassword - Your Konto Number - The name of the file you like to verify. - Your file as a binary encoded with base64 − −Optional your signature card region (two-digit ISO Code) − −Optional the language for your signature description (two-digit ISO Code) - - Returns a file (in binary mode encoded with base64) with the result of the verification.

SDK 3.1 Strona 12 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

Wywołanie metody „verifyRequest“ następuje przy podaniu następujących parametrów: $username

:: = nazwa uŜytkownika na portalu Signaturportal.de

$passwort

:: = hasło gateway (nie hasło login!)

$kontoNr

:: = numer konta portalu Signaturportal.de (np. 1010101010)

$dateiname

:: = nazwa dokumentu, który ma być podpisany (konieczne jest podanie rozszerzenia

“.pdf“) $data

:: = dokument PDF zakodowany w systemie base64Binary

$region

:: = drugi znak kodu ISO danego kraju

$lang

:: = drugi znak kodu ISO języka

Wynik zawiera odpowiedź response = 200, co oznacza błąd. Proces nie powiódł się lub zwracany jest plik xsd:base64Binary zawierający podpisany dokument PDF („xxxx_verifikationsprotokoll.pdf“).

2.06. Metoda „verifiy_xml“ Patrz 2.5. Odpowiedź zwraca, w przypadku nie wystąpienia błędu, plik zakodowany xsd:base64Binary, zawierający dokument XML („xxxx_verifikationsprotokoll.xml“).

SDK 3.1 Strona 13 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

2.07. Metoda „verifiy_extern“ − Your UserName − Your GatewayPassword − Your Konto Number − The name of the file you like to verify. − Your file as a binary encoded with base64 − The name of the extern signature file. − − Your extern signature file as a binary encoded with base64 − −Optional your signature card region (two-digit ISO Code) − −Optional the language for your signature description (two-digit ISO Code) − − − Returns a file (in binary mode encoded with base64) with the result of the verification.

SDK 3.1 Strona 14 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

Wywołanie metody „verify_externRequest“ następuje przy podaniu następujących parametrów i zawiera: $username

:: = nazwa uŜytkownika na portalu Signaturportal.de

$passwort $kontoNr $dateiname $data

:: = hasło gateway (nie hasło login!) :: = numer konta portalu Signaturportal.de (np. 1010101010) :: = nazwa dokumentu, który ma być podpisany :: = podpisany dokument PDF zakodowany w systemie base64Binary

$sigdateiname $sigdata $region $lang

:: = nazwa dokumentu zawierającego podpis :: = dokument, który ma być podpisany zakodowany w systemie base64Binary :: = drugi znak kodu ISO danego kraju :: = drugi znak kodu ISO języka

Wynik zawiera odpowiedź response = 200, co oznacza błąd. Proces nie powiódł się lub dostarczany jest plik xsd:base64Binary zawierający dokument PDF („xxxx_verifikationsprotokoll.pdf“).

2.08. Metoda „verifiy_extern_xml“ Odpowiedź dostarcza, w przypadku nie wystąpienia błędu, plik xsd:base64Binary, zawierający dokument XML („xxxx_verifikationsprotokoll.xml“).

2.09. Metoda „balance“ - Your UserName - Your GatewayPassword - Your Konto Number - - Returns your current amount of eporto on your account.

Wywołanie metody „balanceRequest“ następuje przy podaniu następujących parametrów i zawiera: $username

:: = nazwa uŜytkownika na portalu Signaturportal.de

$passwort

:: = hasło gateway (nie hasło Login!)

$kontoNr

:: = numer konta portalu Signaturportal.de (np. 1010101010)

SDK 3.1 Strona 15 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

Wynik zawiera stan konta jako wartość pozytywną lub negatywną

2.10. Metoda „transfer“ - Your UserName - Your GatewayPassword - Your Konto Number - The kontoNr of the account you like to transfer eporto. Only positive amount is allowed. - The amount you like to transfer. - - Returns the amount that was successful transferd.

Wywołanie metody „transferRequest“ następuje przy podaniu następujących parametrów:

$username

:: = nazwa uŜytkownika na portalu Signaturportal.de

$passwort

:: = hasło gateway (nie hasło login!)

$kontoNr

:: = numer konta portalu Signaturportal.de (np. 1010101010)

$targetkontoNr $amount

:: = numer konta portalu Signaturportal.de, na które mają być przesyłane ePorto :: = liczba ePorto, jakie mają być przesłane

Wynik zwraca odpowiedź 100 w przypadku, gdy nie wystąpiły błędy lub xxx w przypadku kodu błędu.

SDK 3.1 Strona 16 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

2.11. Metode „timestamp“ − Your UserName − Your GatewayPassword − Your Konto Number − −The name of the file you like to get the timestamp for. − Your file as a binary encoded with base64# − − −Returns the timestamp of your file (in binary mode encoded with base64)

Wywołanie metody „timestampRequest“ następuje przy podaniu następujących parametrów i zawiera: $username

:: = nazwa uŜytkownika na portalu Signaturportal.de

$passwort

:: = hasło gateway (nie hasło login!)

$kontoNr

:: = numer konta portalu Signaturportal.de (np. 1010101010)

$dateiname

:: = nazwa pliku, który ma być podpisany

$data

:: = plik zakodowany w systemie base64Binary

Wynik zawiera odpowiedź response = 200, co oznacza błąd. Proces nie powiódł się lub zwracany jest plik .tsr („xxxx_zeitstempel.tsr“). zakodowany xsd:base64Binary.

SDK 3.1 Strona 17 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

2.12. Metoda „sha256_timestamp“ − Your UserName − Your GatewayPassword − Your Konto Number − −The name of the file you like to get the timestamp for. − Your file as a binary encoded with base64# − − −Returns the timestamp of your file (in binary mode encoded with base64)

Wywołanie metody „timestampRequest“ następuje przy podaniu następujących parametrów i zawiera: $username

:: = nazwa uŜytkownika na portalu Signaturportal.de

$passwort

:: = hasło gateway (nie hasło login!)

$kontoNr

:: = numer konta portalu Signaturportal.de (np. 1010101010)

$dateiname

:: = nazwa dokumentu, który ma być podpisany

$data

:: = wartość Hash SHA256 zakodowanego w systemie base64Binary dokumentu

Wynik zawiera odpowiedź response = 200, co oznacza błąd. Proces nie powiódł się lub zwracany jest plik .tsr („xxxx_zeitstempel.tsr“) zakodowany xsd:base64Binary.

SDK 3.1 Strona 18 HP.BK.10.02.001

Public- Services/Stand 18.08.2008

2.13. Opis kodów błędów 100 – błąd ogólny (bliŜej nie określone przerwanie połączenia) 200 – błędne dane uŜytkownika 210 - błędne dane konta -> sprawdzić numer konta (soap:Client.Userdata) 220 – błędna nazwa uŜytkownika - hasło -> uŜyj hasła Gateway (soap:Client.Authentication) 300 - niewaŜne konto (brakujące dane uŜytkownika/uprawnienia) 310 – uprawnienia do podpisywania/weryfikowania nie zostało jeszcze przydzielone / odebrane (soap:Client.UserPermissions) 311 – brak uprawnień do sparowania (soap:Client.UserPermissions) 312 – brak dokumentu potwierdzającego autoryzację (soap:Client.UserPermissions) 313 - niepełne informacje o firmie (soap:Client.UserPermissions) 320 - brak wystarczającej ilości ePorto na koncie (soap:Client.Solvent) -> konto zablokowane, przekroczony dzienny kontyngent, stan konta 0 i brak jednolitego klienta 400 – błąd przetwarzania 410 – błąd wstępnego przetwarzania 411 - nieudane załączenie dokumentu potwierdzającego autoryzację (soap:Server) 420 - błąd przetwarzania głównego (PDF-dll) 421 – błąd generowania podpisu (soap:Server) 422 – błąd weryfikacji (soap:Server) 423 - błąd generowania datownika (soap:Server) 424 - błąd w odczycie stanu konta (soap:Server)

VI. Przykładowi klienci dla funkcji 1 bis 12 1) Kod źródłowy JAVA Aktualną wersję znajdą Państwo: https://www.signaturportal.de/freeware/ebilling-signature-java.zip https://www.signaturportal.de/freeware/ebilling-signature-java-commandline.zip https://www.signaturportal.de/freeware/ebilling-signature-java.rar https://www.signaturportal.de/freeware/ebilling-signature-java-commandline.rar SDK zawiera projekt JAVA stworzony do tworzenia i sprawdzania rachunków elektronicznych. sigportalrunner2.0_java.1.5.tgz Java

SDK

1.5.0,

najnowsza

wersja

do

ściągnięcia

na

http://java.sun.com/javase/downloads/index_jdk5.jsp Zalecane jest stosowanie najnowszej wersji Javy. sigportalrunner2.0_java.1.6.tgz Java SDK 1.6.0, najnowsza wersja do ściągnięcia na http://java.sun.com/javase/downloads/index.jsp W Linuxie moŜna zainstalować pakiety przy pomocy managera pakietów (z.B. YAST pod Suse) lub przy pomocy ściągniętych kodów źródłowych. Instalacja pod systemem Windows następuje zasadniczo przez instalatora Javy, dla odpowiedniej wersji. Pozostałe pakiety/programy nie są konieczne. Instalacja Sigportalrunner: W zaleŜności od wersji Javy odpowiednia dystrybucja jest rozpakowywana za pomocą programu archiwizującego w rejestrze docelowym (tworzonym przez uŜytkownika).

SDK 3.1 Strona 19 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

Pod Linux-em wywołanie dla GNU-tar wyglądałoby następująco: 'cd /...../meinZielverzeichnis/; tar xzf sigportalrunner2.0_java.1.6.tgz' Wywołanie: Korzystamy z komendy signalport wykonywanej z linii poleceń. W tym celu uŜytkownik modyfikuje plik z parametrami instalacji. Przed pierwszym wywołaniem wprowadza następujące dane 'username', 'passwort', 'region', 'lang' und 'accountid' w pliku sigportal.properties. Wywołanie linii poleceń: 'sigportal [signaturefile] [outputfile] Przy czym: * method = [sign|sign_extern|verify|verify_extern|verify_xml|verify_extern_xml|timestamp|sha256_timestamp|test|test_param] * inputfile – plik danych wejściowych * signaturefile – plik zawierający podpis (tylko przy method=verify_extern) * outputfile – wyjściowy plik danych (przy braku parametrów nadpisywany jest plik wejściowy) Po wykonaniu komendy sigportal zwraca następujące wartości: * 0 - pomyślnie * 1 - błąd konfiguracji * 2 - błąd usługi * 3 - błąd wejścia/wyjścia * 4 - nie wystarczający stan konta * 5 - błędne lub brakujące parametry

2) Kod Ŝródłowy Sourcen Perl Aktualną wersję znajdą Państwo pod: https://www.signaturportal.de/freeware/ebilling-signature-perl.zip https://www.signaturportal.de/freeware/ebilling-signature-perl-commandline.zip https://www.signaturportal.de/freeware/ebilling-signature-perl.rar https://www.signaturportal.de/freeware/ebilling-signature-perl-commandline.rar

3) Kod źródłowy .Net Aktualną wersję znajdą Państwo pod: https://www.signaturportal.de/freeware/ebilling-signature-csharp.zip https://www.signaturportal.de/freeware/ebilling-signature-vb.zip

4) Kod źródłowy C++ W celu utworzenia datowników, podpisów oraz weryfikacji mogą Państwo takŜe uŜywać udostępnionego C ++“ SDK. Prosimy o kontakt z naszym suportem. Program zostanie wysłany na CD. 5) Cold Fusion W celu utworzenia datowników, podpisów oraz weryfikacji mogą Państwo takŜe uŜywać Cold Fusion. Prosimy o kontakt z naszym suportem. Program zostanie wysłany na CD.

SDK 3.1 Strona 20 Public- Services/Stand 18.08.2008

HP.BK.10.02.001

6) Kod źródłowy PHP Aktualną wersję znajdą Państwo pod: https://www.signaturportal.de/freeware/ebilling-signature-php.zip https://www.signaturportal.de/freeware/ebilling-signature-php.rar

W przypadku pytań proszę skorzystać z jednego z poniŜszych kontaktów: Hotline: +49 01805/ 691188 (14 eurocentów/min., cena za połączenie z telefonu komórkowego moŜe odbiegać od podanej) Pon.- Pt. w godz. 9.00-17.00 E- Mail: [email protected]