Verschlüsselungsmethoden für Generatorbindungen

Wenn Sie den Client für die Anforderungsverschlüsselung für die Generatorbindung konfigurieren möchten, müssen Sie die Verschlüsselungsmethoden angeben, die verwendet werden sollen, wenn der Client die SOAP-Nachrichten verschlüsselt.

1. Bei der Verwendung der API WSSEncryption wird der erforderliche Datenverschlüsselungsalgorithmus hinzugefügt.
   Der Datenverschlüsselungsalgorithmus wird für die Ver- und Entschlüsselung von Teilen einer SOAP-Nachricht. Datenverschlüsselungsalgorithmen geben den Algorithmus-URI (Uniform Resource Identifier) der Datenverschlüsselungsmethode an.

   Die Konfiguration des Clientgenerators muss mit der Konfiguration des Providerkonsumenten übereinstimmen.

   Standardmäßig wird der Datenverschlüsselung AES 128 verwendet. Der Datenverschlüsselungsname ist AES128, und der URI des Datenverschlüsselungsalgorithmus ist https://www.w3.org/2001/04/xmlenc#aes128-cbc. WebSphere Application Server unterstützt die folgenden vorkonfigurierten Datenverschlüsselungsalgorithmen:

   • AES 128: https://www.w3.org/2001/04/xmlenc#aes128-cbc

     Standardmäßig wird die Datenalgorithmusmethode AES 128 verwendet.

   • AES 192: https://www.w3.org/2001/04/xmlenc#aes192-cbc

     Verwenden Sie den Algorithmus für 192-Bit-Schlüsselverschlüsselung nicht, wenn Ihre konfigurierte Anwendung mit dem Basic Security Profile (BSP) konform sein soll.

     Um diesen AES 192-cbc-Algorithmus zu verwenden, müssen Sie die uneingeschränkte Java Cryptography Extension (JCE)-Richtliniendatei von der folgenden Website herunterladen: https://www.ibm.com/developerworks/java/jdk/security/index.html.

   • AES 256: https://www.w3.org/2001/04/xmlenc#aes256-cbc

     Um diesen AES 256-cbc-Algorithmus zu verwenden, müssen Sie die uneingeschränkte Java Cryptography Extension (JCE)-Richtliniendatei von der folgenden Website herunterladen: https://www.ibm.com/developerworks/java/jdk/security/index.html.

   • TRIPLEDES: https://www.w3.org/2001/04/xmlenc#tripledes-cbc
2. Ändern Sie bei Bedarf die API-Methode "WSSEncryption" in einen anderen Datenverschlüsselungsalgorithmus.
   Sie können beispielsweise den folgenden Code hinzufügen, um den Standardalgorithmus von AES 128 in Triple DES zu ändern:

   // Default data encryption algorithm: AES128
   WSSEncryption enc = factory.newWSSEncryption(x509t); 
      enc.setEncryptionMethod(EncryptionMethod.TRIPLEDES_CBC);
   gencont.add(enc); 

3. Bei der Verwendung der API WSSEncryption wird der erforderliche Schlüsselchiffrieralgorithmus hinzugefügt.
   Der Algorithmus für Schlüsselchiffrierung wird für die Ver- und Entschlüsselung des Schlüssels verwendet, mit dem die Nachrichtenabschnitte in der SOAP-Nachricht verschlüsselt werden. Wenn der Chiffrierschlüssel, d. h. der Schlüssel, der für die Verschlüsselung der Nachrichtenabschnitte verwendet wird, nicht verschlüsselt ist, wählt die API für Entschlüsselung dem unverschlüsselten Chiffrierschlüssel entsprechend die Einstellung false aus.

   Die Konfiguration des Clientgenerators muss mit der Konfiguration des Providerkonsumenten übereinstimmen.

   Der Standardwert für den Schlüsselchiffrieralgorithmus ist "key wrap RSA OAP". Der Name der Schlüsselchiffrierung ist KW_RSA_OAEP, und der URI des Schlüsselchiffrieralgorithmus ist https://www.w3.org/2001/04/xmlenc#rsa-oaep-mgf1p. WebSphere Application Server unterstützt die folgenden vorkonfigurierten Schlüsselverschlüsselungsalgorithmen:

   • KW AES128: https://www.w3.org/2001/04/xmlenc#kw-aes128
   • KW AES192: https://www.w3.org/2001/04/xmlenc#kw-aes192

     Um diesen Key Wrap AES 192-Algorithmus zu verwenden, müssen Sie die uneingeschränkte Java Cryptography Extension (JCE)-Richtliniendatei von der folgenden Website herunterladen: https://www.ibm.com/developerworks/java/jdk/security/index.html.

     Verwenden Sie den Algorithmus für 192-Bit-Schlüsselverschlüsselung nicht, wenn Ihre konfigurierte Anwendung mit dem Basic Security Profile (BSP) konform sein soll.

     KW AES 256: https://www.w3.org/2001/04/xmlenc#kw-aes256

     Um diesen Key Wrap AES 256-cbc-Algorithmus zu verwenden, müssen Sie die uneingeschränkte Java Cryptography Extension (JCE)-Richtliniendatei von der folgenden Website herunterladen: https://www.ibm.com/developerworks/java/jdk/security/index.html.

   • KW RSA OAEP: https://www.w3.org/2001/04/xmlenc#rsa-oaep-mgf1p.

     Standardmäßig wird der Algorithmus "KW RSA OAEP" als Schlüsselalgorithmusmethode verwendet.

     Wenn Sie mit Software Development Kit (SDK) Version 1.4 arbeiten, ist dieser Algorithmus nicht in der Liste der unterstützten Schlüsseltransportalgorithmen enthalten. Dieser Algorithmus erscheint in der Liste der unterstützten Schlüsseltransportalgorithmen, wenn Sie mit SDK 1.5 arbeiten. Weitere Informationen finden Sie unter https://www.w3.org/2001/04/xmlenc#rsa-oaep-mgf1p

   • KW RSA15: https://www.w3.org/2001/04/xmlenc#rsa-1_5
   • KW TRIPLE DES: https://www.w3.org/2001/04/xmlenc#kw-tripledes

   Notiz: Für Web Services Secure Conversation kann die WSSEncryption-API zusätzliche schlüsselbezogene Informationen angeben, beispielsweise:

   • algorithmName
   • keyLength

// Get the message context
   Object msgcontext = getMessageContext();

// Generate the WSSFactory instance
   WSSFactory factory = WSSFactory.getInstance();

// Generate the WSSGenerationContext instance
   WSSGenerationContext gencont = factory.newWSSGenerationContext();

// Generate callback handler
   X509GenerateCallbackHandler callbackHandler = new 
       X509GenerateCallbackHandler(
                                   "",
                                   "enc-sender.jceks",
                                   "jceks", 
                                   "storepass".toCharArray(), 
                                   "bob", 
                                   null, 
                                   "CN=Bob, O=IBM, C=US", 
                                   null);

// Generate the security token used for encryption
   SecurityToken token = factory.newSecurityToken(X509Token.class , callbackHandler);

// Generate WSSEncryption instance 
   WSSEncryption enc = factory.newWSSEncryption(token);

// Set the data encryption method 
// DEFAULT: WSSEncryption.AES128
      enc.setEncryptionMethod(WSSEncryption.TRIPLE_DES);

// Set the key encryption method
// DEFAULT: WSSEncryption.KW_RSA_OAEP
      enc.setEncryptionMethod(WSSEncryption.KW_RSA15);

// Add the WSSEncryption to the WSSGenerationContext
   gencont.add(enc);

// Generate the WS-Security header
gencont.process(msgcontext);