src/monkeysphere-server

   1 #!/bin/bash
   2
   3 # monkeysphere-server: MonkeySphere server admin tool
   4 #
   5 # The monkeysphere scripts are written by:
   6 # Jameson Rollins <jrollins@fifthhorseman.net>
   7 #
   8 # They are Copyright 2008, and are all released under the GPL, version 3
   9 # or later.
  10
  11 ########################################################################
  12 PGRM=$(basename $0)
  13
  14 SHARE=${MONKEYSPHERE_SHARE:="/usr/share/monkeysphere"}
  15 export SHARE
  16 . "${SHARE}/common" || exit 1
  17
  18 VARLIB="/var/lib/monkeysphere"
  19 export VARLIB
  20
  21 # date in UTF format if needed
  22 DATE=$(date -u '+%FT%T')
  23
  24 # unset some environment variables that could screw things up
  25 unset GREP_OPTIONS
  26
  27 # default return code
  28 RETURN=0
  29
  30 ########################################################################
  31 # FUNCTIONS
  32 ########################################################################
  33
  34 usage() {
  35 cat <<EOF
  36 usage: $PGRM <subcommand> [options] [args]
  37 MonkeySphere server admin tool.
  38
  39 subcommands:
  40  update-users (u) [USER]...          update user authorized_keys files
  41
  42  gen-key (g) [HOSTNAME]              generate gpg key for the server
  43    -l|--length BITS                    key length in bits (2048)
  44    -e|--expire EXPIRE                  date to expire
  45    -r|--revoker FINGERPRINT            add a revoker
  46  show-fingerprint (f)                show server's host key fingerprint
  47  publish-key (p)                     publish server's host key to keyserver
  48  diagnostics (d)                     report on the server's monkeysphere status
  49
  50  add-identity-certifier (a) KEYID    import and tsign a certification key
  51    -n|--domain DOMAIN                  limit ID certifications to IDs in DOMAIN
  52    -t|--trust TRUST                    trust level of certifier (full)
  53    -d|--depth DEPTH                    trust depth for certifier (1)
  54  remove-identity-certifier (r) KEYID remove a certification key
  55  list-identity-certifiers (l)        list certification keys
  56
  57  gpg-authentication-cmd CMD          gnupg-authentication command
  58
  59  help (h,?)                          this help
  60 EOF
  61 }
  62
  63 su_monkeysphere_user() {
  64     su --preserve-environment "$MONKEYSPHERE_USER" -- -c "$@"
  65 }
  66
  67 # function to interact with the host gnupg keyring
  68 gpg_host() {
  69     local returnCode
  70
  71     GNUPGHOME="$GNUPGHOME_HOST"
  72     export GNUPGHOME
  73
  74     # NOTE: we supress this warning because we need the monkeysphere
  75     # user to be able to read the host pubring.  we realize this might
  76     # be problematic, but it's the simplest solution, without too much
  77     # loss of security.
  78     gpg --no-permission-warning "$@"
  79     returnCode="$?"
  80
  81     # always reset the permissions on the host pubring so that the
  82     # monkeysphere user can read the trust signatures
  83     chgrp "$MONKEYSPHERE_USER" "${GNUPGHOME_HOST}/pubring.gpg"
  84     chmod g+r "${GNUPGHOME_HOST}/pubring.gpg"
  85
  86     return "$returnCode"
  87 }
  88
  89 # function to interact with the authentication gnupg keyring
  90 # FIXME: this function requires basically accepts only a single
  91 # argument because of problems with quote expansion.  this needs to be
  92 # fixed/improved.
  93 gpg_authentication() {
  94     GNUPGHOME="$GNUPGHOME_AUTHENTICATION"
  95     export GNUPGHOME
  96
  97     su_monkeysphere_user "gpg $@"
  98 }
  99
 100 # update authorized_keys for users
 101 update_users() {
 102     if [ "$1" ] ; then
 103         # get users from command line
 104         unames="$@"
 105     else
 106         # or just look at all users if none specified
 107         unames=$(getent passwd | cut -d: -f1)
 108     fi
 109
 110     # set mode
 111     MODE="authorized_keys"
 112
 113     # set gnupg home
 114     GNUPGHOME="$GNUPGHOME_AUTHENTICATION"
 115
 116     # check to see if the gpg trust database has been initialized
 117     if [ ! -s "${GNUPGHOME}/trustdb.gpg" ] ; then
 118         failure "GNUPG trust database uninitialized.  Please see MONKEYSPHERE-SERVER(8)."
 119     fi
 120
 121     # make sure the authorized_keys directory exists
 122     mkdir -p "${VARLIB}/authorized_keys"
 123
 124     # loop over users
 125     for uname in $unames ; do
 126         # check all specified users exist
 127         if ! getent passwd "$uname" >/dev/null ; then
 128             log "----- unknown user '$uname' -----"
 129             continue
 130         fi
 131
 132         # set authorized_user_ids and raw authorized_keys variables,
 133         # translating ssh-style path variables
 134         authorizedUserIDs=$(translate_ssh_variables "$uname" "$AUTHORIZED_USER_IDS")
 135         rawAuthorizedKeys=$(translate_ssh_variables "$uname" "$RAW_AUTHORIZED_KEYS")
 136
 137         # if neither is found, skip user
 138         if [ ! -s "$authorizedUserIDs" ] ; then
 139             if [ "$rawAuthorizedKeys" = '-' -o ! -s "$rawAuthorizedKeys" ] ; then
 140                 continue
 141             fi
 142         fi
 143
 144         log "----- user: $uname -----"
 145
 146         # exit if the authorized_user_ids file is empty
 147         if ! check_key_file_permissions "$uname" "$AUTHORIZED_USER_IDS" ; then
 148             log "Improper permissions on authorized_user_ids file path."
 149             continue
 150         fi
 151
 152         # check permissions on the authorized_keys file path
 153         if ! check_key_file_permissions "$uname" "$RAW_AUTHORIZED_KEYS" ; then
 154             log "Improper permissions on authorized_keys file path path."
 155             continue
 156         fi
 157
 158         # make temporary directory
 159         TMPDIR=$(mktemp -d)
 160
 161         # trap to delete temporary directory on exit
 162         trap "rm -rf $TMPDIR" EXIT
 163
 164         # create temporary authorized_user_ids file
 165         TMP_AUTHORIZED_USER_IDS="${TMPDIR}/authorized_user_ids"
 166         touch "$TMP_AUTHORIZED_USER_IDS"
 167
 168         # create temporary authorized_keys file
 169         AUTHORIZED_KEYS="${TMPDIR}/authorized_keys"
 170         touch "$AUTHORIZED_KEYS"
 171
 172         # set restrictive permissions on the temporary files
 173         # FIXME: is there a better way to do this?
 174         chmod 0700 "$TMPDIR"
 175         chmod 0600 "$AUTHORIZED_KEYS"
 176         chmod 0600 "$TMP_AUTHORIZED_USER_IDS"
 177         chown -R "$MONKEYSPHERE_USER" "$TMPDIR"
 178
 179         # if the authorized_user_ids file exists...
 180         if [ -s "$authorizedUserIDs" ] ; then
 181             # copy user authorized_user_ids file to temporary
 182             # location
 183             cat "$authorizedUserIDs" > "$TMP_AUTHORIZED_USER_IDS"
 184
 185             # export needed variables
 186             export AUTHORIZED_KEYS
 187             export TMP_AUTHORIZED_USER_IDS
 188
 189             # process authorized_user_ids file, as monkeysphere
 190             # user
 191             su_monkeysphere_user \
 192                 ". ${SHARE}/common; process_authorized_user_ids $TMP_AUTHORIZED_USER_IDS"
 193             RETURN="$?"
 194         fi
 195
 196         # add user-controlled authorized_keys file path if specified
 197         if [ "$rawAuthorizedKeys" != '-' -a -s "$rawAuthorizedKeys" ] ; then
 198             log -n "adding raw authorized_keys file... "
 199             cat "$rawAuthorizedKeys" >> "$AUTHORIZED_KEYS"
 200             loge "done."
 201         fi
 202
 203         # openssh appears to check the contents of the
 204         # authorized_keys file as the user in question, so the
 205         # file must be readable by that user at least.
 206         # FIXME: is there a better way to do this?
 207         chown root "$AUTHORIZED_KEYS"
 208         chgrp $(getent passwd "$uname" | cut -f4 -d:) "$AUTHORIZED_KEYS"
 209         chmod g+r "$AUTHORIZED_KEYS"
 210
 211         # move the resulting authorized_keys file into place
 212         mv -f "$AUTHORIZED_KEYS" "${VARLIB}/authorized_keys/${uname}"
 213
 214         # destroy temporary directory
 215         rm -rf "$TMPDIR"
 216     done
 217 }
 218
 219 # generate server gpg key
 220 gen_key() {
 221     local keyType
 222     local keyLength
 223     local keyUsage
 224     local keyExpire
 225     local revoker
 226     local hostName
 227     local userID
 228     local keyParameters
 229     local fingerprint
 230
 231     # set default key parameter values
 232     keyType="RSA"
 233     keyLength="2048"
 234     keyUsage="auth"
 235     keyExpire=
 236     revoker=
 237
 238     # get options
 239     TEMP=$(getopt -o l:e:r: -l length:,expire:,revoker: -n "$PGRM" -- "$@")
 240
 241     if [ $? != 0 ] ; then
 242         exit 1
 243     fi
 244
 245     # Note the quotes around `$TEMP': they are essential!
 246     eval set -- "$TEMP"
 247
 248     while true ; do
 249         case "$1" in
 250             -l|--length)
 251                 keyLength="$2"
 252                 shift 2
 253                 ;;
 254             -e|--expire)
 255                 keyExpire="$2"
 256                 shift 2
 257                 ;;
 258             -r|--revoker)
 259                 revoker="$2"
 260                 shift 2
 261                 ;;
 262             --)
 263                 shift
 264                 ;;
 265             *)
 266                 break
 267                 ;;
 268         esac
 269     done
 270
 271     hostName=${1:-$(hostname --fqdn)}
 272     userID="ssh://${hostName}"
 273
 274     # check for presense of key with user ID
 275     if gpg_host --list-key ="$userID" > /dev/null 2>&1 ; then
 276         failure "Key for '$userID' already exists"
 277     fi
 278
 279     # prompt about key expiration if not specified
 280     if [ -z "$keyExpire" ] ; then
 281         cat <<EOF
 282 Please specify how long the key should be valid.
 283          0 = key does not expire
 284       <n>  = key expires in n days
 285       <n>w = key expires in n weeks
 286       <n>m = key expires in n months
 287       <n>y = key expires in n years
 288 EOF
 289         while [ -z "$keyExpire" ] ; do
 290             read -p "Key is valid for? (0) " keyExpire
 291             if ! test_gpg_expire ${keyExpire:=0} ; then
 292                 echo "invalid value"
 293                 unset keyExpire
 294             fi
 295         done
 296     elif ! test_gpg_expire "$keyExpire" ; then
 297         failure "invalid key expiration value '$keyExpire'."
 298     fi
 299
 300     # set key parameters
 301     keyParameters=$(cat <<EOF
 302 Key-Type: $keyType
 303 Key-Length: $keyLength
 304 Key-Usage: $keyUsage
 305 Name-Real: $userID
 306 Expire-Date: $keyExpire
 307 EOF
 308 )
 309
 310     # add the revoker field if specified
 311     # FIXME: the "1:" below assumes that $REVOKER's key is an RSA key.
 312     # FIXME: key is marked "sensitive"?  is this appropriate?
 313     if [ "$revoker" ] ; then
 314         keyParameters="${keyParameters}"$(cat <<EOF
 315 Revoker: 1:$revoker sensitive
 316 EOF
 317 )
 318     fi
 319
 320     echo "The following key parameters will be used for the host private key:"
 321     echo "$keyParameters"
 322
 323     read -p "Generate key? (Y/n) " OK; OK=${OK:=Y}
 324     if [ ${OK/y/Y} != 'Y' ] ; then
 325         failure "aborting."
 326     fi
 327
 328     # add commit command
 329     keyParameters="${keyParameters}"$(cat <<EOF
 330
 331 %commit
 332 %echo done
 333 EOF
 334 )
 335
 336     log "generating server key..."
 337     echo "$keyParameters" | gpg_host --batch --gen-key
 338
 339     # output the server fingerprint
 340     fingerprint_server_key "=${userID}"
 341
 342     # find the key fingerprint of the server primary key
 343     fingerprint=$(gpg_host --list-key --with-colons --with-fingerprint "=${userID}" | \
 344         grep '^fpr:' | head -1 | cut -d: -f10)
 345
 346     # export host ownertrust to authentication keyring
 347     log "setting ultimate owner trust for server key..."
 348     echo "${fingerprint}:6:" | gpg_authentication "--import-ownertrust"
 349
 350     # translate the private key to ssh format, and export to a file
 351     # for sshs usage.
 352     # NOTE: assumes that the primary key is the proper key to use
 353     (umask 077 && \
 354         gpg_host --export-secret-key "$fingerprint" | \
 355         openpgp2ssh "$fingerprint" > "${VARLIB}/ssh_host_rsa_key")
 356     log "Private SSH host key output to file: ${VARLIB}/ssh_host_rsa_key"
 357 }
 358
 359 # gpg output key fingerprint
 360 fingerprint_server_key() {
 361     gpg_host --fingerprint --list-secret-keys
 362 }
 363
 364 # publish server key to keyserver
 365 publish_server_key() {
 366     read -p "Really publish key to $KEYSERVER? (y/N) " OK; OK=${OK:=N}
 367     if [ ${OK/y/Y} != 'Y' ] ; then
 368         failure "aborting."
 369     fi
 370
 371     # publish host key
 372     # FIXME: need to figure out better way to identify host key
 373     # dummy command so as not to publish fakes keys during testing
 374     # eventually:
 375     #gpg_authentication "--keyserver $KEYSERVER --send-keys $(hostname -f)"
 376     echo "NOT PUBLISHED (to avoid permanent publication errors during monkeysphere development)."
 377     echo "The following command should publish the key:"
 378     echo "monkeysphere-server gpg-authentication-cmd '--keyserver $KEYSERVER --send-keys $(hostname -f)'"
 379     exit 255
 380 }
 381
 382 diagnostics() {
 383 #  * check on the status and validity of the key and public certificates
 384     local seckey
 385     local keysfound
 386     local keyexp
 387     local curdate
 388     local warnwindow
 389     local warndate
 390
 391     seckey=$(gpg_host --list-secret-keys --with-colons --fixed-list-mode)
 392     keysfound=$(echo "$seckey" | grep -c ^sec:)
 393     curdate=$(date +%s)
 394     # warn when anything is 2 months away from expiration
 395     warnwindow='2 months'
 396     warndate=$(date +%s -d "$warnwindow")
 397
 398     if (( "$keysfound" < 1 )); then
 399         echo "No host key found!"
 400         echo "Recommendation: run 'monkeysphere-server gen-key'"
 401     else
 402         if (( "$keysfound" > 1 )); then
 403             echo "more than one host key found?"
 404         else
 405         # check for key expiration:
 406             keyexp=$(echo "$seckey" | grep ^sec: | cut -f7 -d:)
 407             if (( "$keyexp"  < "$curdate" )); then
 408                 echo "Host key is expired!"
 409                 # FIXME: recommend a way to resolve this other than re-keying?
 410             elif (( "$keyexp" < "$warndate" )); then
 411                 echo "Host key expires in less than $warnwindow"
 412                 # FIXME: recommend a way to resolve this?
 413             fi
 414         # and weirdnesses:
 415             if (( $(echo "$seckey" | grep ^sec: | cut -f6 -d:) > "$curdate" )); then
 416                 echo "Host key was created in the future(?!). Is your clock correct?"
 417                 echo "Recommendation: Check clock ($(date +%F_%T)); use NTP?"
 418             fi
 419
 420         # check for UserID expiration:
 421             echo "$seckey" | grep ^uid: | cut -d: -f6,7,10 | \
 422             while IFS=: read create expire uid ; do
 423                 # FIXME: should we be doing any checking on the form
 424                 # of the User ID?  Should we be unmangling it somehow?
 425                 if [ "$create" ] && (( "$create" > "$curdate" )); then
 426                     echo "User ID '$uid' was created in the future(?!).  Is your clock correct?"
 427                     echo "Recommendation: Check clock ($(date +%F_%T)); use NTP?"
 428                 fi
 429                 if [ "$expire" ] ; then
 430                     if (( "$expire" < "$curdate" )); then
 431                         echo "User ID '$uid' is expired!"
 432                         # FIXME: recommend a way to resolve this
 433                     elif (( "$expire" < "$warndate" )); then
 434                         echo "User ID '$uid' expires in less than $warnwindow"
 435                         # FIXME: recommend a way to resolve this
 436                     fi
 437                 fi
 438             done
 439
 440 # FIXME: verify that the host key is properly published to the
 441 #   keyservers
 442
 443 # FIXME: check that there are valid, non-expired certifying signatures
 444 #   attached to the host key
 445
 446 # FIXME: propose adding a revoker to the host key if none exist (do we
 447 #   have a way to do that after key generation?)
 448
 449 # Ensure that the ssh_host_rsa_key file is present and non-empty:
 450             if [ ! -s "${VARLIB}/ssh_host_rsa_key" ] ; then
 451                 echo "The host key as prepared for SSH (${VARLIB}/ssh_host_rsa_key) is missing or empty!"
 452             else
 453                 if [ $(stat -c '%a' "${VARLIB}/ssh_host_rsa_key") != 600 ] ; then
 454                     echo "Permissions seem wrong for ${VARLIB}/ssh_host_rsa_key -- should be 0600 !"
 455                 fi
 456
 457                 # propose changes needed for sshd_config (if any)
 458                 if ! grep -q "^HostKey ${VARLIB}/ssh_host_rsa_key$" /etc/ssh/sshd_config; then
 459                     echo "/etc/ssh/sshd_config does not point to the monkeysphere host key (${VARLIB}/ssh_host_rsa_key)."
 460                     echo "Recommendation: add a line to /etc/ssh/sshd_config: 'HostKey ${VARLIB}/ssh_host_rsa_key'"
 461                 fi
 462             fi
 463         fi
 464     fi
 465
 466 # FIXME: look at the ownership/privileges of the various keyrings,
 467 #    directories housing them, etc (what should those values be?  can
 468 #    we make them as minimal as possible?)
 469
 470 # FIXME: look to see that the ownertrust rules are set properly on the
 471 #    authentication keyring
 472
 473 # FIXME:  make sure that at least one identity certifier exists
 474
 475 }
 476
 477 # retrieve key from web of trust, import it into the host keyring, and
 478 # ltsign the key in the host keyring so that it may certify other keys
 479 add_certifier() {
 480     local domain
 481     local trust
 482     local depth
 483     local keyID
 484     local fingerprint
 485     local ltsignCommand
 486     local trustval
 487
 488     # set default values for trust depth and domain
 489     domain=
 490     trust=full
 491     depth=1
 492
 493     # get options
 494     TEMP=$(getopt -o n:t:d: -l domain:,trust:,depth: -n "$PGRM" -- "$@")
 495
 496     if [ $? != 0 ] ; then
 497         exit 1
 498     fi
 499
 500     # Note the quotes around `$TEMP': they are essential!
 501     eval set -- "$TEMP"
 502
 503     while true ; do
 504         case "$1" in
 505             -n|--domain)
 506                 domain="$2"
 507                 shift 2
 508                 ;;
 509             -t|--trust)
 510                 trust="$2"
 511                 shift 2
 512                 ;;
 513             -d|--depth)
 514                 depth="$2"
 515                 shift 2
 516                 ;;
 517             --)
 518                 shift
 519                 ;;
 520             *)
 521                 break
 522                 ;;
 523         esac
 524     done
 525
 526     keyID="$1"
 527     if [ -z "$keyID" ] ; then
 528         failure "You must specify the key ID of a key to add."
 529     fi
 530     export keyID
 531
 532     # get the key from the key server
 533     gpg_authentication "--keyserver $KEYSERVER --recv-key '$keyID'"
 534
 535     # get the full fingerprint of a key ID
 536     fingerprint=$(gpg_authentication "--list-key --with-colons --with-fingerprint $keyID" | \
 537         grep '^fpr:' | grep "$keyID" | cut -d: -f10)
 538
 539     echo "key found:"
 540     gpg_authentication "--fingerprint $fingerprint"
 541
 542     echo "Are you sure you want to add this key as a certifier of"
 543     read -p "users on this system? (y/N) " OK; OK=${OK:-N}
 544     if [ "${OK/y/Y}" != 'Y' ] ; then
 545         failure "aborting."
 546     fi
 547
 548     # export the key to the host keyring
 549     gpg_authentication "--export $keyID" | gpg_host --import
 550
 551     if [ "$trust" == marginal ]; then
 552         trustval=1
 553     elif [ "$trust" == full ]; then
 554         trustval=2
 555     else
 556         failure "trust value requested ('$trust') was unclear (only 'marginal' or 'full' are supported)"
 557     fi
 558
 559     # ltsign command
 560     # NOTE: *all* user IDs will be ltsigned
 561     ltsignCommand=$(cat <<EOF
 562 ltsign
 563 y
 564 $trustval
 565 $depth
 566 $domain
 567 y
 568 save
 569 EOF
 570         )
 571
 572     # ltsign the key
 573     echo "$ltsignCommand" | gpg_host --quiet --command-fd 0 --edit-key "$fingerprint"
 574
 575     # update the trustdb for the authentication keyring
 576     gpg_authentication "--check-trustdb"
 577 }
 578
 579 # delete a certifiers key from the host keyring
 580 remove_certifier() {
 581     local keyID
 582     local fingerprint
 583
 584     keyID="$1"
 585     if [ -z "$keyID" ] ; then
 586         failure "You must specify the key ID of a key to remove."
 587     fi
 588
 589     # delete the requested key (with prompting)
 590     gpg_host --delete-key "$keyID"
 591
 592     # update the trustdb for the authentication keyring
 593     gpg_authentication "--check-trustdb"
 594 }
 595
 596 # list the host certifiers
 597 list_certifiers() {
 598     gpg_host --list-keys
 599 }
 600
 601 # issue command to gpg-authentication keyring
 602 gpg_authentication_cmd() {
 603     gpg_authentication "$@"
 604 }
 605
 606 ########################################################################
 607 # MAIN
 608 ########################################################################
 609
 610 # unset variables that should be defined only in config file
 611 unset KEYSERVER
 612 unset AUTHORIZED_USER_IDS
 613 unset RAW_AUTHORIZED_KEYS
 614 unset MONKEYSPHERE_USER
 615
 616 # load configuration file
 617 [ -e ${MONKEYSPHERE_SERVER_CONFIG:="${ETC}/monkeysphere-server.conf"} ] && . "$MONKEYSPHERE_SERVER_CONFIG"
 618
 619 # set empty config variable with ones from the environment, or with
 620 # defaults
 621 KEYSERVER=${MONKEYSPHERE_KEYSERVER:=${KEYSERVER:="subkeys.pgp.net"}}
 622 AUTHORIZED_USER_IDS=${MONKEYSPHERE_AUTHORIZED_USER_IDS:=${AUTHORIZED_USER_IDS:="%h/.config/monkeysphere/authorized_user_ids"}}
 623 RAW_AUTHORIZED_KEYS=${MONKEYSPHERE_RAW_AUTHORIZED_KEYS:=${RAW_AUTHORIZED_KEYS:="%h/.ssh/authorized_keys"}}
 624 MONKEYSPHERE_USER=${MONKEYSPHERE_MONKEYSPHERE_USER:=${MONKEYSPHERE_USER:="monkeysphere"}}
 625
 626 # other variables
 627 CHECK_KEYSERVER=${MONKEYSPHERE_CHECK_KEYSERVER:="true"}
 628 REQUIRED_USER_KEY_CAPABILITY=${MONKEYSPHERE_REQUIRED_USER_KEY_CAPABILITY:="a"}
 629 GNUPGHOME_HOST=${MONKEYSPHERE_GNUPGHOME_HOST:="${VARLIB}/gnupg-host"}
 630 GNUPGHOME_AUTHENTICATION=${MONKEYSPHERE_GNUPGHOME_AUTHENTICATION:="${VARLIB}/gnupg-authentication"}
 631
 632 # export variables needed in su invocation
 633 export DATE
 634 export MODE
 635 export MONKEYSPHERE_USER
 636 export KEYSERVER
 637 export CHECK_KEYSERVER
 638 export REQUIRED_USER_KEY_CAPABILITY
 639 export GNUPGHOME_HOST
 640 export GNUPGHOME_AUTHENTICATION
 641 export GNUPGHOME
 642
 643 # get subcommand
 644 COMMAND="$1"
 645 [ "$COMMAND" ] || failure "Type '$PGRM help' for usage."
 646 shift
 647
 648 case $COMMAND in
 649     'update-users'|'update-user'|'u')
 650         update_users "$@"
 651         ;;
 652
 653     'gen-key'|'g')
 654         gen_key "$@"
 655         ;;
 656
 657     'show-fingerprint'|'f')
 658         fingerprint_server_key
 659         ;;
 660
 661     'publish-key'|'p')
 662         publish_server_key
 663         ;;
 664
 665     'diagnostics'|'d')
 666         diagnostics
 667         ;;
 668
 669     'add-identity-certifier'|'add-certifier'|'a')
 670         add_certifier "$1"
 671         ;;
 672
 673     'remove-identity-certifier'|'remove-certifier'|'r')
 674         remove_certifier "$1"
 675         ;;
 676
 677     'list-identity-certifiers'|'list-certifiers'|'list-certifier'|'l')
 678         list_certifiers "$@"
 679         ;;
 680
 681     'gpg-authentication-cmd')
 682         gpg_authentication_cmd "$@"
 683         ;;
 684
 685     'help'|'h'|'?')
 686         usage
 687         ;;
 688
 689     *)
 690         failure "Unknown command: '$COMMAND'
 691 Type '$PGRM help' for usage."
 692         ;;
 693 esac
 694
 695 exit "$RETURN"