XML Encryption (Password)
Dieser Adapter verschlüsselt oder entschlüsselt ein beliebiges XML-Dokument gemäß dem W3C-Standard XML-Encryption (XML-Enc) auf Basis eines Passworts. Der Adapter unterstützt die Verschlüsselungsalgorithmen AES mit 128, 192 oder 256 Bit Schlüssellänge sowie Triple-DES. Für Ver-/Entschlüsselung auf Basis eines Keystores, siehe XML Encryption (Keystore).
Eigenschaften (Properties)
Operation | Bestimmt, welche Operation der Funktions-Adapter durchführt Mögliche Werte:
|
Parameter
Adapter | Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: de.softproject.integration.adapter.xml.encryption.XmlEncryption: Hauptklasse (Standard) |
method | Algorithmus zur Verschlüsselung bzw. Entschlüsselung Mögliche Werte:
|
xpath | Pfad zum Element bzw. zu den Elementen, die verschlüsselt/entschlüsselt werden sollen als XPath-Ausdruck Mögliche Werte: |
scope | Bestimmt den Wirkungsbereich für die Verschlüsselung innerhalb der per XPath adressierten XML-Dokumentstruktur Mögliche Werte:
|
password | Passwort, das zur Verschlüsselung und Entschlüsselung verwendet werden soll Mögliche Werte: |
Statuswerte
-1 (error) | Fehler bei der Ausführung des Adapters (Details siehe Server-Log) Im Fehlerfall gibt der Adapter zudem eine Textdatei aus, welche die Exception enthält. |
0 (empty) | Dokument wurde nicht verändert. Es wurden keine passenden Elemente gefunden. |
1 (successful) | Dokument wurde verarbeitet und die entsprechenden Elemente ver-/entschlüsselt. |
Beispiel
Im folgenden XML-Dokument sollen per XML-Encryption mit dem AES128-Algorithmus die Inhalte aller Data
-Elemente verschlüsselt werden:
Input
<RootElement>
<Data>Hello</Data>
<Data>World!</Data>
<Public>© SoftProject GmbH</Public>
</RootElement>
Der Adapter liefert dann beispielsweise folgendes verschlüsselte Ergebnis-XML-Dokument zurück:
Ergebnis
<RootElement>
<Data>
<xenc:EncryptedData xmlns:xenc="http://www.w3.org/2001/04/xmlenc#"
Type="http://www.w3.org/2001/04/xmlenc#Content">
<xenc:EncryptionMethod
Algorithm="http://www.w3.org/2001/04/xmlenc#aes128-cbc" />
<xenc:CipherData>
<xenc:CipherValue>JS1lBp4RcMk6RepmptplJnBGqbpINGHSV9THG7+UJcY
</xenc:CipherValue>
</xenc:CipherData>
</xenc:EncryptedData>
</Data>
<Data>
<xenc:EncryptedData xmlns:xenc="http://www.w3.org/2001/04/xmlenc#"
Type="http://www.w3.org/2001/04/xmlenc#Content">
<xenc:EncryptionMethod
Algorithm="http://www.w3.org/2001/04/xmlenc#aes128-cbc" />
<xenc:CipherData>
<xenc:CipherValue>rO+m1iPwsw4/PaP2AokM30DqsqeD1OYRvD7KNG+bnxc
</xenc:CipherValue>
</xenc:CipherData>
</xenc:EncryptedData>
</Data>
<Public>© SoftProject GmbH</Public>
</RootElement>