Configure the 3-D Secure service

After you have enabled the 3-D Secure service for WebSphere Commerce, configure the 3-D Secure service:

1. Edit the WCMPI.properties file located in the following WAS 5.1.1.3 directory:

   (i5/OS)

   WAS511_userdir/installedApps/cell/WC_instance.ear/Stores.war/WEB-INF/
   
   
       classes/WCMPI.properties
   
   

   
   

   (Linux)

   WAS511_installdir/installedApps/cell/WC_instance.ear/Stores.war/WEB-INF/
   
   
     classes/WCMPI.properties
   
   

   
   

   (Windows)

   WAS511_installdir\installedApps\cell\WC_instance.ear\Stores.war\WEB-INF\
   
   
     classes\WCMPI.properties
   
   

   The WCMPI.properties file is a common 3-D Secure configuration file for all stores which are published on the same WebSphere Commerce server and enabled for 3-D Secure. Most of the configuration items specify in this file can be obtained by referring to the old threedsecure.properties file, which you backed up earlier as 3d_backupdir\properties\threedsecure.properties.

   Notes:

   1. Be sure to specify the visa_directory_server_keystore_path and visa_directory_server_truststore_path using forward slashes (/), even if you are using a Windows platform.

   2. The visa_directory_server_keystore_passphrase configuration item should use encrypted text. For more information about the encryption of this password, refer to the 3-D Secure Merchant Plug-in chapter in the WebSphere Commerce Additional Software Guide.

2. Edit the WCMPIUser.properties file located in the following WAS 5.1.1.3 directory:

   (i5/OS)

   WAS511_userdir/installedApps/cell/WC_instance.ear/Stores.war/
   
   
    WEB-INF/classes/store/Snippets/Order/Secure3d/WCMPIUser.properties
   
   

   
   

   (Linux)

   WAS511_installdir/installedApps/cell/WC_instance.ear/Stores.war/
   
   
    WEB-INF/classes/store/Snippets/Order/Secure3d/WCMPIUser.properties
   
   

   
   

   (Windows)

   WAS511_installdir\installedApps\cell\WC_instance.ear\Stores.war\
   
   
       WEB-INF\classes\store\Snippets\Order\Secure3dWCMPIUser.properties
   
   

   The WCMPIUser.properties file provides configuration information for a specific store. The configuration items specify in this file can be obtained by referring to the old WCMPI.properties file, which you backed up earlier as 3d_backupdir\properties\WCMPI.properties.

   Notes:

   1. The WCMPI_MERCHANT_PASSWORD configuration item should use encrypted text. For more information about the encryption of this password, refer to the 3-D Secure Merchant Plug-in chapter in the WebSphere Commerce Additional Software Guide.

   2. The WCMPI_MPI_URL configuration item is different from the former value in the old 3d_backupdir\properties\WCMPI.properties file. You should configure this value as text in the WCMPIUser.properties file, but modify the string "localhost" in https://localhost/webapp/wcs/stores/servlet/SecureThreeDACSCmd to specify your WebSphere Commerce machine name. For example: https://mymachine.mycompany.com/webapp/wcs/stores/servlet/SecureThreeDACSCmd

      If necessary, edit the WCMPIUserMessages_locale.properties file (your locale file) to add message text values from the original MPIUserMessages_locale.properties file that you backed up previously.

3. Import the certificate file of the Visa Directory server into the Java keystore file.

   The 3-D Secure SSL client and trusted root certificates should be added to the Java keystore (.jks) file that you specify with the visa_directory_server_keystore_path and visa_directory_server_truststore_path properties. Refer to the WAS Information Center documentation on the use of ikeyman (in the WAS bin directory) to request, import, and manage SSL certificates. For example, with 3-D Secure, merchants are required to request SSL client certificates to use when communicating with the 3-D Secure Directory Server.

   If you are required to trust root certificates other than those which ship with the default WAS keystore, then follow the WAS documentation on adding these root certificates to your keystore.

4. Migrate WebSphere Commerce Payments.

Your store should be ready to use the 3-D Secure service.