Services Web › Opérateur Appeler la méthode SOAP asynchrone › Paramètres d'entrée › Sécurité WS › Paramètres communs de WS-Security › Chiffrement

Chiffrement

Activer le chiffrement

Chiffre la demande SOAP et ajoute une nouvelle clé symétrique chiffrée à l'en-tête <wsse:Security> de la demande SOAP. CA Process Automation utilise une clé symétrique pour chiffrer le contenu de la demande SOAP. Le certificat (clé publique) fourni dans le magasin de clés permet de chiffrer la clé symétrique et de l'inclure dans l'en-tête <wsse:Security>. Tous les champs des paramètres de chiffrement sont activés lorsque cette case est cochée.

Paramètres de chiffrement

Les paramètres suivants définissent le chiffrement :

Alias de clé publique

Définit l'alias du certificat (clé publique) permettant de chiffrer la clé symétrique dans le magasin de clés.

Algorithme de canonicalisation

Définit la méthode de canonicalisation utilisée pour sérialiser les données avant d'appliquer le chiffrement. Laissez ce champ vide pour utiliser une sérialisation standard.

Algorithme de chiffrement symétrique

Spécifie le type d'algorithme symétrique avec lequel chiffrer les données.

Valeurs :

• Tripledes-cbc : algorithme DES triple. Cette méthode utilise une clé de 8 octets/24 bits.
• aes128-cbc : algorithme AES avec une clé de 128 bits.
• aes192-cbc : algorithme AES avec une clé de 192 bits.
• aes256-cbc : algorithme AES avec une clé de 256 bits.

Valeur par défaut : AES128

Remarque : Si vous définissez ce paramètre sur aes192-cbc ou aes256-cbc, l'erreur suivante peut se produire :

Illegal key size or default parameters.

Si cette erreur se produit, téléchargez les fichiersJava Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files à partir du site Web d'Oracle :

• US_export_policy.jar
• local_policy.jar

Remplacez les fichiers JAR existants du même nom sous C:chemin_accès_JRE_utilisé_par_PAM\lib\security par les nouveaux fichiers.

Voulez-vous chiffrer la clé symétrique ?

Chiffre la clé symétrique avec laquelle les données ont été chiffrées. La clé est alors incluse dans l'en-tête <wsse:security><xenc:EncryptedKey>.

Algorithme de chiffrement à clé symétrique

Définit l'algorithme avec lequel chiffrer la clé symétrique. Ce paramètre est uniquement applicable si la clé doit être chiffrée.

Valeur par défaut : RSA15

Type d'identificateur de clé publique

Spécifie l'identificateur de clé utilisé pour configurer les éléments d'identification du certificat (clé publique) dans l'élément <xenc:EncryptedKey>. Le destinataire utilise la clé privée qui correspond à ce certificat (clé publique) pour déchiffrer la clé symétrique. La clé symétrique est utilisée pour déchiffrer la demande SOAP.

Valeurs :

• 1 : Jeton de sécurité binaire : l'élément <wsse:SecurityTokenReference> est ajouté à l'élément <xenc:EncryptedKey>. Celui-ci utilise un fragment d'URI dans un élément <wsse:Reference> pour référencer le certificat (clé publique). Le fragment d'URI référence la clé publique. Le produit inclut la clé publique en tant que données binaires dans l'élément <wsse:BinarySecurityToken> de l'en-tête <wsse:Security>.
• 2 : Nom de l'émetteur et numéro de série : l'élément <wsse:SecurityTokenReference> est ajouté à l'élément <xenc:EncryptedKey>. Celui-ci utilise un élément <ds:X509Data><ds:X509:IssuerSerial> pour référencer le certificat (clé publique). Cet élément identifie de manière unique un certificat par son nom d'émetteur et son numéro de série X.509.
• 3 : Identificateur de certificat X509 : l'élément <wsse:SecurityTokenReference> est ajouté à l'élément <xenc:EncryptedKey>. Celui-ci utilise un élément <wsse:KeyIdentifier ValueType="oasis-200401-wss-x509-token-profile-1.0#X509v3"> pour référencer le certificat (clé publique).
• 4 : Identificateur de clé d'objet : l'élément <wsse:SecurityTokenReference> est ajouté à l'élément <xenc:EncryptedKey>. Celui-ci utilise un élément <wsse:KeyIdentifier ValueType="#oasis-200401-wss-x509-token-profile-1.0#X509v3"> pour référencer le certificat (clé publique).
• 8 : Identificateur SHA1 d'empreinte numérique : l'élément <wsse:SecurityTokenReference> est ajouté à l'élément <xenc:EncryptedKey>. Celui-ci utilise un élément <wsse:KeyIdentifier ValueType="#oasis-wss-soap-message-security-1.1#ThumbprintSHA1"> pour référencer le certificat (clé publique).

Valeur par défaut : 0 L'opérateur utilise l'identificateur de clé par défaut (le nom d'émetteur et le numéro de série) à partir de l'implémentation.

Parties à chiffrer

Spécifiez les parties de la demande SOAP à chiffrer. Cliquez sur Ajouter un paramètre pour entrer l'ID de sécurité (ID de l'utilitaire de services Web) ou une combinaison Nom/Espace de noms correspondant à l'élément à chiffrer.

Valeurs :

• ID de l'utilitaire de services Web : définit l'attribut wsu:id de l'élément à chiffrer. Vous pouvez ajouter wsu:id comme attribut d'un élément dans la demande SOAP et spécifier votre propre valeur. Exemple :

     <token wsu:id="123"> </token>
  

  L'instruction suivante présente la définition de l'espace de noms de l'ID de l'utilitaire de services Web :

     xmlns:wsu=http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd
  

• Nom : nom de l'élément à chiffrer.
• Espace de noms : URI de l'espace de noms, et non le nom local de l'espace de noms, de l'élément à chiffrer. Exemple :

     http://www.ca.com/pam
  

• Coder : sélectionnez Contenu pour chiffrer le contenu de l'élément ou Elément pour chiffrer l'élément entier.

Remarque : Laissez ce champ vide pour chiffrer le contenu du corps de la demande SOAP. Si vous spécifiez l'ID de l'utilitaire de services Web, le produit ignore les valeurs Nom et Espace de noms.

Signature en premier ?

Spécifie si appliquer la signature avant le chiffrage des données. Ce champ est utile si les mêmes données de la demande SOAP sont chiffrées et signées.

Déchiffrer et valider la signature de la réponse SOAP

Spécifie si déchiffrer le contenu de la réponse SOAP et, le cas échéant, valider la signature. Lorsque vous sélectionnez cette option, le paramètre Mot de passe de la clé privée de déchiffrement est activé.

Mot de passe de la clé privée de déchiffrement

Définit le mot de passe permettant d'accéder à la clé privée de déchiffrement dans le magasin de clés. Utilisez ce mot de passe pour accéder à la clé privée à utiliser pour déchiffrer une réponse SOAP chiffrée.