Sun Oracle Logo


Sun Crypto Accelerator 6000 Board User’s Guide for Version 1.1

User’s Guide

E39851-01



Feedback Contents

Regulatory Compliance Statements

Preface

1. Product Overview

Product Features

New Features in the 1.1 Release

Key Features

Financial Services Support

Supported Applications

Supported Cryptographic Protocols and Algorithms

Diagnostic Support

Cryptographic Algorithm Acceleration

Hardware Overview

LED Displays

Direct Input Devices

Serial Port

USB Port

Dynamic Reconfiguration and High Availability

Load Sharing

Hardware and Software Requirements

Oracle Solaris 10 OS on SPARC and x86 Platforms

x86 AMD Opteron Platforms Running Linux

Required Patches

2. Installing the Sun Crypto Accelerator 6000 Board

Handling the Board

Installing the Board on Oracle Solaris Platforms

procedure iconsmall spaceInstall the Hardware

Installing the Sun Crypto Accelerator 6000 Software With the install Script

procedure iconsmall spaceInstall the Software With the install Script

Directories and Files for Oracle Solaris Platforms

Removing the Sun Crypto Accelerator 6000 Software on Oracle Solaris Platforms With the remove Script

procedure iconsmall spaceRemove the Software With the remove Script on the CD-ROM

procedure iconsmall spaceFor Oracle Solaris 11, Remove the Software With the remove Script

Installing the Software on Oracle Solaris Platforms Without the Installation Script

procedure iconsmall spaceInstall the Software Without the install Script

Removing the Software on Oracle Solaris Platforms Without the remove Script

procedure iconsmall spaceDelete Existing Keystores

procedure iconsmall spaceRemove the Software Without the remove Script

Installing the Sun Crypto Accelerator 6000 Board on Linux Platforms

procedure iconsmall spaceInstall the Sun Crypto Accelerator 6000 Hardware on Linux Platforms

procedure iconsmall spaceInstall the Sun Crypto Accelerator 6000 Software on Linux Platforms With the install Script

Installing the Sun Crypto Accelerator 6000 Software on Linux Platforms Without the install Script

procedure iconsmall spaceInstall the Software Without the install Script

Directories and Files for Linux Platforms

Removing the Sun Crypto Accelerator 6000 Software on Linux Platforms

Removing the Sun Crypto Accelerator 6000 Software With the remove Script

procedure iconsmall spaceRemove the Software With the remove Script

procedure iconsmall spaceRemove the Software Without the remove Script

Migrating Back to Version 1.0 From 1.1

procedure iconsmall spaceBack Up the 1.0 Keystore

procedure iconsmall spaceRestore the 1.0 Software and Firmware:

3. Administering the Sun Crypto Accelerator 6000 Board

Using the scamgr Utility

Device and Keystore Security Officers

scamgr Syntax

scamgr Options

Modes of Operation

Interactive Mode

Single-Command Mode

File Mode

scamgr Secure Communication

Initializing the Board With scamgr

Board Initialization

procedure iconsmall spacePerform a Board Initialization

Keystore Initialization

procedure iconsmall spacePerform a Keystore Initialization and Create a New Keystore

Performing a Keystore Initialization to Use an Existing Keystore

procedure iconsmall spacePerform a Keystore Initialization and Use an Existing Keystore

Authentication and Logging In and Out With scamgr

scamgr Prompt

procedure iconsmall spaceLog In To a Board With scamgr

procedure iconsmall spaceLog In To a New Board

procedure iconsmall spaceLog In To a Board With a Changed Remote Access Key

procedure iconsmall spaceLog Out Of a Board With scamgr

procedure iconsmall spaceLog In To Another Board

Quitting the scamgr Utility

procedure iconsmall spaceQuit the scamgr Utility

Entering Commands With scamgr

Entering scamgr Commands

scamgr Commands

Getting Help for Commands

Managing Keystores With scamgr

Multiple Keystore Support

Naming Requirements

Password Requirements

procedure iconsmall spaceSet the Password Requirements

procedure iconsmall spaceChange Password Requirements

procedure iconsmall spaceChange Passwords

Managing Security Officers and Users

procedure iconsmall spacePopulate a Keystore With Security Officers

procedure iconsmall spacePopulate a Keystore With Users

procedure iconsmall spaceList Users

procedure iconsmall spaceList Security Officers

procedure iconsmall spaceDisable Users

procedure iconsmall spaceEnable Users

procedure iconsmall spaceDelete Users

procedure iconsmall spaceDelete Security Officers

Backing Up Configuration and Keystore Data

procedure iconsmall spaceBack Up a Device Configuration

procedure iconsmall spaceBack Up a Master Key

procedure iconsmall spaceBackup A Keystore

Locking Keystores to Restrict Access

procedure iconsmall spaceLock a Master Key to Prevent Backups

procedure iconsmall spaceLock a Keystore To Restrict Access

