XML Encryption (Password) | X4Documentation

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 (7.5.0-de) XML Encryption (Keystore).

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Funktions-Adapter durchführt

Mögliche Werte:

Encrypt: XML-Dokument verschlüsseln
Decrypt: XML-Dokument entschlüsseln

Parameter

method	Algorithmus zur Verschlüsselung bzw. Entschlüsselung Mögliche Werte: `AES_128`: AES-Algorithmus mit 128 Bit Schlüssellänge verwenden `AES_192`: AES-Algorithmus mit 192 Bit Schlüssellänge verwenden `AES_256`: AES-Algorithmus mit 256 Bit Schlüssellänge verwenden `TRIPLEDES`: Triple-DES-Algorithmus verwenden
xpath	Pfad zum Element bzw. zu den Elementen, die verschlüsselt/entschlüsselt werden sollen als XPath-Ausdruck Mögliche Werte: Beliebiger gültiger XPath-Ausdruck, z.B. `//Data`
scope	Bestimmt den Wirkungsbereich für die Verschlüsselung innerhalb der per XPath adressierten XML-Dokumentstruktur Mögliche Werte: `Element`: Das gesamte Element wird verschlüsselt `Content`: Lediglich der Inhalt des Elements wird verschlüsselt
password	Passwort, das zur Verschlüsselung und Entschlüsselung verwendet werden soll Mögliche Werte: Beliebige Zeichenkette

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

XML

<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

XML

<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>