Sun ONE logo      Previous      Contents      Index      Next     

Sun ONE Portal Server, Secure Remote Access 6.1 Administrator's Guide

Appendix A
Configuring the SSL Accelerator

This chapter introduces you to the SSL Accelerator and explains its configuration.

This chapter covers the following topics:


Overview of the SSL Accelerator

Using a hardware accelerator speeds up the execution of cryptographic algorithms, thereby increasing the performance speed.

The Sun™ Crypto Accelerator 1000 board is a short PCI board that functions as a cryptographic co-processor to accelerate public key and symmetric cryptography. This product has no external interfaces. The board communicates with the host through the internal PCI bus interface. The purpose of this board is to accelerate a variety of computationally intensive cryptographic algorithms for security protocols in eCommerce applications.


Enabling SSL Hardware Support for the Sun™ ONE Portal Server, Secure Remote Access

Ensure that the Sun™ ONE Portal Server, Secure Remote Access has been installed, and a gateway server certificate (self-signed or issued by any CA) has been installed. The following checklist helps you keep track of the required information before installing the SSL Accelerator. Table 6-4 has two columns. The first column lists the parameter and the second column lists the value.

Table 6-4  SSL Accelerator Installation Checklist

Parameter

Value

Crypto Accelerator

Sun™ Crypto Accelerator 1000

Secure Remote Access installation base dir

/opt

Secure Remote Access certificate database dir

/etc/opt/SUNWps/cert

Secure Remote Access server certificate nickname

server-cert

Realm

srap

Realm user

crypta

    To Configure the SSL Accelerator


Note

csh is assumed for all shell commands in the following steps.


  1. Follow the instructions in the hardware user's guide to install the hardware.
  2. Install the following packages from the Sun™ Crypto Accelerator 1000 install CD.
    • SUNWcrypm
    • SUNWcrypu
    • SUNWcrysu
    • SUNWdcar
    • SUNWcrypr
    • SUNWcrysl
    • SUNWdcamn
    • SUNWdcav
  3. Install the following patches:
  4. Ensure that you have the tools pk12util and modutil.
  5. These tools can be found under InstallDir/SUNWps/bin when you install Secure Remote Access.

  6. Create the slots file as follows:
  7. vi /etc/opt/SUNWconn/crypto/slots

  8. Include the following single line in the slots file:
  9. crypta@srap

  10. Create a realm and a user using the following commands:
  11. cd InstallDir/SUNWconn/bin

    ./secadm

    secadm> create realm=srap

    System Administrator Login Required

    Login: root

    Password:

    Realm srap created successfully.

    secadm> set realm=srap

    secadm{srap}> su

    System Administrator Login Required

    Login: root

    Password:

    secadm{root@srap}# create user=crypta

    Initial password:

    Confirm password:

    User crypta created successfully.

    secadm{root@srap}# login user=crypta

    Password:

    See the Sun Crypto Accelerator 1000 Board Installation and User’s Guide for details on realms and users.

  12. Run the show key command to verify that no keys exist for the user you created.
  13. secadm{crypta@srap}> show key

    No keys exist for this user.

  14. Load the Sun Crypto module as follows:
  15. cd InstallDir/SUNWps/bin

    setenv LD_LIBRARY_PATH InstallDir/SUNWps/lib/solaris/sparc

    modutil -dbdir /etc/opt/SUNWps/cert -add "Sun Crypto Module" -libfile InstallDir/SUNWconn/crypto/lib/libpkcs11.so

  16. Verify that the Sun Crypto module has been loaded as follows:
  17. modutil -list -dbdir /etc/opt/SUNWps/cert

  18. Export the certificate and the key to the Sun Crypto module as follows:
  19. cd InstallDir/SUNWps/bin

    setenv LD_LIBRARY_PATH InstallDir/SUNWps/lib/solaris/sparc

    pk12util -o servercert.p12 -d /etc/opt/SUNWps/cert -n server-cert

    pk12util -i servercert.p12 -d /etc/opt/SUNWps/cert -h "crypta@srap" -K password -W password

  20. Run the show key command as shown in step 8.
  21. You should see 2 keys for this user.

  22. Change the nickname in the /etc/opt/SUWNps/cert/.nickname file.
  23. vi /etc/opt/SUWNps/cert/.nickname

    Replace server-cert with crypta@srap:server-cert

  24. Restart the gateway.
  25. The gateway is now enabled with the Sun Crypto Hardware Accelerator 1000 support.



Previous      Contents      Index      Next     


Copyright 2003 Sun Microsystems, Inc. All rights reserved.