File: amgpgcrypt.8

package info (click to toggle)
amanda 1%3A3.3.9-5
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 26,440 kB
  • sloc: ansic: 227,845; perl: 61,130; xml: 14,619; sh: 10,221; makefile: 2,364; awk: 431; lex: 405; yacc: 342; tcl: 118; sql: 19; sed: 16; php: 2
file content (162 lines) | stat: -rw-r--r-- 5,895 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
'\" t
.\"     Title: amgpgcrypt
.\"    Author: Kevin Till <kevin.till@zmanda.com>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 02/09/2016
.\"    Manual: System Administration Commands
.\"    Source: Amanda 3.3.9
.\"  Language: English
.\"
.TH "AMGPGCRYPT" "8" "02/09/2016" "Amanda 3\&.3\&.9" "System Administration Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
amgpgcrypt \- reference crypt program for Amanda public\-key data encryption
.SH "SYNOPSIS"
.HP \w'\fBamgpgcrypt\fR\ 'u
\fBamgpgcrypt\fR  to be called by Amanda only 
.SH "DESCRIPTION"
.PP
\fBamgpgcrypt\fR
calls
\fBgpg\fR
to perform public\-key data encryption on Amanda backup\&.
\fBamgpgcrypt\fR
will search for the gpg program in the following directories: /usr/local/bin:/usr/bin:/usr/sbin:/bin:/sbin
.PP
\fBamgpgcrypt\fR
sets GNUPGHOME to $AMANDA_HOME/\&.gnupg where gpg will look for the gpg keys\&.
\fBamgpgcrypt\fR
uses the public key to encrypt the Amanda data and uses the private key to decrypt the Amanda backup data\&. Thus, passphrase is only required at the time of data restore\&.
.SH "KEY AND PASSPHRASE"
.PP
\fBamgpgcrypt\fR
uses the private key to decrypt Amanda backup data\&.

It is very important to store, manage and  protect the key and the passphrase
properly\&. Encrypted backup data can \fBonly\fR be recovered with the correct key and
passphrase\&.
.SH "HOW TO CREATE ENCRYPTION KEYS AND PASSPHRASE FOR AMGPGCRYPT"
.PP
Store the passphrase that you used in following "gpg \-\-gen\-key" command inside the home\-directory of the AMANDA\-user($amanda_user) and protect it with proper permissions:

   echo my_secret_passphrase > ~$amanda_user/\&.am_passphrase
   chown $amanda_user:disk ~$amanda_user/\&.am_passphrase
   chmod 700 ~$amanda_user/\&.am_passphrase
.PP
Run "gpg \-\-gen\-key"\&. Below is an example:
.nf
$ gpg \-\-gen\-key
gpg (GnuPG) 1\&.2\&.6; Copyright (C) 2004 Free Software Foundation, Inc\&.
This program comes with ABSOLUTELY NO WARRANTY\&.
This is free software, and you are welcome to redistribute it
under certain conditions\&. See the file COPYING for details\&.

Please select what kind of key you want:
   (1) DSA and ElGamal (default)
   (2) DSA (sign only)
   (4) RSA (sign only)
Your selection? 1
DSA keypair will have 1024 bits\&.
About to generate a new ELG\-E keypair\&.
              minimum keysize is  768 bits
              default keysize is 1024 bits
    highest suggested keysize is 2048 bits
What keysize do you want? (1024)
Requested keysize is 1024 bits
Please specify how long the key should be valid\&.
         0 = key does not expire
      (n)  = key expires in n days
      (n)w = key expires in n weeks
      (n)m = key expires in n months
      (n)y = key expires in n years
Key is valid for? (0) 6m
Key expires at Sun 06 Aug 2006 03:51:25 PM PDT
Is this correct (y/n)? y

You need a User\-ID to identify your key; the software constructs the user id
from Real Name, Comment and Email Address in this form:
    "Heinrich Heine (Der Dichter) (heinrichh@duesseldorf\&.de)"

Real name: backup
Email address:
Comment: gpg keys for backup
You selected this USER\-ID:
    "backup (gpg keys for backup)"

Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit? o
You need a Passphrase to protect your secret key\&.

We need to generate a lot of random bytes\&. It is a good idea to perform
some other action (type on the keyboard, move the mouse, utilize the
disks) during the prime generation; this gives the random number
generator a better chance to gain enough entropy\&.

We need to generate a lot of random bytes\&. It is a good idea to perform
some other action (type on the keyboard, move the mouse, utilize the
disks) during the prime generation; this gives the random number
generator a better chance to gain enough entropy\&.

public and secret key created and signed\&.
key marked as ultimately trusted\&.

pub  1024D/4417A8CB 2006\-02\-07 backup (gpg keys for backup)
     Key fingerprint = 139C 6369 44FC 7F1A 655C  E5E9 7EAA 515A 4417 A8CB
sub  1024g/8C3A6A78 2006\-02\-07 [expires: 2006\-08\-06]
.fi
.SH "FILES"
.PP
\fB$AMANDA_HOME/\&.gnupg/pubring\&.gpg\fR
.RS 4
The public key\&.
\fBamgpgcrypt\fR
encrypt data with this public key along with the cipher algorithm\&.
.RE
.PP
\fB$AMANDA_HOME/\&.gnupg/secring\&.gpg\fR
.RS 4
The private/secret key\&. It\*(Aqs only needed during amrecover/amrestore\&. Store and protect it properly during other time\&.
.RE
.PP
\fB$AMANDA_HOME/\&.am_passphrase\fR
.RS 4
The passphrase\&. It\*(Aqs only needed during amrecover/amrestore\&. Store and protect it properly during other time\&.
.RE
.SH "BUGS"
.PP
Amanda has problem with gpg mdc(modification detection code) in the binary mode\&.
\fBamgpgcrypt\fR
calls gpg with mdc disabled
.SH "SEE ALSO"
.PP
\fBamanda\fR(8),
\fBamanda.conf\fR(5),
\fBamcrypt\fR(8),
\fBamrestore\fR(8),
\fBgpg\fR(1)
.PP
The Amanda Wiki:
: http://wiki.zmanda.com/
.SH "AUTHOR"
.PP
\fBKevin Till\fR <\&kevin\&.till@zmanda\&.com\&>
.RS 4
Zmanda, Inc\&. (http://www\&.zmanda\&.com)
.RE