[CyberSource logo]


Search documentation:
  Help  Advanced
        Published 05/15/2002 Table of ContentsPreviousNextIndex

Chapter 2

Installing and Testing the CCC

This chapter describes the steps to install and configure the CCC for MSCS 2000. This chapter contains the following sections:

System Requirements

To run the CyberSource CS2000 Component, your system must meet the following minimum requirements:

For optimal performance, your server must meet the following requirements:

You must also install Commerce Server 2000 on your server. Commerce Server 2000 is available from Microsoft for use on the Windows 2000 operating system. For more information, see the Microsoft Commerce Server Web page at http://www.microsoft.com/commerceserver/.

To enable ICS2 support, your server must be able to connect to the Internet.

Installing the CCC for MSCS 2000

This section explains how to configure the CCC to communicate with the ICS2 server, using an evaluation account and merchant ID you receive when you register for the account.

Uninstalling a Previous Version of the CCC

If you are upgrading from a previous version of the CCC, you must uninstall that version before installing the new version.

Uninstalling the CCC
  1. From your Window's desktop, select Start > Settings > Control Panel.
  2. Double-click Add/Remove Programs.
  3. Select the CyberSource Component for CS2000, then click Add/Remove.

Installing CCC Version 4.0.2

Installing the CCC
  1. Download the file ccc-cs2k-2000-4_0_2.exe for the CyberSource CS2000 Component. You can save the file in any directory.
  2. Run the downloaded executable.

    3. Note  You must install the CCC on the computer that runs your Web server.

  3. To register the CyberSource CS2000 Component, select Start > Program > CyberSource CS2000 Component > Register Component.
    4. After you install the CyberSource CS2000 Component, it appears as a selection in the Order Processing Pipeline (OPP) when you run MSCS 2000 Pipeline Editor.
  4. To install the CyberSource Global Resource, do the following:
    1. On a machine that has an SQL server installed, select Start > Programs > CyberSource CS2000 Component > Install CyberSource Resource Type.
    2. You will be prompted for the SQL server hostname (and instance, if applicable), the login username, and password. Enter this information for the SQL server containing the MSCS_Admin database. If you have an SQL server instance, you must use the format "hostname\instance".
    3. On a machine that has Commerce Server and the CyberSource CS2000 Component installed, select Start > Programs > CyberSource CS2000 Component > Install CyberSource Global Resource.
  5. To verify that the CyberSource Global Resource ran successfully, run the Commerce Server Manager, and expand the Commerce Server Manager > Global Resources tree. A node called "CyberSource Commerce Component" should be present with a property called "Version" set to version 4.0.2.
  6. If you do not have your certificate and private key, then run Ecert. For more information, see Creating Your Certificate and Private Key.
  7. Verify that the CyberSource CS2000 Component communicates properly with the CyberSource ICS2 servers.
    1. Select Start > Programs > CyberSource CS2000 Component > Test an SCMP Transaction
      2. You will be prompted for your merchant_id, which you used to run Ecert.
    2. Bring up the pipeline editor, then load purchase.pcf from the Samples > Pipeline Files subdirectory from your installation.
    3. Double-click CyberSource Component for CS2000, then change merchant_id from the default setting to your merchant_id. Save your settings.
    4. Select Start > Programs > CyberSource CS2000 Component > Test the Commerce Component

The component is now installed on your system. Later, you will configure the component for use with your store (see Available CCC Services).

Creating Your Certificate and Private Key

CyberSource uses technology based on public key cryptography to securely exchange messages over the Internet. This technology requires each business partner to have a key pair: a public key, which is delivered in a certificate, and a private key. Before you can securely exchange messages with CyberSource, you must generate your certificate and private key.

You and CyberSource each have your own certificate, which you share, and your own private key, which you keep secret. CyberSource gives you the CyberSource certificate and keeps the CyberSource private key confidential. Likewise, you share your certificate with CyberSource and keep your private key secure.

Store your certificate and private key, along with the CyberSource certificate, on your servers where you installed the cassette. It is your responsibility to closely guard your private key, to ensure that your confidential information is not compromised.

To generate your certificate and private key, use the ECert application included with the cassette.

If you need to update an existing certificate and private key, see the CyberSource Certificate Update User's Guide, available on the CyberSource Small Business Support Center.

