E-Business Server
™
8.6
Product Guide
3
Encrypting to multiple recipients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
Encrypting multiple files to one recipient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
Encrypting information to a group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
Automatically encrypting to your own key
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
Encrypting for viewing by recipient only
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
Encrypting and signing
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
Encrypting and wiping the original plaintext file
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
Creating Self-Decrypting Archives (SDAs)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
Creating PGParchives
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64
Decrypting information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65
Viewing the decrypted file
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65
Decrypting SDAs and PGParchives
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66
9
Advanced Topics
68
Using scripts with E-Business Server
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
Using E-Business Server without interaction
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
Understanding E-Business Server exit status codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
Using E-Business Server as a UNIX-style filter
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
Working with ASCII and binary data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
Encrypting and transmitting binary data
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
Sending binary data files in ASCII-armored format without encryption or signature
. . . . . . . . . . . . . .70
Decrypting ASCII-armored messages
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
Sending a public key in ASCII-armored format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
Sending ASCII text files to different machine environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
Wiping your disk
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Wiping a sensitive data file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Wiping your smart card
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Alternative ways to work with passphrases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
Specifying a file descriptor number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
Storing your passphrase with PGPPASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
Passing your passphrase from another application
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
Working with groups
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
Creating a group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
Add recipients to a group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
Viewing a group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
Remove recipients from a group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
Removing an entire group
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
Starting the ebssdkd
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
Keeping your keyring files open with EBScache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
10
Using the E-Business Server API
78
Library and header file organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
E-Business Server API functions
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
Programming with the E-Business Server API
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
Programming on Win32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
Programming on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
11
Using the Configuration File
86
Learning about the configuration file
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
Specifying configuration values
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
Setting configuration parameters from the command line
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
Configuration parameters
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
12
Using Command-Line Options
112
Conventions used in this section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Primary command-line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
13
Using the E-Business Server Administration Utility
136
About the E-Business Server Administration Utility
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
The E-Business Server Administration Utility interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Getting Started with the E-Business Server Administration Utility console . . . . . . . . . . . . . . . . . . . . . . . 136
Starting the E-Business Server Administration Utility
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Adding a server
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137