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 curdate
 387     local warnwindow
 388     local warndate
 389     local create
 390     local expire
 391     local uid
 392     local fingerprint
 393
 394     seckey=$(gpg_host --list-secret-keys --fingerprint --with-colons --fixed-list-mode)
 395     keysfound=$(echo "$seckey" | grep -c ^sec:)
 396     curdate=$(date +%s)
 397     # warn when anything is 2 months away from expiration
 398     warnwindow='2 months'
 399     warndate=$(date +%s -d "$warnwindow")
 400
 401     if (( "$keysfound" < 1 )); then
 402         echo "No host key found!"
 403         echo "Recommendation: run 'monkeysphere-server gen-key'"
 404     else
 405         if (( "$keysfound" > 1 )); then
 406             echo "more than one host key found?"
 407         else
 408             create=$(echo "$seckey" | grep ^sec: | cut -f6 -d:)
 409             expire=$(echo "$seckey" | grep ^sec: | cut -f7 -d:)
 410             fingerprint=$(echo "$seckey" | grep ^fpr: | head -n1 | cut -f10 -d:)
 411         # check for key expiration:
 412             if [ "$expire" ]; then
 413                 if (( "$expire"  < "$curdate" )); then
 414                     echo "Host key is expired!"
 415                 # FIXME: recommend a way to resolve this other than re-keying?
 416                 elif (( "$expire" < "$warndate" )); then
 417                     echo "Host key expires in less than $warnwindow:" $(date -d "$(( $expire - $curdate )) seconds" +%F)
 418                 # FIXME: recommend a way to resolve this?
 419                 fi
 420             fi
 421
 422         # and weirdnesses:
 423             if [ "$create" ] && (( "$create" > "$curdate" )); then
 424                 echo "Host key was created in the future(?!). Is your clock correct?"
 425                 echo "Recommendation: Check clock ($(date +%F_%T)); use NTP?"
 426             fi
 427
 428         # check for UserID expiration:
 429             echo "$seckey" | grep ^uid: | cut -d: -f6,7,10 | \
 430             while IFS=: read create expire uid ; do
 431                 # FIXME: should we be doing any checking on the form
 432                 # of the User ID?  Should we be unmangling it somehow?
 433
 434                 if [ "$create" ] && (( "$create" > "$curdate" )); then
 435                     echo "User ID '$uid' was created in the future(?!).  Is your clock correct?"
 436                     echo "Recommendation: Check clock ($(date +%F_%T)); use NTP?"
 437                 fi
 438                 if [ "$expire" ] ; then
 439                     if (( "$expire" < "$curdate" )); then
 440                         echo "User ID '$uid' is expired!"
 441                         # FIXME: recommend a way to resolve this
 442                     elif (( "$expire" < "$warndate" )); then
 443                         echo "User ID '$uid' expires in less than $warnwindow:" $(date -d "$(( $expire - $curdate )) seconds" +%F)
 444                         # FIXME: recommend a way to resolve this
 445                     fi
 446                 fi
 447             done
 448
 449 # FIXME: verify that the host key is properly published to the
 450 #   keyservers (do this with the non-privileged user)
 451
 452 # FIXME: check that there are valid, non-expired certifying signatures
 453 #   attached to the host key after fetching from the public keyserver
 454 #   (do this with the non-privileged user as well)
 455
 456 # FIXME: propose adding a revoker to the host key if none exist (do we
 457 #   have a way to do that after key generation?)
 458
 459 # Ensure that the ssh_host_rsa_key file is present and non-empty:
 460             if [ ! -s "${VARLIB}/ssh_host_rsa_key" ] ; then
 461                 echo "The host key as prepared for SSH (${VARLIB}/ssh_host_rsa_key) is missing or empty!"
 462             else
 463                 if [ $(stat -c '%a' "${VARLIB}/ssh_host_rsa_key") != 600 ] ; then
 464                     echo "Permissions seem wrong for ${VARLIB}/ssh_host_rsa_key -- should be 0600 !"
 465                 fi
 466
 467                 # propose changes needed for sshd_config (if any)
 468                 if ! grep -q "^HostKey ${VARLIB}/ssh_host_rsa_key$" /etc/ssh/sshd_config; then
 469                     echo "/etc/ssh/sshd_config does not point to the monkeysphere host key (${VARLIB}/ssh_host_rsa_key)."
 470                     echo "Recommendation: add a line to /etc/ssh/sshd_config: 'HostKey ${VARLIB}/ssh_host_rsa_key'"
 471                 fi
 472             fi
 473         fi
 474     fi
 475
 476 # FIXME: look at the ownership/privileges of the various keyrings,
 477 #    directories housing them, etc (what should those values be?  can
 478 #    we make them as minimal as possible?)
 479
 480 # FIXME: look to see that the ownertrust rules are set properly on the
 481 #    authentication keyring
 482
 483 # FIXME:  make sure that at least one identity certifier exists
 484
 485 }
 486
 487 # retrieve key from web of trust, import it into the host keyring, and
 488 # ltsign the key in the host keyring so that it may certify other keys
 489 add_certifier() {
 490     local domain
 491     local trust
 492     local depth
 493     local keyID
 494     local fingerprint
 495     local ltsignCommand
 496     local trustval
 497
 498     # set default values for trust depth and domain
 499     domain=
 500     trust=full
 501     depth=1
 502
 503     # get options
 504     TEMP=$(getopt -o n:t:d: -l domain:,trust:,depth: -n "$PGRM" -- "$@")
 505
 506     if [ $? != 0 ] ; then
 507         exit 1
 508     fi
 509
 510     # Note the quotes around `$TEMP': they are essential!
 511     eval set -- "$TEMP"
 512
 513     while true ; do
 514         case "$1" in
 515             -n|--domain)
 516                 domain="$2"
 517                 shift 2
 518                 ;;
 519             -t|--trust)
 520                 trust="$2"
 521                 shift 2
 522                 ;;
 523             -d|--depth)
 524                 depth="$2"
 525                 shift 2
 526                 ;;
 527             --)
 528                 shift
 529                 ;;
 530             *)
 531                 break
 532                 ;;
 533         esac
 534     done
 535
 536     keyID="$1"
 537     if [ -z "$keyID" ] ; then
 538         failure "You must specify the key ID of a key to add."
 539     fi
 540     export keyID
 541
 542     # get the key from the key server
 543     gpg_authentication "--keyserver $KEYSERVER --recv-key '$keyID'"
 544
 545     # get the full fingerprint of a key ID
 546     fingerprint=$(gpg_authentication "--list-key --with-colons --with-fingerprint $keyID" | \
 547         grep '^fpr:' | grep "$keyID" | cut -d: -f10)
 548
 549     echo "key found:"
 550     gpg_authentication "--fingerprint $fingerprint"
 551
 552     echo "Are you sure you want to add this key as a certifier of"
 553     read -p "users on this system? (y/N) " OK; OK=${OK:-N}
 554     if [ "${OK/y/Y}" != 'Y' ] ; then
 555         failure "aborting."
 556     fi
 557
 558     # export the key to the host keyring
 559     gpg_authentication "--export $keyID" | gpg_host --import
 560
 561     if [ "$trust" == marginal ]; then
 562         trustval=1
 563     elif [ "$trust" == full ]; then
 564         trustval=2
 565     else
 566         failure "trust value requested ('$trust') was unclear (only 'marginal' or 'full' are supported)"
 567     fi
 568
 569     # ltsign command
 570     # NOTE: *all* user IDs will be ltsigned
 571     ltsignCommand=$(cat <<EOF
 572 ltsign
 573 y
 574 $trustval
 575 $depth
 576 $domain
 577 y
 578 save
 579 EOF
 580         )
 581
 582     # ltsign the key
 583     echo "$ltsignCommand" | gpg_host --quiet --command-fd 0 --edit-key "$fingerprint"
 584
 585     # update the trustdb for the authentication keyring
 586     gpg_authentication "--check-trustdb"
 587 }
 588
 589 # delete a certifiers key from the host keyring
 590 remove_certifier() {
 591     local keyID
 592     local fingerprint
 593
 594     keyID="$1"
 595     if [ -z "$keyID" ] ; then
 596         failure "You must specify the key ID of a key to remove."
 597     fi
 598
 599     # delete the requested key (with prompting)
 600     gpg_host --delete-key "$keyID"
 601
 602     # update the trustdb for the authentication keyring
 603     gpg_authentication "--check-trustdb"
 604 }
 605
 606 # list the host certifiers
 607 list_certifiers() {
 608     gpg_host --list-keys
 609 }
 610
 611 # issue command to gpg-authentication keyring
 612 gpg_authentication_cmd() {
 613     gpg_authentication "$@"
 614 }
 615
 616 ########################################################################
 617 # MAIN
 618 ########################################################################
 619
 620 # unset variables that should be defined only in config file
 621 unset KEYSERVER
 622 unset AUTHORIZED_USER_IDS
 623 unset RAW_AUTHORIZED_KEYS
 624 unset MONKEYSPHERE_USER
 625
 626 # load configuration file
 627 [ -e ${MONKEYSPHERE_SERVER_CONFIG:="${ETC}/monkeysphere-server.conf"} ] && . "$MONKEYSPHERE_SERVER_CONFIG"
 628
 629 # set empty config variable with ones from the environment, or with
 630 # defaults
 631 KEYSERVER=${MONKEYSPHERE_KEYSERVER:=${KEYSERVER:="subkeys.pgp.net"}}
 632 AUTHORIZED_USER_IDS=${MONKEYSPHERE_AUTHORIZED_USER_IDS:=${AUTHORIZED_USER_IDS:="%h/.config/monkeysphere/authorized_user_ids"}}
 633 RAW_AUTHORIZED_KEYS=${MONKEYSPHERE_RAW_AUTHORIZED_KEYS:=${RAW_AUTHORIZED_KEYS:="%h/.ssh/authorized_keys"}}
 634 MONKEYSPHERE_USER=${MONKEYSPHERE_MONKEYSPHERE_USER:=${MONKEYSPHERE_USER:="monkeysphere"}}
 635
 636 # other variables
 637 CHECK_KEYSERVER=${MONKEYSPHERE_CHECK_KEYSERVER:="true"}
 638 REQUIRED_USER_KEY_CAPABILITY=${MONKEYSPHERE_REQUIRED_USER_KEY_CAPABILITY:="a"}
 639 GNUPGHOME_HOST=${MONKEYSPHERE_GNUPGHOME_HOST:="${VARLIB}/gnupg-host"}
 640 GNUPGHOME_AUTHENTICATION=${MONKEYSPHERE_GNUPGHOME_AUTHENTICATION:="${VARLIB}/gnupg-authentication"}
 641
 642 # export variables needed in su invocation
 643 export DATE
 644 export MODE
 645 export MONKEYSPHERE_USER
 646 export KEYSERVER
 647 export CHECK_KEYSERVER
 648 export REQUIRED_USER_KEY_CAPABILITY
 649 export GNUPGHOME_HOST
 650 export GNUPGHOME_AUTHENTICATION
 651 export GNUPGHOME
 652
 653 # get subcommand
 654 COMMAND="$1"
 655 [ "$COMMAND" ] || failure "Type '$PGRM help' for usage."
 656 shift
 657
 658 case $COMMAND in
 659     'update-users'|'update-user'|'u')
 660         update_users "$@"
 661         ;;
 662
 663     'gen-key'|'g')
 664         gen_key "$@"
 665         ;;
 666
 667     'show-fingerprint'|'f')
 668         fingerprint_server_key
 669         ;;
 670
 671     'publish-key'|'p')
 672         publish_server_key
 673         ;;
 674
 675     'diagnostics'|'d')
 676         diagnostics
 677         ;;
 678
 679     'add-identity-certifier'|'add-certifier'|'a')
 680         add_certifier "$1"
 681         ;;
 682
 683     'remove-identity-certifier'|'remove-certifier'|'r')
 684         remove_certifier "$1"
 685         ;;
 686
 687     'list-identity-certifiers'|'list-certifiers'|'list-certifier'|'l')
 688         list_certifiers "$@"
 689         ;;
 690
 691     'gpg-authentication-cmd')
 692         gpg_authentication_cmd "$@"
 693         ;;
 694
 695     'help'|'h'|'?')
 696         usage
 697         ;;
 698
 699     *)
 700         failure "Unknown command: '$COMMAND'
 701 Type '$PGRM help' for usage."
 702         ;;
 703 esac
 704
 705 exit "$RETURN"