Generating Your Certificate and Private Key
  1. Change to the directory where you installed your client software.
    2. Select Start > Programs > Command Prompt, then change to the path for the directory where ECert is located.
  2. Run the ECert application. Type:
    3. ecert <merchant_id>
    where <merchant_id> is your merchant ID.

    Note  If you installed your client software somewhere other than the default directory, use the path option to designate your directory, as follows:
    ecert <merchant_id> -path <directory>
    where <directory> is the name of the directory where your keys are stored. The path option takes first precedence, followed by the ICSPATH environment variable, and then comes the default path of [current drive]:\opt\ics\keys.

    ECert will check for the default path of /opt/ics/keys and if it is not present, ECert will create these directories one by one. By default, ECert writes the files to [Current Drive]:\opt\ics\keys. You may specify an alternate directory by setting the environment variable ICSPATH to that directory.
    The syntax and options for the C and Perl versions of ECert are:
    ecert <merchant_id>
    [ -help ] [ -version ] [ -noprompt ] [ -update ]
    [ -display ] [ -debug ] [ -path <key_directory> ]
    [ -proxy <url> [ <username> ] [ <password> ] ]
    [ -server <ics_server_host> <ics_server_port> ]
    Following are descriptions for the options:
  3. When the ECert application successfully runs, it writes the following files to disk:
    4. By default, the files are written to the following directory:
    <current drive>:\opt\ics\keys

    Note  The ECert application automatically sends a copy of your certificate (.crt) file, but not your private key (.pvt) file, to the CyberSource ICS server. Always keep your private key secret.

  4. Copy the CyberSource certificate, your certificate, your private key, and your password files to the keys directory of any server where the CCC for MSCS 2000 is installed. Your certificate (.crt) and private key (.pvt) files are paired and must be used together.

After you run ECert to generate your certificate and private key, you can securely send transaction requests to the CyberSource test server. When you go live, you can securely send transaction requests to the CyberSource production server

You need to update your certificate and private key yearly to reduce the risk of having them compromised. For more information, go to the CyberSource Small Business Support Center, then click on "Managing Your Account" on the left navigation bar.

Testing the CCC for MSCS 2000 in a Sample Store

To test communication between MCSC 2000 and the CyberSource ICS2 server, create a sample store as follows.

Preparing Your Store for the CCC

  1. From your Window's desktop, select Start > Programs > Microsoft Commerce Server 2000 > Solution Sites.
  2. Unpup the retail site by double clicking the Retail store icon. It is recommended, but not required, that you accept all defaults suggested by the packager/unpackager ("PUP") program.
  3. When the pup package has finished running, you must perform the following actions from your store's Business Desk:
    1. Load a sample catalog for the store. See Importing the Booksfull.xml Catalog File.
    2. Set shipping rates for the store. See Setting Shipping Rates.
    3. Extend the address book. See Extending the Address Book.

You now have a functional store. You can now add the CyberSource CS2000 Component to any of the pipeline files. In this test example, you will configure the pipeline component to authorize credit cards.

Configuring Your Store for the CCC

Configuring Authorize Credit Cards
  1. Using the pipeline editor, open the checkout.pcf pipeline file.
  2. Remove the Default Payment and Required Payment components.
  3. Right-click Payment stage.
  4. Select Insert Component.
  5. Select CyberSource Component for CS2000.
  6. Double-click CyberSource Component and configure the setting as follows:
    1. Set Merchant to your merchant id.
    2. Select Authorize Card for the service you want from the available services to move it to selected services.
  7. Click Properties and configure the Authorize Card service.
    1. Select the Logging tab and select the Enable logging check box.
    2. Click OK.
      3. The Components Service window appears.
  8. Click OK.
  9. Save your pipeline file.
    10. Your store is now setup to process payment transactions and log the transactions to a file.

    Note  Logging should only be used for testing purposes. For performance reasons, logging is not recommended for production environments.

  10. Restart the Web server so your changes will take effect. You can run iisreset.exe from the Start > Run menu.

Importing the Booksfull.xml Catalog File

  1. Click the Import Catalog icon in the Catalog Editor screen to import the booksfull.xml catalog file from the Business Desk.
  2. In the drop-down list, click Import XML.
  3. Select the location of your booksfull.xml catalog in the Import XML Catalog dialog box. This should be in the catalog that you installed Commerce Server.
  4. Click OK.
  5. Click OK in the Business Desk: Import XML dialog box.
  6. Restart the Web server.

The Books catalog is now imported and available on the retail site.

