9fff77a968567e275991ccd9e2549d96612aa4d0
[monkeysphere.git] / src / monkeysphere
1 #!/usr/bin/env bash
2
3 # monkeysphere: Monkeysphere client tool
4 #
5 # The monkeysphere scripts are written by:
6 # Jameson Rollins <jrollins@fifthhorseman.net>
7 # Jamie McClelland <jm@mayfirst.org>
8 # Daniel Kahn Gillmor <dkg@fifthhorseman.net>
9 # Micah Anderson <micah@riseup.net>
10 #
11 # They are Copyright 2008-2009, and are all released under the GPL, version 3
12 # or later.
13
14 ########################################################################
15 set -e
16
17 PGRM=$(basename $0)
18
19 SYSSHAREDIR=${MONKEYSPHERE_SYSSHAREDIR:-"/usr/share/monkeysphere"}
20 export SYSSHAREDIR
21 . "${SYSSHAREDIR}/defaultenv"
22 . "${SYSSHAREDIR}/common"
23
24 # sharedir for host functions
25 MSHAREDIR="${SYSSHAREDIR}/m"
26
27 # UTC date in ISO 8601 format if needed
28 DATE=$(date -u '+%FT%T')
29
30 # unset some environment variables that could screw things up
31 unset GREP_OPTIONS
32
33 # set the file creation mask to be only owner rw
34 umask 077
35
36 ########################################################################
37 # FUNCTIONS
38 ########################################################################
39
40 usage() {
41     cat <<EOF >&2
42 usage: $PGRM <subcommand> [options] [args]
43 Monkeysphere client tool.
44
45 subcommands:
46  update-known_hosts (k) [HOST]...    update known_hosts file
47  update-authorized_keys (a)          update authorized_keys file
48  gen-subkey (g) [KEYID]              generate an authentication subkey
49    --length (-l) BITS                  key length in bits (2048)
50  ssh-proxycommand HOST [PORT]        monkeysphere ssh ProxyCommand
51    --no-connect                        do not make TCP connection to host
52  subkey-to-ssh-agent (s)             store authentication subkey in ssh-agent
53  sshfpr (f) KEYID                    output ssh fingerprint of gpg key
54  version (v)                         show version number
55  help (h,?)                          this help
56
57 EOF
58 }
59
60 # user gpg command to define common options
61 gpg_user() {
62     gpg --no-greeting --quiet --no-tty "$@"
63 }
64
65 # output the ssh fingerprint of a gpg key
66 gpg_ssh_fingerprint() {
67     keyid="$1"
68     local tmpfile=$(mktemp)
69
70     # trap to remove tmp file if break
71     trap "rm -f $tmpfile" EXIT
72
73     # use temporary file, since ssh-keygen won't accept keys on stdin
74     gpg_user --export "$keyid" | openpgp2ssh "$keyid" >"$tmpfile"
75     ssh-keygen -l -f "$tmpfile" | awk '{ print $1, $2, $4 }'
76
77     # remove the tmp file
78     trap - EXIT
79     rm -rf "$tmpfile"
80 }
81
82 # take a secret key ID and check that only zero or one ID is provided,
83 # and that it corresponds to only a single secret key ID
84 check_gpg_sec_key_id() {
85     local gpgSecOut
86
87     case "$#" in
88         0)
89             gpgSecOut=$(gpg_user --fixed-list-mode --list-secret-keys --with-colons 2>/dev/null | egrep '^sec:')
90             ;;
91         1)
92             gpgSecOut=$(gpg_user --fixed-list-mode --list-secret-keys --with-colons "$1" | egrep '^sec:') || failure
93             ;;
94         *)
95             failure "You must specify only a single primary key ID."
96             ;;
97     esac
98
99     # check that only a single secret key was found
100     case $(echo "$gpgSecOut" | grep -c '^sec:') in
101         0)
102             failure "No secret keys found.  Create an OpenPGP key with the following command:
103  gpg --gen-key"
104             ;;
105         1)
106             echo "$gpgSecOut" | cut -d: -f5
107             ;;
108         *)
109             local seckeys=$(echo "$gpgSecOut" | cut -d: -f5)
110             failure "Multiple primary secret keys found:
111 $seckeys
112 Please specify which primary key to use."
113             ;;
114     esac
115 }
116
117 # check that a valid authentication subkey does not already exist
118 check_gpg_authentication_subkey() {
119     local keyID
120     local IFS
121     local line
122     local type
123     local validity
124     local usage
125
126     keyID="$1"
127
128     # check that a valid authentication key does not already exist
129     IFS=$'\n'
130     for line in $(gpg_user --fixed-list-mode --list-keys --with-colons "$keyID") ; do
131         type=$(echo "$line" | cut -d: -f1)
132         validity=$(echo "$line" | cut -d: -f2)
133         usage=$(echo "$line" | cut -d: -f12)
134
135         # look at keys only
136         if [ "$type" != 'pub' -a "$type" != 'sub' ] ; then
137             continue
138         fi
139         # check for authentication capability
140         if ! check_capability "$usage" 'a' ; then
141             continue
142         fi
143         # if authentication key is valid, prompt to continue
144         if [ "$validity" = 'u' ] ; then
145             echo "A valid authentication key already exists for primary key '$keyID'." 1>&2
146             if [ "$PROMPT" = "true" ] ; then
147                 printf "Are you sure you would like to generate another one? (y/N) " >&2
148                 read OK; OK=${OK:N}
149                 if [ "${OK/y/Y}" != 'Y' ] ; then
150                     failure "aborting."
151                 fi
152                 break
153             else
154                 failure "aborting."
155             fi
156         fi
157     done
158 }
159
160 ########################################################################
161 # MAIN
162 ########################################################################
163
164 # set unset default variables
165 GNUPGHOME=${GNUPGHOME:="${HOME}/.gnupg"}
166 KNOWN_HOSTS="${HOME}/.ssh/known_hosts"
167 HASH_KNOWN_HOSTS="true"
168 AUTHORIZED_KEYS="${HOME}/.ssh/authorized_keys"
169
170 # unset the check keyserver variable, since that needs to have
171 # different defaults for the different functions
172 unset CHECK_KEYSERVER
173
174 # load global config
175 [ -r "${SYSCONFIGDIR}/monkeysphere.conf" ] \
176     && . "${SYSCONFIGDIR}/monkeysphere.conf"
177
178 # set monkeysphere home directory
179 MONKEYSPHERE_HOME=${MONKEYSPHERE_HOME:="${HOME}/.monkeysphere"}
180 mkdir -p -m 0700 "$MONKEYSPHERE_HOME"
181
182 # load local config
183 [ -e ${MONKEYSPHERE_CONFIG:="${MONKEYSPHERE_HOME}/monkeysphere.conf"} ] \
184     && . "$MONKEYSPHERE_CONFIG"
185
186 # set empty config variables with ones from the environment
187 GNUPGHOME=${MONKEYSPHERE_GNUPGHOME:=$GNUPGHOME}
188 LOG_LEVEL=${MONKEYSPHERE_LOG_LEVEL:=$LOG_LEVEL}
189 KEYSERVER=${MONKEYSPHERE_KEYSERVER:=$KEYSERVER}
190 # if keyserver not specified in env or conf, then look in gpg.conf
191 if [ -z "$KEYSERVER" ] ; then
192     if [ -f "${GNUPGHOME}/gpg.conf" ] ; then
193         KEYSERVER=$(grep -e "^[[:space:]]*keyserver " "${GNUPGHOME}/gpg.conf" | tail -1 | awk '{ print $2 }')
194     fi
195 fi
196 PROMPT=${MONKEYSPHERE_PROMPT:=$PROMPT}
197 KNOWN_HOSTS=${MONKEYSPHERE_KNOWN_HOSTS:=$KNOWN_HOSTS}
198 HASH_KNOWN_HOSTS=${MONKEYSPHERE_HASH_KNOWN_HOSTS:=$HASH_KNOWN_HOSTS}
199 AUTHORIZED_KEYS=${MONKEYSPHERE_AUTHORIZED_KEYS:=$AUTHORIZED_KEYS}
200 STRICT_MODES=${MONKEYSPHERE_STRICT_MODES:=$STRICT_MODES}
201
202 # other variables not in config file
203 AUTHORIZED_USER_IDS=${MONKEYSPHERE_AUTHORIZED_USER_IDS:="${MONKEYSPHERE_HOME}/authorized_user_ids"}
204 REQUIRED_HOST_KEY_CAPABILITY=${MONKEYSPHERE_REQUIRED_HOST_KEY_CAPABILITY:="a"}
205 REQUIRED_USER_KEY_CAPABILITY=${MONKEYSPHERE_REQUIRED_USER_KEY_CAPABILITY:="a"}
206 # note that only using '=' instead of ':=' tests only if the variable
207 # in unset, not if it's "null"
208 LOG_PREFIX=${MONKEYSPHERE_LOG_PREFIX='ms: '}
209
210 # export GNUPGHOME and make sure gpg home exists with proper
211 # permissions
212 export GNUPGHOME
213 mkdir -p -m 0700 "$GNUPGHOME"
214 export LOG_LEVEL
215 export LOG_PREFIX
216
217 # get subcommand
218 COMMAND="$1"
219 [ "$COMMAND" ] || failure "Type '$PGRM help' for usage."
220 shift
221
222 case $COMMAND in
223     'update-known_hosts'|'update-known-hosts'|'k')
224         # whether or not to check keyservers
225         CHECK_KEYSERVER=${MONKEYSPHERE_CHECK_KEYSERVER:=${CHECK_KEYSERVER:="true"}}
226
227         # if hosts are specified on the command line, process just
228         # those hosts
229         if [ "$1" ] ; then
230             update_known_hosts "$@"
231
232         # otherwise, if no hosts are specified, process every host
233         # in the user's known_hosts file
234         else
235             process_known_hosts
236         fi
237         ;;
238
239     'update-authorized_keys'|'update-authorized-keys'|'a')
240         # whether or not to check keyservers
241         CHECK_KEYSERVER=${MONKEYSPHERE_CHECK_KEYSERVER:=${CHECK_KEYSERVER:="true"}}
242
243         # process authorized_user_ids file
244         process_authorized_user_ids "$AUTHORIZED_USER_IDS"
245         ;;
246
247     'import-subkey'|'i')
248         source "${MSHAREDIR}/import_subkey"
249         import_subkey "$@"
250         ;;
251
252     'gen-subkey'|'g')
253         source "${MSHAREDIR}/gen_subkey"
254         gen_subkey "$@"
255         ;;
256
257     'ssh-proxycommand'|'p')
258         source "${MSHAREDIR}/ssh_proxycommand"
259         ssh_proxycommand "$@"
260         ;;
261
262     'subkey-to-ssh-agent'|'s')
263         source "${MSHAREDIR}/subkey_to_ssh_agent"
264         subkey_to_ssh_agent "$@"
265         ;;
266
267     'sshfpr'|'f')
268         gpg_ssh_fingerprint "$@"
269         ;;
270
271     'version'|'v')
272         version
273         ;;
274
275     '--help'|'help'|'-h'|'h'|'?')
276         usage
277         ;;
278
279     *)
280         failure "Unknown command: '$COMMAND'
281 Type '$PGRM help' for usage."
282         ;;
283 esac