Skip to main content
Skip table of contents

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:

  • Encrypt: XML-Dokument verschlüsseln

  • Decrypt: XML-Dokument entschlüsseln

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:

  • 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>
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.