Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 1 Webservicetest mit soapui Version 1.2
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 2 Inhaltsverzeichnis 1 Übersicht... 3 1.1 Dokumentenverlauf... 3 1.2 Einführung... 3 2 Voraussetzungen... 4 2.1 Download von soapui... 4 2.2 Download von notepad++... 4 2.3 Notepad++ Plugin... 4 2.4 Erstellen eines Test Projekts in soapui... 5 3 Testen in soapui... 7 3.1 TestFunktion... 7 3.2 Test_paramFunktion... 9 3.3 SignFunktion... 10 3.4 Base64 Encodierung... 11 3.5 Signierung... 13 3.6 Base64 Decodierung... 14 3.7 Verify Funktion... 15
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 3 1 Übersicht 1.1 Dokumentenverlauf Version Bearbeiter Inhalt Datum 1.0 André Schaffrath Entwurf 19.06.2008 1.0 Raoul Kirmes Freigabe 20.06.2008 1.1 Patrick Wedekind Update 19.09.2011 1.2 Einführung Vielen Dank, das Sie sich entscheiden haben die Webservices auf www.signaturportal.de zu nutzen. Dieses Dokument beschreibt die Einrichtung eines Test Tools für Webservices. Wir empfehlen Ihnen, bevor Sie mit der Implementierung in eigenen Applikationen beginnen, unter Nutzung des kostenlosen Testtool soapui, den Webservice mit Ihrem Kundenkonto und Ihren Demo PDF Dokument zu testen. Beginnen Sie erst in Ihrer eigenen Entwicklungsumgebung, wenn alle Methoden unter Nutzung von soapui fehlerfrei funktionieren. Diese grenzt die Fehlermöglichkeiten stark ein und ermöglicht eine erfolgreiche Implementierung in Ihre Entwicklungsumgebung.
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 4 2 Voraussetzungen 2.1 Download von soapui Die aktuellste Version von soapui als Download finden Sie im folgenden Link: http://sourceforge.net/projects/soapui/files Klicken Sie auf den folgenden Link, welcher die Setup Datei beinhaltet: Abbildung 1 2.2 Download von notepad++ Um mit soapui richtig arbeiten zu können, brauchen Sie nun einen Editor der in Base64 en und decodieren kann. Benutzen Sie zu diesem Zweck Notepad++. Unter folgendem Link finden sie die aktuellste Notepad++ Version mit dem entsprechendem Downloadlink: http://sourceforge.net/projects/notepad plus/ Abbildung 2 2.3 Notepad++ Plugin Da Notepad++ standartmäßig nicht mit dem erforderlichen Plugin MIME Tools ausgestattet ist, laden Sie es sich unter folgendem Link herunter: http://download.tuxfamily.org/nppplugins/mimetools/mimetools.v1.7.zip Öffnen Sie das zip Archiv und entpacken Sie die darin enthaltene *.dll Datei in das plugin Verzeichnis Ihrer Notepad++ Installation. (Standard: C:\programme(x86)\notepad++\plugins )
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 5 2.4 Erstellen eines Test Projekts in soapui Starten Sie ihr soapui und legen Sie ein neues Projekt an. Abbildung 3 Tragen Sie den Projektnamen (in diesem Dokument immer smmi_basic) und die URL des Initial WSDL Projekts ein. Die URL lautet: https://www.signaturportal.de/wsdl/smmi_basic.wsdl Bestätigen Sie anschließend mit OK. Abbildung 4 SoapUI lädt nun das WSDL Projekt auf ihren Client, um die entsprechenden Funktionen testen zu können. Abbildung 5
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 6 Anschließend sehen Sie das importierte Projekt mit seinen verfügbaren Methoden (siehe Abb. 6). Abbildung 6
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 7 3 Testen in soapui Zu den Grundlegenden Funktionen des Webservices gehören: test (Testmethode zum Überprüfen der Verbindung) test_param (Test zur Parameterübergabe) sign (signieren) verify (verifizieren) 3.1 test Funktion Öffnen sie in ihrem soapui das smmi_basic Projekt und die dazugehörige Funktion test. Unter test finden sie nun den Eintrag Request 1. Aktivieren sie diesen via Doppelklick. Abbildung 7
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 8 Nun öffnet sich ein Fenster mit der eigentlichen XML Anfrage: Schicken sie nun die Anfrage an den Server (betätigen sie den grünen Pfeil). Abbildung 8 Sie erhalten folgende Antwort wenn Sie den Server reichen können: Abbildung 9
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 9 3.2 test_param Funktion Öffnen sie in ihrem SoapUI das smmi_basic Projekt und die dazugehörige Funktion test_param. Unter test_param finden sie nun den Eintrag Request 1. Aktivieren Sie diesen via Doppelklick. Abbildung 10 Nun öffnet sich wieder ein Fenster mit einer XML Anfrage: Abbildung 11
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 10 Nun können sie den String nach Belieben ändern (Beispiel: siehe Abbildung 12), um zu testen ob eine Parameterübergabe möglich ist. Schicken sie anschließend die Anfrage an den Server (betätigen sie den grünen Pfeil). Abbildung 12 Sollten Sie diese Antwort (siehe Abbildung 13) erhalten, hat die Parameterübergabe funktioniert. Ist dies nicht der Fall, könnte das auf ein Problem mit der Firewall hinweisen. Abbildung 13 3.3 sign Funktion Öffnen sie in ihrem soapui das smmi_basic Projekt und die dazugehörige Funktion sign. Unter sign finden sie nun den Eintrag Request 1. Aktivieren Sie diesen via Doppelklick. Abbildung 14
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 11 Wieder öffnet sich ein Fenster mit einer XML Anfrage: Abbildung 15 Tragen Sie nun ihre persönlichen Daten an der mit? markierten Stelle ein. Usernamen (Ihr Loginname im Signaturportal) Passwort (Achtung, hier bitte das Gateway Passwort benutzen. Dieses finden Sie in ihrem Signaturportal unter Einstellungen im Kartenreiter Dienste.) Kontonummer (Ihre Signaturportal Kontonummer z.b. 101010****) Dateiname (der Name der Datei die Sie signieren lassen wollen z.b. beispiel.pdf) Data (hier muss der in Base64 codierte Inhalt der Datei eingefügt werden) Region (de = Deutschland) Lang (Language = Sprache; de = deutsch) 3.4 Base64 Encodierung Öffnen sie ihr Notepad++. Nun suchen Sie über Öffnen die zu bearbeitende PDF Datei. Abbildung 16
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 12 Alternativ können Sie auch mit der rechten Maustaste auf die gewünschte *.pdf Datei klicken und wählen dort Edit with Notepad++ aus. Abbildung 17 Markieren Sie nun den gesamten Inhalt des Dokuments (Strg + A). Nun wählen Sie unter Erweiterungen das Untermenü MIME Tools. Dort finden Sie den Punkt Base64 Encode. Nutzen Sie diesen um den Inhalt der Datei (Base64) zu codieren. Abbildung 18 Markieren Sie nun den kompletten Inhalt und kopieren Sie diesen in den Zwischenspeicher (Strg+C). Abbildung 19
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 13 3.5 Signierungsprozess Nun lässt sich die Base64 Zeichenfolge bequem im soapui einfügen. Schicken Sie nun die Anfrage an den Server (betätigen sie den grünen Pfeil). Abbildung 20 Einige Sekunden später sollten Sie eine Antwort vom Server erhalten (siehe Abbildung 21). Abbildung 21 Kopieren Sie nun die Base64 Zeichenfolge aus der Antwort in ihr Notepad++ und decodieren Sie diese.
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 14 3.6 Base64 Decodierung Öffnen Sie in Ihrem Notepad++ eine neue Datei. Kopieren Sie nun den zu decodieren Inhalt in die neue Datei. Abbildung 22 Markieren Sie nun den gesamten Inhalt des Dokuments (Strg + A). Nun wählen Sie unter Erweiterungen das Untermenü MIME Tools. Dort finden Sie den Punkt Base64 Decode. Nutzen Sie diesen Punkt um die Base64 Zeichenfolge zu decodieren. Abbildung 23 Speichern sie anschließend diese Datei unter dem in der Anfrage verwendeten Dateinamen (testpdf.pdf). Wenn Sie nun das erstellte PDF Dokument öffnen, sollte dieses signiert sein. Abbildung 24 Wenn Sie nun das erstellte PDF Dokument öffnen, sollte dieses signiert sein.
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 15 3.7 Verify Funktion Öffnen sie in ihrem SoapUI das smmi_basic Projekt und die dazugehörige Funktion verify. Dort finden sie nun den Eintrag Request 1. Aktivieren sie diesen via Doppelklick. Abbildung 25 Folgendes Fenster Öffnet sich: Abbildung 26
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 16 Tragen Sie nun ihre persönlichen Daten an der mit? markierten Stelle ein. Usernamen (Ihr Loginname im Signaturportal) Passwort (Achtung, hier bitte das Gateway Passwort benutzen. Dieses finden Sie in Ihrem Signaturportal unter Einstellungen im Kartenreiter Dienste.) Kontonummer (Ihre Signaturportal Kontonummer z.b. 101010****) Dateiname (der Name der Datei die Sie verifizieren lassen wollen (in dem Fall jetzt: die vorangegangene signierte Datei: testpdf.pdf; Merke: nur signierte Dateien nutzen) Data (hier muss der in Base64 codierte Inhalt der Datei eingefügt werden) Region (de = Deutschland) Lang (Language = Sprache; de = Deutschland) Führen Sie erneut eine Base64 Encodierung (gem. Punkt 3.4) mit einer signierten *.pdf Datei durch und fügen den Base64 Code in die Data Zeile ein und schicken sie die Anfrage an den Server (betätigen sie den grünen Pfeil). Abbildung 27 Einige Sekunden später sollten Sie eine Antwort vom Server erhalten (siehe Abbildung 28). Kopieren Sie nun die Base64 Zeichenfolge aus der Antwort und decodieren diese (gem. Punkt 3.6).
Mentana Claimsoft GmbH NL Berlin/Brandenburg Seite 17 Abbildung 28 Speichern sie anschließend diese Datei (als.pdf WICHTIG: verwenden Sie hierfür einen neuen Dateinamen!!!). Wenn Sie nun das erstellte PDF Dokument öffnen, sehen sie das Verifikationsprotokoll zur ursprünglichen Datei (testpdf.pdf) vor sich. Abbildung 29 Haben Sie weitere Fragen? Nutzen Sie einen der nachfolgenden Kontakte: Hotline: 01805/ 691188 (12 Cent/min.) Mo. Sa. 7.00 Uhr bis 18.00 Uhr E Mail: support@sigmail.de