Implémentations d'un fournisseur de clé pour la clé de commerçant

WCMerchantKeyImpl

L'implémentation par défaut, com.ibm.commerce.security.keys.WCMerchantKeyImpl, continue à lire la clé de commerçant dans le fichier instance.xml. Elle ne peut pas être utilisée pour définir la clé de commerçant dans le fichier XML de l'instance. WCMerchantKeyImpl ne doit donc pas être utilisée comme fournisseur d'une nouvelle clé ("new") lors de l'exécution de MigrateEncryptedInfo. En revanche, elle peut être utilisée comme fournisseur de la clé en cours ("current") lorsque vous décidez de changer de fournisseur de clé.

Ce fournisseur de clé est défini de la manière suivante dans le fichier workspace_dir/WC/xml/config/WCKeys.xml :

<?xml version="1.0" encoding="UTF-8"?>
<keys>
<key name="MerchantKey" 
providerName="WC" 
status="current"
className="com.ibm.commerce.security.keys.WCMerchantKeyImpl"> 
</key>
</keys>

Comme vous pouvez le constater, la définition n'indique pas le chemin du HCL Commercefichier de configuration . Cette omission ne représente pas un problème si la définition est utilisée au moment de l'exécution car l'instance en cours est connue et le système peut accéder au fichier de configuration approprié. En revanche, lorsque Key Locator Framework est utilisé à partir d'un script en ligne de commande, par exemple MigrateEncryptedInfo, l'environnement d'exécution n'est pas initialisé. Par conséquent, vous ne pouvez pas identifier le fichier de configuration approprié pour l'instance à l'aide de la définition ci-dessus dans un scénario incluant plusieurs instances. Par conséquent, un paramètre de configuration supplémentaire, instanceName, est nécessaire pour indiquer le nom de l'instance lorsque WCMerchantKeyImpl doit être utilisé en ligne de commande. Le nom de l'instance permet d'identifier le HCL Commercefichier de configuration pour extraire la clé de commerçant.

Par exemple, le fichier de configuration de clés d'une instance appelée "demo" apparaît sous la forme suivante :

<?xml version="1.0" encoding="UTF-8"?>
<keys>
<key name="MerchantKey" 
providerName="WC" 
status="current"
className="com.ibm.commerce.security.keys.WCMerchantKeyImpl">
<config name="instanceName" value="demo"/> 
</key>
</keys>

WCExternalFileMerchantKeyImpl

Une implémentation qui permet se conformer aux normes PCI, com.ibm.commerce.security.keys.WCExternalFileMerchantKeyImpl, est utilisée pour lire et stocker la clé de commerçant dans un fichier externe. Comme le fichier XML de l'instance contient bien d'autres informations que la clé de commerçant, il est difficile de contrôler l'accès au fichier. Pour être conforme aux normes PCI, cette implémentation de fournisseur de clé lit la clé de commerçant depuis un fichier externe.

Si une nouvelle clé de commerçant est nécessaire, deux administrateurs doivent entrer chacun une moitié de la clé de commerçant dans deux fichiers externes temporaires. Cette opération permet d'adhérer aux critères de partage des connaissances. Le nom et l'emplacement de ces fichiers temporaires sont indiqués dans le fichier de configuration de clés. Les clés indiquées dans les fichiers externes sont stockées sous forme de texte clair.

Lors de la mise à jour du fichier contenant la clé de commerçant, la méthode WCKey.updateValue() est appelée pour mettre à jour le fichier externe avec la nouvelle valeur de la clé de commerçant chiffrée et effacer le contenu des deux fichiers externes temporaires. Pour plus de sécurité, ce fournisseur autorise le client à spécifier une clé de chiffrement de clé facultative. Cette clé de chiffrement de clé est utilisée pour chiffrer la clé de commerçant lors du stockage de cette dernière dans le fichier externe. Si la clé de chiffrement de clé n'est pas spécifiée, la clé de chiffrement interne est utilisée.

La section suivante présente le fichier de configuration de clés qui enregistre le fournisseur WCExternalFileMerchantKeyImpl.

<?xml version="1.0" encoding="UTF-8"?>
<keys>
<key name="MerchantKey" 
providerName="WC" status="new"
className="com.ibm.commerce.security.keys.WCExternalFileMerchantKeyImpl">
<config name="keyFile" 
value="merchantKey.xml"
/>
<config name="keyEncryptionKeyFile" 
value="KeyEncryptionKey.xml"/>
<config name="newKeyFile1" value="newMerchantKey1.xml"/>
<config name="newKeyFile2" value="newMerchantKey2.xml"/>
</key>
</keys>