procedure iconsmall spaceEnable a Locked Keystore To Enable Access

procedure iconsmall spaceDisable a Locked Keystore To Prevent Access

Multi-Admin Authentication

Managing Multi-Admin Mode With scamgr

procedure iconsmall spaceAssign Security Officers the Multi-Admin Role

procedure iconsmall spaceRemove a Security Officer From the Multi-Admin Role

procedure iconsmall spaceSet the Minimum Number of Security Officers Required to Authenticate Multi-Admin Commands

procedure iconsmall spaceSet a Multi-Admin Command Timeout

procedure iconsmall spaceEnable Multi-Admin Mode

procedure iconsmall spaceDisable Multi-Admin Mode

procedure iconsmall spaceAdd Additional Security Officers to the Multi-Admin Role

procedure iconsmall spaceCancel a Multi-Admin Command Originated by the Initiating Security Officer

procedure iconsmall spaceAllow a Multi-Admin Command to Time Out

procedure iconsmall spaceLog In to a Board During a Multi-Admin Command as a Security Officer Not in the Multi-Admin Role

procedure iconsmall spaceAttempt to Execute a Multi-Admin Command Without Multi-Admin Role Permissions

Managing Boards With scamgr

procedure iconsmall spaceSet the Auto-Logout Time

procedure iconsmall spaceDisplay Board Status

procedure iconsmall spaceLoad New Firmware

procedure iconsmall spaceReset the Board

procedure iconsmall spaceRekey the Board

procedure iconsmall spacePerform a Software Zeroize on the Board

procedure iconsmall spaceUse the scamgr diagnostics Command

Direct Board Administration

USB Backup Support

Using the scadiag Utility

scadiag Options

scadiag Option Examples

Managing Services for Oracle Solaris Platforms

procedure iconsmall spaceStart and Stop the Services

Service Configuration Parameters

procedure iconsmall spaceList Service Configuration Parameters

procedure iconsmall spaceModify Service Configuration Parameters

Enabling Optional Cryptographic Algorithms

procedure iconsmall spaceEnable the SHA-512 Algorithm

procedure iconsmall spaceEnable the RC2 CBC Algorithm

procedure iconsmall spaceEnable the Multi-part MD5 Algorithm

procedure iconsmall spaceEnable the Multi-part SHA1 Algorithm

procedure iconsmall spaceEnable the Multi-part SHA512 Algorithm

procedure iconsmall spaceEnable the HMAC (MD5 or SHA1) Algorithm

Additional Instructions for Administering the Board on Linux Platforms

scamgr Program

procedure iconsmall spaceStop the Board on a Linux Platform

procedure iconsmall spaceStart the Board on a Linux Platform

scadiag Program

4. Configuring Centralized Keystores

Centralized Keystore Overview

Keystore Virtualization

Configuring Centralized Keystores

Configuring the Directory Server With the scakscfg Utility

Configuring the scakiod Service to Use CKS

scakiod Service Configuration Options

procedure iconsmall spaceConfigure the scakiod Service to Use CKS (Oracle Solaris)

procedure iconsmall spaceConfigure the scakiod Service to Use CKS (Linux)

Configuring the scakiod Service to Use SSL With Simple Authentication

procedure iconsmall spaceConfigure scakiod for Simple Authentication Over SSL

Configuring the scakiod Service to Use SSL With Client Certificate Authentication

procedure iconsmall spaceConfigure the scakiod Service to Use SSL With Client Certificate Authentication

Adding the Certificate to the Agent Entry in the Directory Server

procedure iconsmall spaceAdd the Certificate to the Agent Entry in the DS

Configuring the Board to Join a Centralized Keystore

procedure iconsmall spaceJoin a Previously Configured Board to a Centralized Keystore

procedure iconsmall spaceJoin an Unconfigured Board to a Centralized Keystore

Troubleshooting CKS Issues

Cannot Contact Server

Initial Keystore Search Failed

Failed Binding to Server

Failed Binding to Server

Client Authentication Initialization Failed

5. Developing and Administering Financial Services

Financial Service Components Overview

Financial Services Library Initialization

Library Open Function fs_lib_open()

Library Shutdown Function fs_lib_close()

Session Establishment Function fs_session_open()

Session Shutdown Function fs_session_close()

Financial Services Data Types

Key Management Overview

Key Separation and Compartmentalization of Risk

Permitted Key Forms

Direct Key Loading

procedure iconsmall spaceLoad the MFK

procedure iconsmall spaceEnable the MFK

procedure iconsmall spaceLoad the KEKs

procedure iconsmall spaceChange the MFK

Key Management Functions

Generate Key Function fs_generate_key()

Import Key Function fs_import_key()

Export Key Function fs_export_key()

Translate Key Function fs_translate_key()

Retrieve Object Function fs_retrieve_object()

Status Function fs_status()

PIN Processing Functions

PIN Block Formats

ANSI/ISO Format 0

ISO Format 1

PIN Calculation Methods

