chiark / gitweb /
Programs invoke themselves via `userv' if necessary.
[distorted-keys] / keyfunc.sh.in
1 ### -*-sh-*-
2 ###
3 ### Common key management functions.
4 ###
5 ### (c) 2011 Mark Wooding
6 ###
7
8 ###----- Licensing notice ---------------------------------------------------
9 ###
10 ### This file is part of the distorted.org.uk key management suite.
11 ###
12 ### distorted-keys is free software; you can redistribute it and/or modify
13 ### it under the terms of the GNU General Public License as published by
14 ### the Free Software Foundation; either version 2 of the License, or
15 ### (at your option) any later version.
16 ###
17 ### distorted-keys is distributed in the hope that it will be useful,
18 ### but WITHOUT ANY WARRANTY; without even the implied warranty of
19 ### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
20 ### GNU General Public License for more details.
21 ###
22 ### You should have received a copy of the GNU General Public License
23 ### along with distorted-keys; if not, write to the Free Software Foundation,
24 ### Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
25
26 quis=${0##*/}
27
28 ###--------------------------------------------------------------------------
29 ### Configuration variables.
30
31 ## Automatically configured pathnames.
32 PACKAGE="@PACKAGE@" VERSION="@VERSION@"
33 bindir="@bindir@"
34
35 ## Read user configuration.
36 if [ -f $ETC/keys.conf ]; then . $ETC/keys.conf; fi
37
38 ## Maybe turn on debugging.
39 case "${KEYS_DEBUG+t}" in t) set -x ;; esac
40
41 ## Fake up caller credentials if not called via userv.
42 case "${USERV_USER+t}" in
43   t) ;;
44   *) USERV_USER=${LOGNAME-${USER-$(id -un)}} USERV_UID=$(id -u) ;;
45 esac
46 case "${USERV_GROUP+t}" in
47   t) ;;
48   *) USERV_GROUP=$(id -Gn) USERV_GID=$(id -gn) ;;
49 esac
50
51 ###--------------------------------------------------------------------------
52 ### Cleanup handling.
53
54 cleanups=""
55 cleanup () { cleanups=${cleanups+$cleanups }$1; }
56 runcleanups () { for i in $cleanups; do $i; done; }
57 trap 'rc=$?; runcleanups; exit $rc' EXIT
58 trap 'trap "" EXIT; runcleanups; exit 127' INT TERM
59
60 ###--------------------------------------------------------------------------
61 ### Utility functions.
62
63 reqsafe () {
64   ## Fail unless a safe directory is set.
65
66   err="$quis: (CONFIGURATION ERROR)"
67   case ${SAFE+t} in
68     t) ;;
69     *) echo >&2 "$err: no SAFE directory"; exit 1 ;;
70   esac
71   if [ ! -d "$SAFE" ]; then
72     echo >&2 "$err: SAFE path \`$SAFE' isn't a directory"
73     exit 1
74   fi
75   case "$SAFE" in
76     [!/]* | *[][[:space:]*?]*)
77       echo >&2 "$err: SAFE path \`$SAFE' contains bad characters"
78       exit 1
79       ;;
80   esac
81   ls -ld "$SAFE" | {
82     me=$(id -un)
83     read perm _ user stuff
84     case "$perm:$user" in
85       d???------:"$me") ;;
86       *)
87         echo >&2 "$err: SAFE path \`$SAFE' has bad owner or permissions"
88         exit 1
89         ;;
90     esac
91   }
92 }
93
94 ## Temporary directory.
95 unset tmp
96 rmtmp () { case ${tmp+t} in t) cd /; rm -rf $tmp ;; esac; }
97 cleanup rmtmp
98 mktmp () {
99   ## Make a temporary directory and store its name in `tmp'.
100
101   case "${tmp+t}" in t) return ;; esac
102   reqsafe
103   tmp="$SAFE/keys.tmp.$$"
104   rm -rf "$tmp"
105   mkdir -m700 "$tmp"
106 }
107
108 reqtmp () {
109   ## Fail unless a temporary directory is set.
110
111   case ${tmp+t} in
112     t) ;;
113     *) echo >&2 "$quis (INTERNAL): no tmp directory set"; exit 127 ;;
114   esac
115 }
116
117 parse_keylabel () {
118   key=$1
119   ## Parse the key label string KEY.  Set `kdir' to the base path to use for
120   ## the key's storage, and `kowner' to the key owner's name.
121
122   case "$key" in
123     *:*) kowner=${key%%:*} klabel=${key#*:} ;;
124     *) kowner=$USERV_USER klabel=$key ;;
125   esac
126   checkword "key owner name" "$kowner"
127   checklabel "key" "$klabel"
128   kdir=$KEYS/store/$kowner/$klabel
129   knub=$KEYS/nub/$kowner/$klabel
130 }
131
132 runas () {
133   user=$1 service=$2; shift 2
134   ## If the current (effective) user is not USER then reinvoke via `userv',
135   ## as the specified service, with the remaining arguments.
136
137   case $(id -un) in
138     "$user") ;;
139     *) exec userv "$user" "$service" "$@" ;;
140   esac
141 }
142
143 ###--------------------------------------------------------------------------
144 ### Input validation functions.
145
146 nl="
147 "
148 check () {
149   ckwhat=$1 ckpat=$2 thing=$3
150   ## Verify that THING matches the (anchored, basic) regular expression
151   ## CKPAT.  Since matching newlines is hard to do portably, also check that
152   ## THING doesn't contain any.  If the checks fail, report an error and
153   ## exit.
154
155   validp=t
156   case "$thing" in
157     *"$nl"*) validp=nil ;;
158     *) if ! expr >/dev/null "Q$thing" : "Q$ckpat\$"; then validp=nil; fi ;;
159   esac
160   case $validp in
161     nil) echo >&2 "$quis: bad $ckwhat \`$thing'"; exit 1 ;;
162   esac
163 }
164
165 ## Regular expressions for validating input.
166 R_IDENTCHARS="A-Za-z0-9_"
167 R_GOODPUNCT="!%@+="
168 R_WORDCHARS="-$R_IDENTCHARS$R_GOODPUNCT"
169 R_IDENT="[$R_IDENTCHARS][$R_IDENTCHARS]*"
170 R_WORD="[$R_WORDCHARS][$R_WORDCHARS]*"
171 R_ACLCHARS="][$R_IDENTCHARS$R_GOODPUNCT*?:.#"
172 R_WORDSEQ="[$R_WORDCHARS[:space:]][$R_WORDCHARS[:space:]]*"
173 R_ACL="[$R_ACLCHARS[:space:]-][$R_ACLCHARS[:space:]-]*"
174 R_NUMERIC='\(\([1-9][0-9]*\)\{0,1\}0\{0,1\}\)'
175 R_LABEL="\($R_WORD\(/$R_WORD\)*\)"
176 R_LINE=".*"
177
178 ## Various validation functions.
179 checknumber () { check "$1" "$R_NUMERIC" "$2"; }
180 checkident () { check "$1" "$R_IDENT" "$2"; }
181 checkword () { check "$1" "$R_WORD" "$2"; }
182 checklabel () { check "$1 label" "$R_LABEL" "$2"; }
183
184 ###--------------------------------------------------------------------------
185 ### Key storage and properties.
186
187 getsysprofile () {
188   profile=$1
189   ## Write the named system PROFILE to standard output.
190
191   $bindir/extract-profile "$profile" $ETC/profile.d/
192 }
193
194 setprops () {
195   what=$1 prefix=$2; shift 2
196   ## Set variables based on the NAME=VALUE assignments in the arguments.  The
197   ## value for property NAME is stored in the shell variable PREFIX_NAME.
198
199   for assg in "$@"; do
200     goodp=t
201     case "$assg" in
202       *\=*) name=${assg%%=*} value=${assg#*=} ;;
203       *) goodp=nil ;;
204     esac
205     case "$goodp,$name" in t,*[!0-9A-Za-z_]*=*) goodp=nil ;; esac
206     case "$goodp" in
207       nil) echo >&2 "$quis: bad $what assignment \`$assg'"; exit 1 ;;
208     esac
209     eval "$prefix$name=\$value"
210   done
211 }
212
213 checkprops () {
214   whatprop=$1 prefix=$2; shift 2
215   ## Check that property variables are set in accordance with the remaining
216   ## TABLE arguments.  Each row of TABLE has the form
217   ##
218   ##    NAME OMIT PAT
219   ##
220   ## A table row is satisfied if there is a variable PREFIXNAME whose value
221   ## matces the (basic) regular expression PAT, or if the variable is unset
222   ## and OMIT is `t'.
223
224   for table in "$@"; do
225     case "$table" in ?*) ;; *) continue ;; esac
226     while read -r name omit pat; do
227       eval foundp=\${$prefix$name+t}
228       case "$foundp,$omit" in
229         ,t) continue ;;
230         ,nil)
231           echo >&2 "$quis: missing $whatprop \`$name' required"
232           exit 1
233           ;;
234       esac
235       eval value=\$$prefix$name
236       check "value for $whatprop \`$name'" "$pat" "$value"
237     done <<EOF
238 $table
239 EOF
240   done
241 }
242
243 defprops () {
244   name=$1
245   ## Define a properties table NAME.
246
247   table=$(cat)
248   eval $name=\$table
249 }
250
251 defprops g_props <<EOF
252 type                    nil     $R_IDENT
253 recovery                t       $R_WORDSEQ
254 random                  t       $R_WORD
255 nub_hash                t       $R_WORD
256 nubid_hash              t       $R_WORD
257 nub_random_bytes        t       $R_NUMERIC
258 acl_encrypt             t       $R_ACL
259 acl_decrypt             t       $R_ACL
260 acl_sign                t       $R_ACL
261 acl_verify              t       $R_ACL
262 acl_info                t       $R_ACL
263 EOF
264
265 readprops () {
266   file=$1
267   ## Read a profile from a file.  This doesn't check the form of the
268   ## filename, so it's not suitable for unchecked input.  Properties are set
269   ## using `setprops' with prefix `kprop_'.
270
271   ## Parse the settings from the file.
272   exec 3<"$file"
273   while read line; do
274     case "$line" in "" | \#*) continue ;; esac
275     setprops "property" kprop_ "$line"
276   done <&3
277   exec 3>&-
278   checkprops "property" kprop_ "$g_props"
279
280   ## Fetch the key-type handling library.
281   if [ ! -f $KEYSLIB/ktype.$kprop_type ]; then
282     echo >&2 "$quis: unknown key type \`$kprop_type'"
283     exit 1
284   fi
285   . $KEYSLIB/ktype.$kprop_type
286   checkprops "property" kprop_ "$k_props"
287 }
288
289 readmeta () {
290   kdir=$1
291   ## Read key metadata from KDIR.
292
293   { read profile; } <"$kdir"/meta
294 }
295
296 makenub () {
297   ## Generate a key nub in the default way, and write it to standard output.
298   ## The properties `random', `nub_random_bytes' and `nub_hash' are referred
299   ## to.
300
301   dd 2>/dev/null \
302     if=/dev/${kprop_random-random} bs=1 count=${kprop_nub_random_bytes-64} |
303   openssl dgst -${kprop_nub_hash-sha256} -binary |
304   openssl base64
305 }
306
307 nubid () {
308   ## Compute a hash of the key nub in stdin, and write it to stdout in hex.
309   ## The property `nubid_hash' is used.
310
311   { echo "distorted-keys nubid"; cat -; } |
312   openssl dgst -${kprop_nubid_hash-sha256}
313 }
314
315 subst () {
316   what=$1 templ=$2 prefix=$3 pat=$4
317   ## Substitute option values into the template TEMPL.  Each occurrence of
318   ## %{VAR} is replaced by the value of the variable PREFIXVAR.  Finally, an
319   ## error is reported unless the final value matches the regular expression
320   ## PAT.
321
322   out=""
323   rest=$templ
324   while :; do
325
326     ## If there are no more markers to substitute, then finish.
327     case "$rest" in *"%{"*"}"*) ;; *) out=$out$rest; break ;; esac
328
329     ## Split the template into three parts.
330     left=${rest%%\%\{*} right=${rest#*\%\{}
331     var=${right%%\}*} rest=${right#*\}}
332     case "$var" in
333       *-*) default=${var#*-} var=${var%%-*} defaultp=t ;;
334       *) defaultp=nil ;;
335     esac
336
337     ## Find the variable value.
338     checkident "template variable name" "$var"
339     eval foundp=\${$prefix$var+t}
340     case $foundp,$defaultp in
341       t,*) eval value=\$$prefix$var ;;
342       ,t) value=$default ;;
343       *)
344         echo >&2 "$quis: option \`$var' unset, used in template \`$templ'"
345         exit 1
346         ;;
347     esac
348
349     ## Do the substitution.
350     out=$out$left$value
351   done
352
353   ## Check the final result.
354   check "$what" "$pat" "$out"
355
356   ## Done.
357   echo "$out"
358 }
359
360 read_profile () {
361   owner=$1 profile=$2
362   ## Read property settings from a profile.  The PROFILE name has the form
363   ## [USER:]LABEL; USER defaults to OWNER.  Properties are set using
364   ## `setprops' with prefix `kprop_'.
365
366   reqtmp
367   case "$profile" in
368     :*)
369       label=${profile#:} uservp=nil
370       ;;
371     *)
372       user=$kowner label=$profile uservp=t
373       ;;
374     *:*)
375       user=${profile%%:*} label=${profile#*:} uservp=t
376       ;;
377   esac
378   checkword "profile label" "$label"
379
380   ## Fetch the profile settings from the user.
381   reqtmp
382   case $uservp in
383     t)
384       checkword "profile user" "$user"
385       userv "$user" cryptop-profile "$label" >$tmp/profile
386       ;;
387     nil)
388       $bindir/extract-profile "$label" $ETC/profile.d/ >$tmp/profile
389       ;;
390   esac
391
392   ## Read the file.
393   readprops $tmp/profile
394 }
395
396 ###--------------------------------------------------------------------------
397 ### General crypto operations.
398
399 c_genkey () {
400   profile=$1 kdir=$2 knub=$3 hook=$4; shift 4
401   ## Generate a key, and associate it with the named PROFILE (which is
402   ## assumed already to have been read!); store the main data in KDIR, and
403   ## the nub separately in the file KNUB; run HOOK after generation, passing
404   ## it the working key directory and nub file.  Remaining arguments are
405   ## options to the key type.
406
407   ## Set options and check them.
408   setprops "option" kopt_ "$@"
409   checkprops "option" kopt_ "$k_genopts"
410
411   ## Create directory structure and start writing metadata.
412   rm -rf "$kdir.new"
413   mkdir -m755 -p "$kdir.new"
414   case "$knub" in */*) mkdir -m700 -p "${knub%/*}" ;; esac
415   cat >"$kdir.new/meta" <<EOF
416 $profile
417 EOF
418
419   ## Generate the key.
420   umask=$(umask); umask 077; >"$knub.new"; umask $umask
421   k_generate "$kdir.new" "$knub.new"
422   $hook "$kdir.new" "$knub.new"
423
424   ## Hash the nub.
425   nubid <"$knub.new" >"$kdir.new/nubid"
426
427   ## Juggle everything into place.  Doing this atomically is very difficult,
428   ## and requires more machinery than I can really justify here.  If
429   ## something goes wrong halfway, it should always be possible to fix it,
430   ## either by backing out (if $kdir.new still exists) or pressing on
431   ## forwards (if not).
432   rm -rf "$kdir.old"
433   if [ -e "$kdir" ]; then mv "$kdir" "$kdir.old"; fi
434   mv "$kdir.new" "$kdir"
435   mv "$knub.new" "$knub"
436   rm -rf "$kdir.old"
437 }
438
439 c_encrypt () { k_encrypt "$@"; }
440 c_decrypt () {
441   if k_decrypt "$@" >$tmp/plain; then cat $tmp/plain
442   else return $?
443   fi
444 }
445 c_sign () { k_sign "$@"; }
446 c_verify () { k_verify "$@"; }
447
448 ## Stub implementations.
449 notsupp () { op=$1; echo >&2 "$quis: operation \`$op' not supported"; }
450 k_info () { :; }
451 k_encrypt () { notsupp encrypt; }
452 k_decrypt () { notsupp decrypt; }
453 k_sign () { notsupp sign; }
454 k_verify () { notsupp verify; }
455
456 prepare () {
457   key=$1 op=$2
458   ## Prepare for a crypto operation OP, using the KEY.  This validates the
459   ## key label, reads the profile, and checks the access-control list.  If OP
460   ## is `-' then allow the operation unconditionally.
461
462   ## Find the key properties.
463   parse_keylabel "$key"
464   if [ ! -d $kdir ]; then echo >&2 "$quis: unknown key \`$key'"; exit 1; fi
465   readmeta $kdir
466   read_profile $kowner "$profile"
467
468   ## Check whether we're allowed to do this thing.  This is annoyingly
469   ## fiddly.
470   case $op in -) return ;; esac
471   eval acl=\${kprop_acl_$op-!owner}
472   verdict=forbid
473   while :; do
474
475     ## Remove leading whitespace.
476     while :; do
477       case "$acl" in
478         [[:space:]]*) acl=${acl#?} ;;
479         *) break ;;
480       esac
481     done
482
483     ## If there's nothing left, leave.
484     case "$acl" in ?*) ;; *) break ;; esac
485
486     ## Split off the leading word.
487     case "$acl" in
488       *[[:space:]]*) word=${acl%%[[:space:]]*} acl=${acl#*[[:space:]]} ;;
489       *) word=$acl acl="" ;;
490     esac
491
492     ## See what sense it has if it matches.
493     case "$word" in
494       -*) sense=forbid rest=${word#-} ;;
495       *) sense=allow rest=$word ;;
496     esac
497
498     ## See whether the calling user matches.
499     case "$rest" in
500       !owner) pat=$kowner list=$USERV_USER ;;
501       !*) echo >&2 "$quis: unknown ACL token \`$word'" ;;
502       %*) pat=${rest#%} list="$USERV_GROUP $USERV_GID" ;;
503       *) pat=$rest list="$USERV_USER $USERV_UID" ;;
504     esac
505     matchp=nil
506     for i in $list; do case "$i" in $pat) matchp=t; break ;; esac; done
507     case $matchp in t) verdict=$sense; break ;; esac
508   done
509
510   case $verdict in
511     forbid) echo >&2 "$quis: $op access to key \`$key' forbidden"; exit 1 ;;
512   esac
513 }
514
515 ###--------------------------------------------------------------------------
516 ### Crypto operations for infrastructure purposes.
517
518 c_sysprofile () {
519   profile=$1
520   ## Select the profile in FILE for future crypto operations.
521
522   unset $(set | sed -n '/^kprop_/s/=.*$//p')
523   reqtmp
524   getsysprofile "$profile" >$tmp/profile
525   readprops $tmp/profile
526 }
527
528 c_gensyskey () {
529   profile=$1 kdir=$2 knub=$3; shift 3
530   ## Generate a system key using PROFILE; store the data in KDIR and the nub
531   ## in KNUB.  Remaining arguments are options.
532
533   c_sysprofile "$profile"
534   c_genkey "$profile" "$kdir" "$knub" : "$@"
535 }
536
537 c_sysprepare () {
538   kdir=$1
539   readmeta "$kdir"
540   c_sysprofile "$profile"
541 }
542
543 c_sysop () {
544   op=$1 kdir=$2; shift 1
545   c_sysprepare "$kdir"
546   c_$op "$@"
547 }
548
549 c_sysencrypt () { c_sysop encrypt "$1" /dev/null; }
550 c_sysdecrypt () { c_sysop decrypt "$1" "$2"; }
551 c_syssign () { c_sysop sign "$1" "$2"; }
552 c_sysverify () { c_sysop verify "$1" /dev/null; }
553
554 ###--------------------------------------------------------------------------
555 ### Recovery operations.
556
557 stash () {
558   recov=$1 label=$2
559   ## Stash a copy of stdin encrypted under the recovery key RECOV, with a
560   ## given LABEL.
561   checkword "recovery key label" "$recov"
562   checklabel "secret" "$label"
563
564   rdir=$KEYS/recov/$recov/current
565   if [ ! -d $rdir/store ]; then
566     echo >&2 "$quis: unknown recovery key \`$recov'"
567     exit 1
568   fi
569   case $label in */*) mkdir -m755 -p $rdir/${label%/*} ;; esac
570   (c_sysencrypt $rdir/store >$rdir/$label.new)
571   mv $rdir/$label.new $rdir/$label.recov
572 }
573
574 recover () {
575   recov=$1 label=$2
576   ## Recover a stashed secret, protected by RECOV and stored as LABEL, and
577   ## write it to stdout.
578   checkword "recovery key label" "$recov"
579   checklabel "secret" "$label"
580
581   rdir=$KEYS/recov/$recov/current
582   if [ ! -f $rdir/$label.recov ]; then
583     echo >&2 "$quis: no blob for \`$label' under recovery key \`$recov'"
584     exit 1
585   fi
586   reqsafe
587   nub=$SAFE/keys.reveal/$recov.current/nub
588   if [ ! -f $nub ]; then
589     echo >&2 "$quis: current recovery key \`$recov' not revealed"
590     exit 1;
591   fi
592   mktmp
593   c_sysdecrypt $rdir/store $nub <$rdir/$label.recov
594 }
595
596 ###--------------------------------------------------------------------------
597 ### Help text.
598
599 defhelp () {
600   read umsg
601   usage="usage: $quis${umsg+ }$umsg"
602   help=$(cat)
603   case "$KEYS_HELP" in t) help; exit ;; esac
604 }
605
606 help () { showhelp; }
607 showhelp () {
608   cat <<EOF
609 $usage
610
611 $help
612 EOF
613 }
614
615 usage_err () { echo >&2 "$usage"; exit 1; }
616
617 ###--------------------------------------------------------------------------
618 ### Subcommand handling.
619
620 version () {
621   echo "$PACKAGE version $VERSION"
622 }
623
624 cmd_help () {
625   rc=0
626   version
627   case $# in
628     0)
629       cat <<EOF
630
631 $usage
632
633 Options:
634   -h            Show this help text.
635   -v            Show the program version number.
636
637 Commands installed:
638 EOF
639       cd "$KEYSLIB"
640       for i in $prefix.*; do
641         if [ ! -x "$i" ]; then continue; fi
642         sed -n "/<<HELP/{n;s/^/ ${i#$prefix.} /;p;q;}" "$i"
643       done
644       ;;
645     *)
646       for i in "$@"; do
647         echo
648         if [ ! -x "$KEYSLIB/$prefix.$i" ]; then
649           echo >&2 "$quis: unrecognized command \`$i'"
650           rc=1
651           continue
652         elif ! KEYS_HELP=t "$KEYSLIB/$prefix.$i"; then
653           rc=1
654         fi
655       done
656       ;;
657   esac
658   return $rc
659 }
660
661 dispatch () {
662   case $# in 0) echo >&2 "$usage"; exit 1 ;; esac
663   cmd=$1; shift
664   case "$cmd" in help) cmd_help "$@"; exit ;; esac
665   if [ ! -x "$KEYSLIB/$prefix.$cmd" ]; then
666     echo >&2 "$quis: unrecognized command \`$cmd'"
667     exit 1
668   fi
669
670   unset KEYS_HELP
671   exec "$KEYSLIB/$prefix.$cmd" "$@"
672 }
673
674 ###----- That's all, folks --------------------------------------------------