Choix des méthodes de chiffrement pour les liaisons de générateur

Pour configurer le client pour le chiffrement des demandes pour la liaison de générateur, vous devez indiquer les méthodes de chiffrement à utiliser lorsque le client chiffre les messages SOAP.

1. A l'aide de l'API WSSEncryption, elle ajoute l'algorithme de chiffrement de données obligatoire.
   Cet algorithme sert à chiffrer ou à déchiffrer des parties d'un message SOAP. Les algorithmes de chiffrement de données indiquent l'URI de l'algorithme pour la méthode de chiffrement des données.

   La configuration du générateur client doit correspondre à celle du fournisseur destinataire.

   L'algorithme de chiffrement de données par défaut est AES 128. Le nom de chiffrement de données est AES128 et l'URI de l'algorithme de chiffrement de données est https://www.w3.org/2001/04/xmlenc#aes128-cbc. WebSphere Application Server supporte les algorithmes de chiffrement de données préconfigurés suivants :

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

     L'algorithme AES 128 est la méthode d'algorithme de données par défaut.

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

     N'utilisez pas l'algorithme de chiffrement de données 192 bits si vous voulez que l'application configurée soit compatible avec le profil BSP (Basic Security Profile).

     Pour utiliser cet algorithme AES 192-cbc, vous devez télécharger le fichier de stratégie Java Cryptography Extension (JCE) sans restriction à partir du site Web suivant : https://www.ibm.com/developerworks/java/jdk/security/index.html.

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

     Pour utiliser cet algorithme AES 256-cbc, vous devez télécharger le fichier de stratégie Java Cryptography Extension (JCE) sans restriction à partir du site Web suivant : https://www.ibm.com/developerworks/java/jdk/security/index.html.

   • TRIPLEDES : https://www.w3.org/2001/04/xmlenc#tripledes-cbc
2. Si besoin est, elle modifie la méthode de l'API WSSEncryption pour indiquer un autre algorithme de chiffrement de données.
   Par exemple, vous pouvez ajouter le code suivant pour modifier l'algorithme AES 128 par défaut à l'algorithme Triple DES :

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

3. A l'aide de l'API WSSEncryption, elle ajoute l'algorithme de chiffrement de clé obligatoire.
   L'algorithme de chiffrement de clé est utilisé pour le chiffrement de portions d'un message SOAP. Si la clé de chiffrement, utilisée pour chiffrer les parties du message, n'est pas chiffrée, l'API de déchiffrement choisit false pour correspondre à cette clé.

   La configuration du générateur client doit correspondre à celle du fournisseur destinataire.

   La valeur de l'algorithme de chiffrement de clé par défaut est l'encapsulation de clé RSA OAP. Le nom de chiffrement de clé est KW_RSA_OAEP et l'URI de l'algorithme de chiffrement de clé est https://www.w3.org/2001/04/xmlenc#rsa-oaep-mgf1p. WebSphere Application Server prend en charge les algorithmes de chiffrement de clés pré-configurés suivants :

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

     Pour utiliser cet algorithme AES 192 d'encapsulage de clé, vous devez télécharger le fichier de stratégie JCE (Java Cryptography Extension) sans restriction à partir du site Web suivant : https://www.ibm.com/developerworks/java/jdk/security/index.html.

     N'utilisez pas l'algorithme de chiffrement de données 192 bits si vous voulez que l'application configurée soit compatible avec le profil BSP (Basic Security Profile).

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

     Pour utiliser cet algorithme AES 256-cbc d'enveloppement de clé, vous devez télécharger le fichier de stratégie Java Cryptography Extension (JCE) sans restriction à partir du site Web suivant : https://www.ibm.com/developerworks/java/jdk/security/index.html.

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

     L'algorithme KW RSA OAEP est la méthode d'algorithme de clé par défaut.

     Lors de l'exécution avec le kit de développement de logiciels (SDK) version 1.4, la liste des algorithmes de transport de clés pris en charge n'inclut pas cet algorithme. L'algorithme apparaît dans la liste des algorithmes de transport de clé pris en charge avec SDK Version 1.5. Voir plus d'informations sur 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

   Note: Pour la conversation sécurisée des services Web, l'API WSSEncryption peut spécifier des informations supplémentaires liées à la clé, telles que :

   • 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);