Visa PVV Method

IBM-3624 Method

Personal Account Number

PIN

PVKI

PIN Verify Function fs_pin_verify()

PIN Translate Function fs_pin_translate()

Credit Card Processing Overview

Financial Services Library Function fs_card_verify(3)

Enabling the Financial Services Feature

procedure iconsmall spaceEnable Financial Services

Administering Financial Services

Financial Services Security Officers

Direct Input Device

Setting Financial Services Mode

Administrative Commands

6. Developing PKCS#11 Applications for Use With the Sun Crypto Accelerator 6000 Board

Board Administration

Slot Descriptions

Keystore Slot

Sun Metaslot

Configuring Sun Metaslot to Use the Sun Crypto Accelerator 6000 Keystore

Configuring Secure Failover for Sun Metaslot

Hardware Slot

PKCS#11 and FIPS Mode

Developing Applications to Use PKCS#11

Sun Crypto Accelerator 6000 PKCS#11 Implementation Specifics

Token Objects

Supported and Unsupported Functions

Random Number Generator

Software Attributes

Software Error Codes

Token Object Handles

Developing PKCS#11 Applications for Use With the Sun Crypto Accelerator 6000 Board on Linux Platforms

7. Installing and Configuring Sun Java System Server Software

Administering Security for Sun Java System Web Servers

Web Server Concepts and Terminology

Users

Keystores

Slots and Tokens

Preparing to Configure Sun Java System Web Servers

Populating a Keystore

procedure iconsmall spacePopulate a Keystore

Installing and Configuring Sun Java System Web Server 6.1

procedure iconsmall spaceInstall Sun Java System Web Server 6.1

procedure iconsmall spaceCreate a Trust Database

procedure iconsmall spaceRegister the Board With the Web Server

procedure iconsmall spaceGenerate a Server Certificate

procedure iconsmall spaceInstall the Server Certificate

procedure iconsmall spaceEnable the Web Server for SSL

Installing and Configuring Sun Java System Web Server 7.0 Update 1

procedure iconsmall spaceInstall Sun Java System Web Server 7.0

procedure iconsmall spaceRegister the Board With the Web Server

procedure iconsmall spaceStart the Sun Java System Web Server Administration Server

procedure iconsmall spaceManage the Tokens

procedure iconsmall spaceDisable Unused Tokens

procedure iconsmall spacePre-Set the Password for Tokens

procedure iconsmall spaceGenerate a Server Certificate

procedure iconsmall spaceInstall the Server Certificate

procedure iconsmall spaceDeploy the Change

procedure iconsmall spaceEnable the Web Server for SSL

procedure iconsmall spaceStart the Web Server

Installing and Configuring Sun Java System Web Server on Linux Platforms

Configuring Sun Java System Web Servers to Start Up Without User Interaction on Reboot

procedure iconsmall spaceCreate an Encrypted Key for Automatic Startup of Sun Java System Web Servers on Reboot

8. Installing and Configuring Apache Web Server Software

Installing and Configuring Apache Web Server on Oracle Solaris Platforms

procedure iconsmall spaceCreate a Private Key and Certificate

procedure iconsmall spaceEnable Apache Web Server

Installing and Configuring Apache Web Server on Linux Platforms

procedure iconsmall spacePrepare OpenSSL Libraries

procedure iconsmall spaceCompile Apache Web Server

procedure iconsmall spaceConfigure and Start Apache Web Server

9. Diagnostics and Troubleshooting

Diagnostic Software

Performing SunVTS Diagnostics

Performing scamgr Diagnostics

Performing scadiag Diagnostics

Disabling Crypto Traffic on Other Hardware Providers in Your System

procedure iconsmall spaceDisable Other Hardware Providers

procedure iconsmall spaceReenable Other Hardware Providers

Examining and Reporting Kernel Statistics

procedure iconsmall spaceDetermine Cryptographic Activity With the kstat Utility

Determining Cryptographic Activity on Linux Platforms

procedure iconsmall spaceDetermine Cryptographic Activity on Linux Platforms

A. Sun Crypto Accelerator 6000 Board Specifications

Connectors

Physical Dimensions

Power Requirements

Environmental Specifications

B. Installing and Configuring openCryptoki Software for Linux

Overview

Installing openCryptoki Software

procedure iconsmall spaceInstall openCryptoki Software on RHEL5

procedure iconsmall spaceBuild and Install openCryptoki on RHEL4 Updates

procedure iconsmall spaceBuild and Install openCryptoki Software on SUSE10 SP1 Platforms

C. Software Licenses

Third Party License Terms

D. Manual Pages

E. Zeroizing the Hardware

Zeroizing the Sun Crypto Accelerator 6000 Hardware to the Factory State

procedure iconsmall spaceZeroize the Sun Crypto Accelerator 6000 Board With a Hardware Jumper

F. Financial Services Header File

G. Supported PKCS#11 Mechanisms

Index

Feedback