]> git.saurik.com Git - apt.git/blob - cmdline/apt-key
* Treat the Important flag like the Essential flag with two differences:
[apt.git] / cmdline / apt-key
1 #!/bin/sh
2
3 set -e
4 unset GREP_OPTIONS
5
6 # We don't use a secret keyring, of course, but gpg panics and
7 # implodes if there isn't one available
8 SECRETKEYRING="$(mktemp)"
9 trap "rm -f '${SECRETKEYRING}'" 0 HUP INT QUIT ILL ABRT FPE SEGV PIPE TERM
10 GPG_CMD="gpg --ignore-time-conflict --no-options --no-default-keyring --secret-keyring ${SECRETKEYRING}"
11
12 if [ "$(id -u)" -eq 0 ]; then
13 # we could use a tmpfile here too, but creation of this tends to be time-consuming
14 GPG_CMD="$GPG_CMD --trustdb-name /etc/apt/trustdb.gpg"
15 fi
16
17 GPG="$GPG_CMD"
18
19 MASTER_KEYRING=""
20 ARCHIVE_KEYRING_URI=""
21 #MASTER_KEYRING=/usr/share/keyrings/debian-master-keyring.gpg
22 #ARCHIVE_KEYRING_URI=http://ftp.debian.org/debian/debian-archive-keyring.gpg
23
24 ARCHIVE_KEYRING=/usr/share/keyrings/debian-archive-keyring.gpg
25 REMOVED_KEYS=/usr/share/keyrings/debian-archive-removed-keys.gpg
26
27 requires_root() {
28 if [ "$(id -u)" -ne 0 ]; then
29 echo >&1 "ERROR: This command can only be used by root."
30 exit 1
31 fi
32 }
33
34 add_keys_with_verify_against_master_keyring() {
35 ADD_KEYRING=$1
36 MASTER=$2
37
38 if [ ! -f "$ADD_KEYRING" ]; then
39 echo "ERROR: '$ADD_KEYRING' not found"
40 return
41 fi
42 if [ ! -f "$MASTER" ]; then
43 echo "ERROR: '$MASTER' not found"
44 return
45 fi
46
47 # when adding new keys, make sure that the archive-master-keyring
48 # is honored. so:
49 # all keys that are exported must have a valid signature
50 # from a key in the $distro-master-keyring
51 add_keys=`$GPG_CMD --keyring $ADD_KEYRING --with-colons --list-keys | grep ^pub | cut -d: -f5`
52 master_keys=`$GPG_CMD --keyring $MASTER --with-colons --list-keys | grep ^pub | cut -d: -f5`
53 for add_key in $add_keys; do
54 ADDED=0
55 for master_key in $master_keys; do
56 if $GPG_CMD --keyring $ADD_KEYRING --list-sigs --with-colons $add_key | grep ^sig | cut -d: -f5 | grep -q $master_key; then
57 $GPG_CMD --quiet --batch --keyring $ADD_KEYRING --export $add_key | $GPG --import
58 ADDED=1
59 fi
60 done
61 if [ $ADDED = 0 ]; then
62 echo >&2 "Key '$add_key' not added. It is not signed with a master key"
63 fi
64 done
65 }
66
67 # update the current archive signing keyring from a network URI
68 # the archive-keyring keys needs to be signed with the master key
69 # (otherwise it does not make sense from a security POV)
70 net_update() {
71 if [ -z "$ARCHIVE_KEYRING_URI" ]; then
72 echo >&2 "ERROR: Your distribution is not supported in net-update as no uri for the archive-keyring is set"
73 exit 1
74 fi
75 requires_root
76 # in theory we would need to depend on wget for this, but this feature
77 # isn't useable in debian anyway as we have no keyring uri nor a master key
78 if ! which wget >/dev/null 2>&1; then
79 echo >&2 "ERROR: an installed wget is required for a network-based update"
80 exit 1
81 fi
82 if [ ! -d /var/lib/apt/keyrings ]; then
83 mkdir -p /var/lib/apt/keyrings
84 fi
85 keyring=/var/lib/apt/keyrings/$(basename $ARCHIVE_KEYRING)
86 old_mtime=0
87 if [ -e $keyring ]; then
88 old_mtime=$(stat -c %Y $keyring)
89 fi
90 (cd /var/lib/apt/keyrings; wget -q -N $ARCHIVE_KEYRING_URI)
91 if [ ! -e $keyring ]; then
92 return
93 fi
94 new_mtime=$(stat -c %Y $keyring)
95 if [ $new_mtime -ne $old_mtime ]; then
96 echo "Checking for new archive signing keys now"
97 add_keys_with_verify_against_master_keyring $keyring $MASTER_KEYRING
98 fi
99 }
100
101 update() {
102 if [ ! -f $ARCHIVE_KEYRING ]; then
103 echo >&2 "ERROR: Can't find the archive-keyring"
104 echo >&2 "Is the debian-archive-keyring package installed?"
105 exit 1
106 fi
107 requires_root
108
109 # add new keys from the package;
110
111 # we do not use add_keys_with_verify_against_master_keyring here,
112 # because "update" is run on regular package updates. A
113 # attacker might as well replace the master-archive-keyring file
114 # in the package and add his own keys. so this check wouldn't
115 # add any security. we *need* this check on net-update though
116 $GPG_CMD --quiet --batch --keyring $ARCHIVE_KEYRING --export | $GPG --import
117
118 if [ -r "$REMOVED_KEYS" ]; then
119 # remove no-longer supported/used keys
120 keys=`$GPG_CMD --keyring $REMOVED_KEYS --with-colons --list-keys | grep ^pub | cut -d: -f5`
121 for key in $keys; do
122 if $GPG --list-keys --with-colons | grep ^pub | cut -d: -f5 | grep -q $key; then
123 $GPG --quiet --batch --delete-key --yes ${key}
124 fi
125 done
126 else
127 echo "Warning: removed keys keyring $REMOVED_KEYS missing or not readable" >&2
128 fi
129 }
130
131
132 usage() {
133 echo "Usage: apt-key [--keyring file] [command] [arguments]"
134 echo
135 echo "Manage apt's list of trusted keys"
136 echo
137 echo " apt-key add <file> - add the key contained in <file> ('-' for stdin)"
138 echo " apt-key del <keyid> - remove the key <keyid>"
139 echo " apt-key export <keyid> - output the key <keyid>"
140 echo " apt-key exportall - output all trusted keys"
141 echo " apt-key update - update keys using the keyring package"
142 echo " apt-key net-update - update keys using the network"
143 echo " apt-key list - list keys"
144 echo " apt-key finger - list fingerprints"
145 echo " apt-key adv - pass advanced options to gpg (download key)"
146 echo
147 echo "If no specific keyring file is given the command applies to all keyring files."
148 }
149
150 # Determine on which keyring we want to work
151 if [ "$1" = "--keyring" ]; then
152 #echo "keyfile given"
153 shift
154 TRUSTEDFILE="$1"
155 if [ -r "$TRUSTEDFILE" ] || [ "$2" = 'add' ]; then
156 GPG="$GPG --keyring $TRUSTEDFILE --primary-keyring $TRUSTEDFILE"
157 else
158 echo >&2 "Error: The specified keyring »$TRUSTEDFILE« is missing or not readable"
159 exit 1
160 fi
161 shift
162 # otherwise use the default
163 else
164 #echo "generate list"
165 TRUSTEDFILE="/etc/apt/trusted.gpg"
166 eval $(apt-config shell TRUSTEDFILE Apt::GPGV::TrustedKeyring)
167 eval $(apt-config shell TRUSTEDFILE Dir::Etc::Trusted/f)
168 if [ -r "$TRUSTEDFILE" ]; then
169 GPG="$GPG --keyring $TRUSTEDFILE"
170 fi
171 GPG="$GPG --primary-keyring $TRUSTEDFILE"
172 TRUSTEDPARTS="/etc/apt/trusted.gpg.d"
173 eval $(apt-config shell TRUSTEDPARTS Dir::Etc::TrustedParts/d)
174 if [ -d "$TRUSTEDPARTS" ]; then
175 #echo "parts active"
176 for trusted in $(run-parts --list $TRUSTEDPARTS --regex '^.*\.gpg$'); do
177 #echo "part -> $trusted"
178 GPG="$GPG --keyring $trusted"
179 done
180 fi
181 fi
182 #echo "COMMAND: $GPG"
183
184 command="$1"
185 if [ -z "$command" ]; then
186 usage
187 exit 1
188 fi
189 shift
190
191 if [ "$command" != "help" ] && ! which gpg >/dev/null 2>&1; then
192 echo >&2 "Warning: gnupg does not seem to be installed."
193 echo >&2 "Warning: apt-key requires gnupg for most operations."
194 echo >&2
195 fi
196
197 case "$command" in
198 add)
199 requires_root
200 $GPG --quiet --batch --import "$1"
201 echo "OK"
202 ;;
203 del|rm|remove)
204 requires_root
205 $GPG --quiet --batch --delete-key --yes "$1"
206 echo "OK"
207 ;;
208 update)
209 update
210 ;;
211 net-update)
212 net_update
213 ;;
214 list)
215 $GPG --batch --list-keys
216 ;;
217 finger*)
218 $GPG --batch --fingerprint
219 ;;
220 export)
221 $GPG --armor --export "$1"
222 ;;
223 exportall)
224 $GPG --armor --export
225 ;;
226 adv*)
227 echo "Executing: $GPG $*"
228 $GPG $*
229 ;;
230 help)
231 usage
232 ;;
233 *)
234 usage
235 exit 1
236 ;;
237 esac