Imported Upstream version 2.5.0
[debian/amanda] / man / amcrypt.8
1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
2 .de Sh \" Subsection
3 .br
4 .if t .Sp
5 .ne 5
6 .PP
7 \fB\\$1\fR
8 .PP
9 ..
10 .de Sp \" Vertical space (when we can't use .PP)
11 .if t .sp .5v
12 .if n .sp
13 ..
14 .de Ip \" List item
15 .br
16 .ie \\n(.$>=3 .ne \\$3
17 .el .ne 3
18 .IP "\\$1" \\$2
19 ..
20 .TH "AMCRYPT" 8 "" "" ""
21 .SH NAME
22 amcrypt \- reference crypt program for Amanda symmetric data encryption
23 .SH "SYNOPSIS"
24 .ad l
25 .hy 0
26 .HP 8
27 \fBamcrypt\fR
28 .ad
29 .hy
30
31 .SH "DESCRIPTION"
32
33 .PP
34  \fBamcrypt\fR requires \fBaespipe\fR and \fBgpg\fR to work\&. Aespipe is available from : http://loop-aes.sourceforge.net
35
36 .PP
37  \fBamcrypt\fR will search for the aespipe program in the following directories: /usr/bin:/usr/local/bin:/sbin:/usr/sbin\&.
38 \fBamcrypt\fR calls  \fBamaespipe\fR and pass the
39 \fBpassphrase\fR through file descriptor 3\&.
40 The passphrase should be stored in ~amanda/\&.am_passphrase\&.
41
42 .SH "HOW TO CREATE ENCRYPTION KEYS FOR AMCRYPT"
43
44 1\&. Create 65 random encryption keys and encrypt those keys using gpg\&. Reading
45 from /dev/random may take indefinitely long if kernel's random entropy pool
46 is empty\&. If that happens, do some other work on some other console (use
47 keyboard, mouse and disks)\&. 
48
49 .PP
50 head \-c 2925 /dev/random | uuencode \-m \- | head \-n 66 | tail \-n 65 \\ | gpg \-\-symmetric \-a > ~amanda/\&.gnupg/am_key\&.gpg
51
52 .PP
53 This will ask for a passphrase\&. Remember this passphrase as you will need it in the next step\&.
54
55 .PP
56 2\&. Store the passphrase inside the home\-directory of the AMANDA\-user and protect it with proper permissions:
57 .nf
58
59 echo my_secret_passphrase > ~amanda/\&.am_passphrase
60 chown amanda:disk ~amanda/\&.am_passphrase
61 chmod 700 ~amanda/\&.am_passphrase
62 .fi
63
64 .SH "KEY AND PASSPHRASE"
65
66 .PP
67  \fBamcrypt\fR uses the same key to encrypt and decrypt data\&.
68
69 It is very important to store and protect the key and the passphrase
70 properly\&. Encrypted backup data can \fBonly\fR be recovered with the correct key and
71 passphrase\&.
72
73 .SH "SEE ALSO"
74
75 .PP
76 \fBamanda\fR(8), \fBamanda\&.conf\fR(5), \fBaespipe\fR(1), \fBamaespipe\fR(8), \fBgpg\fR(1) 
77