aboutsummaryrefslogtreecommitdiff
path: root/spss.handbook/clients/api/src/at/gv/egovernment/moa/spss
diff options
context:
space:
mode:
authorgregor <gregor@d688527b-c9ab-4aba-bd8d-4036d912da1d>2005-04-22 09:25:46 +0000
committergregor <gregor@d688527b-c9ab-4aba-bd8d-4036d912da1d>2005-04-22 09:25:46 +0000
commit9b34abab090eead44b964046a56eaa96701c1b1b (patch)
tree8c3ac885ec77a75dbfb6bc42fdd9404b4374d567 /spss.handbook/clients/api/src/at/gv/egovernment/moa/spss
parente01e6bdf5d751c251563023cdaf9718ef57eff6c (diff)
downloadmoa-id-spss-9b34abab090eead44b964046a56eaa96701c1b1b.tar.gz
moa-id-spss-9b34abab090eead44b964046a56eaa96701c1b1b.tar.bz2
moa-id-spss-9b34abab090eead44b964046a56eaa96701c1b1b.zip
API-Beispiel für Signaturprüfung erstellt; API-Beispiel für Signaturprüfung umbenannt. Beispielsignatur für Signaturprüfungsbeispiel angelegt.
git-svn-id: https://joinup.ec.europa.eu/svn/moa-idspss/trunk@316 d688527b-c9ab-4aba-bd8d-4036d912da1d
Diffstat (limited to 'spss.handbook/clients/api/src/at/gv/egovernment/moa/spss')
-rw-r--r--spss.handbook/clients/api/src/at/gv/egovernment/moa/spss/handbook/clients/api/CreateXMLSignature.java (renamed from spss.handbook/clients/api/src/at/gv/egovernment/moa/spss/handbook/clients/api/APIClientExample.java)16
-rw-r--r--spss.handbook/clients/api/src/at/gv/egovernment/moa/spss/handbook/clients/api/VerifyXMLSignature.java147
2 files changed, 155 insertions, 8 deletions
diff --git a/spss.handbook/clients/api/src/at/gv/egovernment/moa/spss/handbook/clients/api/APIClientExample.java b/spss.handbook/clients/api/src/at/gv/egovernment/moa/spss/handbook/clients/api/CreateXMLSignature.java
index a1e37fdd0..33924bc01 100644
--- a/spss.handbook/clients/api/src/at/gv/egovernment/moa/spss/handbook/clients/api/APIClientExample.java
+++ b/spss.handbook/clients/api/src/at/gv/egovernment/moa/spss/handbook/clients/api/CreateXMLSignature.java
@@ -20,30 +20,30 @@ import at.gv.egovernment.moa.spss.api.xmlsign.SingleSignatureInfo;
import at.gv.egovernment.moa.util.DOMUtils;
/**
- * Dieses einfache Beispiel demonstriert grundlegend den Gebrauch der API von MOA SPSS. Es wird damit eine
+ * Dieses einfache Beispiel demonstriert grundlegend den Gebrauch der API von MOA SP/SS. Es wird damit eine
* einfach aufgebaute XML-Signatur erzeugt.
*/
-public class APIClientExample
+public class CreateXMLSignature
{
/**
* Methode main.
*
- * Enthält beispielhaften Code zum grundlegenden Gebrauch der API von MOA SPSS. Es wird damit eine
+ * Enthält beispielhaften Code zum grundlegenden Gebrauch der API von MOA SP/SS. Es wird damit eine
* einfach aufgebaute XML-Signatur erzeugt.
*
- * ACHTUNG: Stellen Sie bei Verwendung eines JDK 1.4.x sicher, dass Sie die System-Property
+ * ACHTUNG: Stellen Sie bei Verwendung von J2SE 1.4.x bzw. 5.x sicher, dass Sie die System-Property
* <code>java.endorsed.dirs</code> auf jenes Verzeichnis gesetzt haben, in dem sich die XPath-
* und XSLT-Bibliothek <em>Xalan-J</em> befindet.
*
* @param args <ul>
* <li>
- * args[0] enthält einen Verweis auf die Konfigurations-Datei von MOA SPSS Der Verweis
+ * args[0] enthält einen Verweis auf die Konfigurations-Datei von MOA SP/SS Der Verweis
* enthält entweder eine absolute oder eine relative Pfadangabe, wobei eine relative
* Angabe als relativ zum Arbeitsverzeichnis der Java VM interpretiert wird.
* </li>
* <li>
* args[1] enthält einen Verweis auf die Konfigurations-Datei von Log4J, dem Logging-
- * Framework, das von MOA SPSS verwendet wird. Der Verweis enthält entweder eine
+ * Framework, das von MOA SP/SS verwendet wird. Der Verweis enthält entweder eine
* absolute oder eine relative Pfadangabe, wobei eine relative Angabe als relativ zum
* Arbeitsverzeichnis der Java VM interpretiert wird.
* </li>
@@ -116,13 +116,13 @@ public class APIClientExample
/**
* Setzt die notwendigen System-Properties für die Konfiguration der MOA SP/SS API.
*
- * @param args Siehe @link APIClientExample#main(String[]).
+ * @param args Siehe @link CreateXMLSignature#main(String[]).
*/
private static void init(String[] args)
{
if (args == null || args.length != 2)
{
- System.out.println("Verwendung: APIClientExample <MOASPSSConfigFile> <Log4JConfigFile>");
+ System.out.println("Verwendung: CreateXMLSignature <MOASPSSConfigFile> <Log4JConfigFile>");
}
System.setProperty("moa.spss.server.configuration", args[0]);
System.setProperty("log4j.configuration", "file:" + args[1]);
diff --git a/spss.handbook/clients/api/src/at/gv/egovernment/moa/spss/handbook/clients/api/VerifyXMLSignature.java b/spss.handbook/clients/api/src/at/gv/egovernment/moa/spss/handbook/clients/api/VerifyXMLSignature.java
new file mode 100644
index 000000000..fed8ba9f2
--- /dev/null
+++ b/spss.handbook/clients/api/src/at/gv/egovernment/moa/spss/handbook/clients/api/VerifyXMLSignature.java
@@ -0,0 +1,147 @@
+package at.gv.egovernment.moa.spss.handbook.clients.api;
+
+import java.io.FileInputStream;
+import java.io.FileNotFoundException;
+import java.util.HashMap;
+
+import at.gv.egovernment.moa.spss.MOAException;
+import at.gv.egovernment.moa.spss.api.SPSSFactory;
+import at.gv.egovernment.moa.spss.api.SignatureVerificationService;
+import at.gv.egovernment.moa.spss.api.common.Content;
+import at.gv.egovernment.moa.spss.api.common.SignerInfo;
+import at.gv.egovernment.moa.spss.api.xmlverify.VerifySignatureInfo;
+import at.gv.egovernment.moa.spss.api.xmlverify.VerifySignatureLocation;
+import at.gv.egovernment.moa.spss.api.xmlverify.VerifyXMLSignatureRequest;
+import at.gv.egovernment.moa.spss.api.xmlverify.VerifyXMLSignatureResponse;
+
+/**
+ * Dieses einfache Beispiel demonstriert grundlegend den Gebrauch der API von MOA SP/SS.
+ * Es wird damit eine einfach aufgebaute XML-Signatur geprüft.
+ */
+
+public class VerifyXMLSignature
+{
+ /**
+ * Methode main.
+ *
+ * Enthält beispielhaften Code zum grundlegenden Gebrauch der API von MOA SP/SS.
+ * Es wird damit eine einfach aufgebaute XML-Signatur geprüft.
+ *
+ * ACHTUNG: Stellen Sie bei Verwendung von J2SE 1.4.x bzw. 5.x sicher, dass Sie die System-Property
+ * <code>java.endorsed.dirs</code> auf jenes Verzeichnis gesetzt haben, in dem sich die XPath-
+ * und XSLT-Bibliothek <em>Xalan-J</em> befindet.
+ *
+ * @param args <ul>
+ * <li>
+ * args[0] enthält einen Verweis auf die Konfigurations-Datei von MOA SP/SS Der Verweis
+ * enthält entweder eine absolute oder eine relative Pfadangabe, wobei eine relative
+ * Angabe als relativ zum Arbeitsverzeichnis der Java VM interpretiert wird.
+ * </li>
+ * <li>
+ * args[1] enthält einen Verweis auf die Konfigurations-Datei von Log4J, dem Logging-
+ * Framework, das von MOA SP/SS verwendet wird. Der Verweis enthält entweder eine
+ * absolute oder eine relative Pfadangabe, wobei eine relative Angabe als relativ zum
+ * Arbeitsverzeichnis der Java VM interpretiert wird.
+ * </li>
+ * <li>
+ * args[2] enthält Pfad und Dateiname des XML-Dokuments mit der darin enthaltenen, zu
+ * prüfenden XML-Signatur. Verwenden Sie z.B. das mit diesem Handbuch mitgelieferte
+ * Beispiel <code>clients/api/signatures/SimpleSignature.xml</code>.
+ * </li>
+ * </ul>
+ */
+ public static void main(String[] args)
+ {
+ // Setzen der System-Properties
+ init(args);
+
+ // Factory und Service instanzieren
+ SPSSFactory spssFac = SPSSFactory.getInstance();
+ SignatureVerificationService sigVerifyService = SignatureVerificationService.getInstance();
+
+ // Content aus Dokument mit zu prüfender Signatur erstellen
+ FileInputStream sigDocFIS = null;
+ try
+ {
+ sigDocFIS = new FileInputStream(args[2]);
+ }
+ catch (FileNotFoundException e1)
+ {
+ System.err.println("XML-Dokument mit zu prüfender Signatur nicht gefunden: " + args[2]);
+ System.exit(-1);
+ }
+ Content sigDocContent = spssFac.createContent(sigDocFIS, null);
+
+ // Position der zu prüfenden Signatur im Dokument angeben
+ // (Nachdem im XPath-Ausdruck ein NS-Präfix verwendet wird, muss in einer Lookup-Tabelle
+ // der damit bezeichnete Namenraum mitgegeben werden)
+ HashMap nSMap = new HashMap();
+ nSMap.put("dsig", "http://www.w3.org/2000/09/xmldsig#");
+ VerifySignatureLocation sigLocation = spssFac.createVerifySignatureLocation("//dsig:Signature", nSMap);
+
+ // Zu prüfendes Dokument und Signaturposition zusammenfassen
+ VerifySignatureInfo sigInfo = spssFac.createVerifySignatureInfo(sigDocContent, sigLocation);
+
+ // Prüfrequest zusammenstellen
+ VerifyXMLSignatureRequest verifyRequest = spssFac.createVerifyXMLSignatureRequest(
+ null, // Wird Prüfzeit nicht angegeben, wird aktuelle Zeit verwendet
+ sigInfo,
+ null, // Keine Ergänzungsobjekte notwendig
+ null, // Signaturmanifest-Prüfung soll nicht durchgeführt werden
+ false, // Hash-Inputdaten, d.h. tatsächlich signierte Daten werden nicht zurückgeliefert
+ "Test-Signaturdienste"); // ID des verwendeten Vertrauensprofils
+
+ VerifyXMLSignatureResponse verifyResponse = null;
+ try
+ {
+ // Aufruf der Signaturprüfung
+ verifyResponse = sigVerifyService.verifyXMLSignature(verifyRequest);
+ }
+ catch (MOAException e)
+ {
+ // Service liefert Fehler
+ System.err.println("Die Signaturprüfung hat folgenden Fehler geliefert:");
+ System.err.println("Fehlercode: " + e.getMessageId());
+ System.err.println("Fehlernachricht: " + e.getMessage());
+ System.exit(-1);
+ }
+
+ // Auswertung der Response
+ System.out.println();
+ System.out.println("Ergebnisse der Signaturprüfung:");
+ System.out.println();
+
+ // Besondere Eigenschaften des Signatorzertifikats
+ SignerInfo signerInfo = verifyResponse.getSignerInfo();
+ System.out.println("*** Ist Zertifikat des Signators qualifiziert? " + ((signerInfo.isQualifiedCertificate()) ? "ja" : "nein"));
+ System.out.println("*** Ist Zertifikat des Signators von einer Behörde? " + ((signerInfo.isPublicAuthority()) ? "ja" : "nein"));
+
+ // Ergebnisse von Signatur- und Zertifikatsprüfung
+ System.out.println();
+ System.out.println("Ergebniscode der Signaturprüfung: " + verifyResponse.getSignatureCheck().getCode());
+ System.out.println("Ergebniscode der Zertifikatsprüfung: " + verifyResponse.getCertificateCheck().getCode());
+
+ // Signatorzertifikat
+ System.out.println();
+ System.out.println("*** Zertifikat des Signators:");
+ System.out.println("Aussteller: " + signerInfo.getSignerCertificate().getIssuerDN());
+ System.out.println("Subject: " + signerInfo.getSignerCertificate().getSubjectDN());
+ System.out.println("Seriennummer: " + signerInfo.getSignerCertificate().getSerialNumber());
+ }
+
+ /**
+ * Setzt die notwendigen System-Properties für die Konfiguration der MOA SP/SS API.
+ *
+ * @param args Siehe @link VerifyXMLSignature#main(String[]).
+ */
+ private static void init(String[] args)
+ {
+ if (args == null || args.length != 3)
+ {
+ System.out.println("Verwendung: VerifyXMLSignature <MOASPSSConfigFile> <Log4JConfigFile> <XMLDocWithSignature>");
+ System.exit(-1);
+ }
+ System.setProperty("moa.spss.server.configuration", args[0]);
+ System.setProperty("log4j.configuration", "file:" + args[1]);
+ }
+} \ No newline at end of file