Sun Oracle Logo


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

User’s Guide for Version 1.0

819-5536-12



Contents

Declaration of Conformity

Regulatory Compliance Statements

Using This Documentation

1. Product Overview

Product Features

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

Point Of Presence Button

Dynamic Reconfiguration and High Availability

Load Sharing

Hardware and Software Requirements

Oracle Solaris 10 on SPARC and x86 Platforms

Linux on x86 AMD Opteron Linux Platforms

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 Board 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

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

Installing 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 Without the remove Script

procedure iconsmall spaceRemove the Software

3. Administering the Sun Crypto Accelerator 6000 Board

Using the scamgr Utility

Modes of Operation

Single-Command Mode

File Mode

Interactive Mode

Logging In and Out With scamgr

scamgr Prompt

Logging In to a Board With scamgr

Logging In to a New Board

Logging In to a Board With a Changed Remote Access Key

Logging Out of a Board With scamgr

Entering Commands With scamgr

scamgr Commands

Getting Help for Commands

Quitting the scamgr Utility

Initializing the Board With scamgr

Initializing the Board With a New Keystore

procedure iconsmall spaceInitialize the Board With a New Keystore

Initializing the Board to Use an Existing Keystore

procedure iconsmall spaceInitialize the Board to Use an Existing Keystore

Managing Keystores With scamgr

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

procedure iconsmall spaceBack Up the Master Key

procedure iconsmall spaceLock the Keystore to Prevent Backups

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 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

Using the scadiag Utility

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

Additional Instructions for Administering the Board on Linux Platforms

4. Financial Services

Financial Service Components Overview

Enabling the Financial Services Feature

procedure iconsmall spaceEnable Financial Services

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

Allowed Key Forms

Direct Key Loading

Loading the MFK

Enabling the MFK

Loading the KEKs

Change 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

IBM-3624

Personal Account Number (PAN)

PIN

PVKI

PIN Verify Function fs_pin_verify()

PIN Translate Function fs_pin_translate()

Credit Card Processing Overview

Credit Card Processing Functions

Credit Card Verification Methods

Administering Financial Services

Financial Services Security Officers (FSSO)

Direct Input Device

Setting Financial Services Mode (fsmode)

Administrative Commands

5. Building 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 Board Keystore

Configuring Secure Failover for Sun Metaslot

Hardware Slot

PKCS#11 and FIPS Mode

Developing Applications to Use PKCS#11

Sun Crypto Accelerator 6000 Board PKCS#11 Implementation Specifics

Token Objects

Supported and Unsupported Functions

Random Number Generator

Software Attributes

Software Error Codes

Token Object Handles

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

6. Installing and Configuring Sun Java System Application 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

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

Installing and Configuring Sun Java System Web Server on Linux Platforms

7. Installing and Configuring Apache Web Server Software

Installing and Configuring Apache Web Server on Oracle Solaris Platforms

Creating a Private Key and Certificate

procedure iconsmall spaceCreate a Private Key and Certificate

Enabling Apache Web Server

procedure iconsmall spaceEnable the Apache Web Server

Installing and Configuring Apache Web Server on Linux Platforms

Preparing OpenSSL Libraries

Compiling Apache Web Server

Configuring and Starting Apache Web Server

8. 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

Using the kstat Utility

Determining Cryptographic Activity With the kstat Utility

Determining Cryptographic Activity On Linux Platforms

procedure iconsmall spaceDetermine Cryptographic Activity On Linux Platforms

A. Specifications

Sun Crypto Accelerator 6000 Board

Connectors

Physical Dimensions

Power Requirements

Environmental Specifications

B. Installing and Configuring openCryptoki Software for Linux

Installing openCryptoki Software

Preparing openCryptoki for 64 bit Applications

Installing the Libraries in the Standard Location

Creating openCryptoki Users and Groups

Starting openCryptoki

C. Software Licenses

Software License Agreements

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