Setting Shipping Rates

  1. Click Shipping Methods in Orders form the Business Desk to add a charge by subtotal shipping method.
  2. Click the New Shipping Method icon in the Shipping Methods screen.
  3. In the drop-down list, click Charge by Subtotal.
  4. In the Shipping Method Properties section, do the following:
    1. For Name, type the Name of your shipping method.
    2. For Description type the Description of your shipping method.
    3. For Enabled, click the check box to enable your shipping method.
  5. In the Rates section, do the following:
    1. For Rates, click New.
    2. For Price up to, type the subtotal amount for the rate level.
    3. For Shipping Rate, type the amount of the rate.
  6. Click Accept.
  7. Click the last row in the rates list. After entering all the rates, this row should read over the highest number of quantity entered.
  8. Click Edit.

    9. Important  You must edit the last line under Rates in order to save your shipping method.

  9. Enter the highest rate for this shipping method.
  10. Click Accept.
  11. Click on the Save Shipping Method icon to save the shipping method. The charge by subtotal method is saved.

Extending the Address Book

  1. Add the field u_email_address (data type varchar, length 255) to your store's Addresses table database.
  2. Run the Commerce Server Manager.
  3. From Commerce Server Manager, select Commerce Server Manager > Global Resources > Profiles > Profile Catalog > Data Sources > ProfileService_SQLSource > Data Objects > Addresses.
  4. Right-click New Data Member. A new member should be created.
    1. In the Name box, type u_email_address
    2. In the Display name and Description boxes, type Email Address
    3. In the Data type box, select String.
    From Commerce Server Manager, select Commerce Server Manager > Global Resources > Profiles > Profile Catalog > Profile Definitions > Addresses.
    A list of properties should appear.
  5. Click General Information.
  6. Click Add and choose Add A New Property. The following should be displayed:
  7. Click Advanced Attributes.
  8. Map the field to Email Address. This field was previously added in the Addresses table.
  9. Click Apply.
  10. Click Save and Exit.
  11. Locate your store's global_addressbook_lib.asp at <store install dir>/include/global_addressbook_lib.asp.
  12. Modify your store's global_addressbook_lib.asp file by adding the following code:

    13. Note  The procedure to modify your store's global_addressbook_lib.asp may not be applicable for future releases of the CyberSource CS2000 Component, as the content of global_addressbook_lib.asp may change. For more information, contact CyberSource Customer Support 

    Dim AddressEmail 
    Dim AddressPhone 
    Set dictFld = GetDictionary()  
    dictFld.Name = "tel_number"  
    dictFld.Label = "Telephone Number"  
    dictFld.Size = L_Standard_TextBox_Size_Number  
    dictFld.MinLength = L_Standard_TextBox_MinLength_Number  
    dictFld.MaxLength = L_Standard_TextBox_MaxLength_Number  
    dictFld.InputType = TEXTBOX  
    dictFld.ErrorMessage = "Bad or missing telephone number"  
    dictFld.IsRequired = True  
    Set AddressPhone = dictFld 
    Set dictFld = GetDictionary()  
    dictFld.Name = "email_address"  
    dictFld.Label = "Email Address"  
    dictFld.Size = L_Standard_TextBox_Size_Number  
    dictFld.MinLength = L_Standard_TextBox_MinLength_Number  
    dictFld.MaxLength = L_Standard_TextBox_MaxLength_Number  
    dictFld.InputType = TEXTBOX 
    dictFld.ErrorMessage = "Bad or missing email address" 
    dictFld.IsRequired = True  
    Set AddressEmail = dictFld 
 


      
         The above code should be added immediately after the following code, which already exists in the file:



    Function GetAddressFieldDefinitions()  
    Dim MSCSMessageManager  
    Dim sLanguage  
    Dim listFlds, dictFld 
    Set MSCSMessageManager = Application("MSCSMessageManager")  
    sLanguage = MSCSMessageManager.DefaultLanguage 
    Dim AddressLastName  
    Dim AddressFirstName  
    Dim AddressLine1  
    Dim AddressLine2  
    Dim AddressCity  
    Dim AddressRegion  
    Dim AddressPostalCode  
    Dim AddressCountry 
 


      
         Add the following code in the same GetAddressFieldDefinitions() function:



    Call listFlds.Add(AddressEmail)  
    Call listFlds.Add(AddressPhone) 
 


      
         The above two lines of code should be added immediately after the following code, which already exists in the file:



    Call listFlds.Add(AddressLastName)  
    Call listFlds.Add(AddressFirstName)  
    Call listFlds.Add(AddressLine1)  
    Call listFlds.Add(AddressLine2)  
    Call listFlds.Add(AddressCity)  
    Call listFlds.Add(AddressRegion)  
    Call listFlds.Add(AddressPostalCode)  
    Call listFlds.Add(AddressCountry)
  1. Restart your CS2000 machine before continuing to shop the store.
  2. Login to the sample store.
  3. Create a new user.
  4. Populate the new address with telephone number and email address fields on the ship-to address page.
    5. You should not have any problems with missing fields.
Copyright © 2002 CyberSource Corporation.
TOC PREV NEXT INDEX