3 # monkeysphere-authentication: Monkeysphere authentication admin tool
5 # The monkeysphere scripts are written by:
6 # Jameson Rollins <jrollins@finestructure.net>
7 # Jamie McClelland <jm@mayfirst.org>
8 # Daniel Kahn Gillmor <dkg@fifthhorseman.net>
9 # Micah Anderson <micah@riseup.net>
11 # They are Copyright 2008-2009, and are all released under the GPL,
14 ########################################################################
17 SYSSHAREDIR=${MONKEYSPHERE_SYSSHAREDIR:-"/usr/share/monkeysphere"}
19 . "${SYSSHAREDIR}/common" || exit 1
21 # sharedir for authentication functions
22 MASHAREDIR="${SYSSHAREDIR}/ma"
24 SYSDATADIR=${MONKEYSPHERE_SYSDATADIR:-"/var/lib/monkeysphere"}
27 # temp directory to enable atomic moves of authorized_keys files
28 MATMPDIR="${SYSDATADIR}/tmp"
31 # UTC date in ISO 8601 format if needed
32 DATE=$(date -u '+%FT%T')
34 # unset some environment variables that could screw things up
40 ########################################################################
42 ########################################################################
46 usage: $PGRM <subcommand> [options] [args]
47 Monkeysphere authentication admin tool.
50 update-users (u) [USER]... update user authorized_keys files
51 add-id-certifier (c+) KEYID import and tsign a certification key
52 --domain (-n) DOMAIN limit ID certifications to DOMAIN
53 --trust (-t) TRUST trust level of certifier (full)
54 --depth (-d) DEPTH trust depth for certifier (1)
55 remove-id-certifier (c-) KEYID remove a certification key
56 list-id-certifiers (c) list certification keys
58 expert <expert-subcommand> run expert command
59 expert help expert command help
61 version (v) show version number
67 # function to run command as monkeysphere user
68 su_monkeysphere_user() {
69 # if the current user is the monkeysphere user, then just eval
71 if [ $(id -un) = "$MONKEYSPHERE_USER" ] ; then
74 # otherwise su command as monkeysphere user
76 su "$MONKEYSPHERE_USER" -c "$@"
80 # function to interact with the gpg core keyring
84 GNUPGHOME="$GNUPGHOME_CORE"
87 # NOTE: we supress this warning because we need the monkeysphere
88 # user to be able to read the host pubring. we realize this might
89 # be problematic, but it's the simplest solution, without too much
91 gpg --no-permission-warning "$@"
94 # always reset the permissions on the host pubring so that the
95 # monkeysphere user can read the trust signatures
96 chgrp "$MONKEYSPHERE_USER" "${GNUPGHOME_CORE}/pubring.gpg"
97 chmod g+r "${GNUPGHOME_CORE}/pubring.gpg"
102 # function to interact with the gpg sphere keyring
103 # FIXME: this function requires basically accepts only a single
104 # argument because of problems with quote expansion. this needs to be
107 GNUPGHOME="$GNUPGHOME_SPHERE"
110 su_monkeysphere_user "gpg $@"
113 ########################################################################
115 ########################################################################
117 # unset variables that should be defined only in config file
119 unset AUTHORIZED_USER_IDS
120 unset RAW_AUTHORIZED_KEYS
121 unset MONKEYSPHERE_USER
123 # load configuration file
124 [ -e ${MONKEYSPHERE_AUTHENTICATION_CONFIG:="${SYSCONFIGDIR}/monkeysphere-authentication.conf"} ] && . "$MONKEYSPHERE_AUTHENTICATION_CONFIG"
126 # set empty config variable with ones from the environment, or with
128 LOG_LEVEL=${MONKEYSPHERE_LOG_LEVEL:=${LOG_LEVEL:="INFO"}}
129 KEYSERVER=${MONKEYSPHERE_KEYSERVER:=${KEYSERVER:="pool.sks-keyservers.net"}}
130 AUTHORIZED_USER_IDS=${MONKEYSPHERE_AUTHORIZED_USER_IDS:=${AUTHORIZED_USER_IDS:="%h/.monkeysphere/authorized_user_ids"}}
131 RAW_AUTHORIZED_KEYS=${MONKEYSPHERE_RAW_AUTHORIZED_KEYS:=${RAW_AUTHORIZED_KEYS:="%h/.ssh/authorized_keys"}}
132 MONKEYSPHERE_USER=${MONKEYSPHERE_MONKEYSPHERE_USER:=${MONKEYSPHERE_USER:="monkeysphere"}}
135 CHECK_KEYSERVER=${MONKEYSPHERE_CHECK_KEYSERVER:="true"}
136 REQUIRED_USER_KEY_CAPABILITY=${MONKEYSPHERE_REQUIRED_USER_KEY_CAPABILITY:="a"}
137 GNUPGHOME_CORE=${MONKEYSPHERE_GNUPGHOME_CORE:="${SYSDATADIR}/authentication/core"}
138 GNUPGHOME_SPHERE=${MONKEYSPHERE_GNUPGHOME_SPHERE:="${SYSDATADIR}/authentication/sphere"}
140 # export variables needed in su invocation
144 export MONKEYSPHERE_USER
146 export CHECK_KEYSERVER
147 export REQUIRED_USER_KEY_CAPABILITY
148 export GNUPGHOME_CORE
149 export GNUPGHOME_SPHERE
154 [ "$COMMAND" ] || failure "Type '$PGRM help' for usage."
158 'update-users'|'update-user'|'u')
159 source "${MASHAREDIR}/update_users"
163 'add-identity-certifier'|'add-id-certifier'|'add-certifier'|'c+')
164 source "${MASHAREDIR}/add_certifier"
168 'remove-identity-certifier'|'remove-id-certifier'|'remove-certifier'|'c-')
169 source "${MASHAREDIR}/remove_certifier"
170 remove_certifier "$@"
173 'list-identity-certifiers'|'list-id-certifiers'|'list-certifiers'|'list-certifier'|'c')
174 source "${MASHAREDIR}/list_certifiers"
181 case "$SUBCOMMAND" in
184 usage: $PGRM expert <subcommand> [options] [args]
187 diagnostics (d) monkeysphere authentication status
188 gpg-cmd CMD execute gpg command
194 source "${MASHAREDIR}/diagnostics"
203 failure "Unknown expert subcommand: '$COMMAND'
204 Type '$PGRM help' for usage."
213 '--help'|'help'|'-h'|'h'|'?')
218 failure "Unknown command: '$COMMAND'
219 Type '$PGRM help' for usage."