![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to rdemo.txt CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [rsaref] / rsaref / doc|
Return to rdemo.txt CVS log | Up to [rsaref] / rsaref / doc |
1.1 root 1: RDEMO:
2: Demonstration program for RSAREF
3: User's manual
4:
5: RSA Laboratories
6: March 2, 1992
7:
8: Copyright (C) 1991-2 RSA Laboratories, a division of RSA Data
9: Security, Inc.
10:
11:
12: This note describes RDEMO, a demonstration program included with the
13: RSAREF cryptographic toolkit.
14:
15: RDEMO is a simple program that exercises RSAREF's cryptographic
16: operations. With RDEMO three "users" can perform the cryptographic
17: operations of signing, sealing, verifying, and opening files, as well
18: as generating key pairs.
19:
20: RDEMO has a main menu with six commands. The main menu is displayed
21: when you start up RDEMO, and is displayed again after RDEMO performs
22: a command. After you select a command RDEMO prompts for parameters
23: such as file names.
24:
25: RDEMO's commands and their parameters are summarized in the following
26: table.
27:
28:
29: RDEMO COMMAND PARAMETERS
30:
31: S - Sign a file name of file
32: sign contents with private whether you want content encoded
33: key which user you want to sign as
34: optionally encode contents name of file in which to save
35: in PEM character set(*) signature
36: name of file in which to save encoded
37: content(**)
38:
39: E - sEal a file name of file
40: sign contents with private which user you want to sign as
41: key which user you want to seal for
42: generate random DES key names of four files in which to save
43: IV(***) encrypted signature, encrypted key,
44: encrypt content, signature IV and encrypted content
45: with DES key
46:
47: V - Verify a signed file whether content is encoded
48: decode contents if encoded names of two files in which (possibly
49: in PEM character set encoded) content and signature are
50: verify signature on saved
51: contents with public key which user signed the file
52: name of file in which to save
53: recovered content(**)
54:
55: O - Open a sealed file names of four files in which encrypted
56: decrypt encrypted DES key content, encrypted signature,
57: with private key, encrypted key and IV are saved
58: decrypt encrypted content which user signed the file
59: signature with DES key which user the file was sealed for
60: verify signature on name of file in which to save
61: contents with public key recovered content
62:
63: G - Generate a keypair length of key in bits (508-1024)
64: generate RSA public/ name of file in which to save key pair
65: private key pair
66:
67: Q - Quit
68:
69:
70: (*) A 65-character subset of ASCII defined in RFC 1113. Most other
71: quantities are encoded in this set automatically.
72: (**) Only if content is encoded.
73: (***) Initialization vector for cipher-block chaining mode of DES.
74:
75:
76: NOTES
77:
78: 1. You select a user by number: '1', '2', or '3'. The first two
79: users have built-in RSA key pairs. The third user's key pair is
80: the one generated by RDEMO's 'Generate a key pair' command. The
81: third user is not active until the key pair is generated.
82:
83: 2. How you specify file names to RDEMO depends on your operating
84: system. RDEMO recognizes the special file name '-' as the
85: standard output stream (typically the screen display). You can
86: usually cancel an RDEMO command by giving a blank line in
87: response to a prompt for a parameter.
88:
89: 3. RDEMO reads most files and writes all files in binary mode. The
90: only exceptions are the files containing contents to be signed
91: or sealed. Those files are read in text mode, one line at a
92: time, with RDEMO replacing any <CR> and <LF> delimiters with a
93: <CR><LF> pair before encrypting, computing a message digest, or
94: encoding in printable ASCII. The <CR><LF> processing compensates
95: for differences in line delimiters in different operating
96: systems. RDEMO has a maximum file size of 1000 bytes.
97:
98: 4. RDEMO defaults to the MD5 message-digest algorithm for all
99: signatures. If you want the MD2 message-digest algorithm, put
100: the string '-2' on the command line when you start RDEMO.
101:
102: 5. If you want RDEMO not to display the main menu or any prompts,
103: put the string '-s' on the command line when you start RDEMO.
104: This is useful when RDEMO's input stream comes from a script
105: file.
106:
107: 6. RDEMO seeds RSAREF's random number generator with a fixed value.
108: As a result, RDEMO sessions with the same commands and
109: parameters produce the same results. The use of a fixed seed
110: value is not recommended for non-demonstration applications.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.