new function to export signatures from core to sphere keyrings. this
[monkeysphere.git] / src / monkeysphere-authentication
1 #!/usr/bin/env bash
2
3 # monkeysphere-authentication: Monkeysphere authentication admin tool
4 #
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>
10 #
11 # They are Copyright 2008-2009, and are all released under the GPL,
12 # version 3 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}/common" || exit 1
22
23 SYSDATADIR=${MONKEYSPHERE_SYSDATADIR:-"/var/lib/monkeysphere"}
24 export SYSDATADIR
25
26 # sharedir for authentication functions
27 MASHAREDIR="${SYSSHAREDIR}/ma"
28
29 # datadir for authentication functions
30 MADATADIR="${SYSDATADIR}/authentication"
31
32 # temp directory to enable atomic moves of authorized_keys files
33 MATMPDIR="${MADATADIR}/tmp"
34 export MSTMPDIR
35
36 # UTC date in ISO 8601 format if needed
37 DATE=$(date -u '+%FT%T')
38
39 # unset some environment variables that could screw things up
40 unset GREP_OPTIONS
41
42 # default return code
43 RETURN=0
44
45 ########################################################################
46 # FUNCTIONS
47 ########################################################################
48
49 usage() {
50     cat <<EOF >&2
51 usage: $PGRM <subcommand> [options] [args]
52 Monkeysphere authentication admin tool.
53
54 subcommands:
55  setup (s)                           setup monkeysphere user authentication
56  update-users (u) [USER]...          update user authorized_keys files
57  add-id-certifier (c+) KEYID         import and tsign a certification key
58    --domain (-n) DOMAIN                limit ID certifications to DOMAIN
59    --trust (-t) TRUST                  trust level of certifier (full)
60    --depth (-d) DEPTH                  trust depth for certifier (1)
61  remove-id-certifier (c-) KEYID      remove a certification key
62  list-id-certifiers (c)              list certification keys
63
64  expert <expert-subcommand>          run expert command
65  expert help                         expert command help
66
67  version (v)                         show version number
68  help (h,?)                          this help
69
70 EOF
71 }
72
73 # function to run command as monkeysphere user
74 su_monkeysphere_user() {
75     # if the current user is the monkeysphere user, then just eval
76     # command
77     if [ $(id -un) = "$MONKEYSPHERE_USER" ] ; then
78         eval "$@"
79
80     # otherwise su command as monkeysphere user
81     else
82         su "$MONKEYSPHERE_USER" -c "$@"
83     fi
84 }
85
86 # function to interact with the gpg core keyring
87 gpg_core() {
88     GNUPGHOME="$GNUPGHOME_CORE"
89     export GNUPGHOME
90
91     # NOTE: we supress this warning because we need the monkeysphere
92     # user to be able to read the host pubring.  we realize this might
93     # be problematic, but it's the simplest solution, without too much
94     # loss of security.
95     gpg "$@"
96 }
97
98 # function to interact with the gpg sphere keyring
99 # FIXME: this function requires basically accepts only a single
100 # argument because of problems with quote expansion.  this needs to be
101 # fixed/improved.
102 gpg_sphere() {
103     GNUPGHOME="$GNUPGHOME_SPHERE"
104     export GNUPGHOME
105
106     su_monkeysphere_user "gpg $@"
107 }
108
109 # export signatures from core to sphere
110 gpg_core_sphere_sig_transfer() {
111     gpg_core --export-options export-local-sigs --export | \
112         gpg_sphere --import-options import-local-sigs --import
113 }
114
115 ########################################################################
116 # MAIN
117 ########################################################################
118
119 # unset variables that should be defined only in config file
120 unset KEYSERVER
121 unset AUTHORIZED_USER_IDS
122 unset RAW_AUTHORIZED_KEYS
123 unset MONKEYSPHERE_USER
124
125 # load configuration file
126 [ -e ${MONKEYSPHERE_AUTHENTICATION_CONFIG:="${SYSCONFIGDIR}/monkeysphere-authentication.conf"} ] && . "$MONKEYSPHERE_AUTHENTICATION_CONFIG"
127
128 # set empty config variable with ones from the environment, or with
129 # defaults
130 LOG_LEVEL=${MONKEYSPHERE_LOG_LEVEL:=${LOG_LEVEL:="INFO"}}
131 KEYSERVER=${MONKEYSPHERE_KEYSERVER:=${KEYSERVER:="pool.sks-keyservers.net"}}
132 AUTHORIZED_USER_IDS=${MONKEYSPHERE_AUTHORIZED_USER_IDS:=${AUTHORIZED_USER_IDS:="%h/.monkeysphere/authorized_user_ids"}}
133 RAW_AUTHORIZED_KEYS=${MONKEYSPHERE_RAW_AUTHORIZED_KEYS:=${RAW_AUTHORIZED_KEYS:="%h/.ssh/authorized_keys"}}
134 MONKEYSPHERE_USER=${MONKEYSPHERE_MONKEYSPHERE_USER:=${MONKEYSPHERE_USER:="monkeysphere"}}
135
136 # other variables
137 CHECK_KEYSERVER=${MONKEYSPHERE_CHECK_KEYSERVER:="true"}
138 REQUIRED_USER_KEY_CAPABILITY=${MONKEYSPHERE_REQUIRED_USER_KEY_CAPABILITY:="a"}
139 GNUPGHOME_CORE=${MONKEYSPHERE_GNUPGHOME_CORE:="${MADATADIR}/core"}
140 GNUPGHOME_SPHERE=${MONKEYSPHERE_GNUPGHOME_SPHERE:="${MADATADIR}/sphere"}
141
142 # export variables needed in su invocation
143 export DATE
144 export MODE
145 export LOG_LEVEL
146 export MONKEYSPHERE_USER
147 export KEYSERVER
148 export CHECK_KEYSERVER
149 export REQUIRED_USER_KEY_CAPABILITY
150 export GNUPGHOME_CORE
151 export GNUPGHOME_SPHERE
152 export GNUPGHOME
153
154 # get subcommand
155 COMMAND="$1"
156 [ "$COMMAND" ] || failure "Type '$PGRM help' for usage."
157 shift
158
159 case $COMMAND in
160     'setup'|'setup'|'s')
161         source "${MASHAREDIR}/setup"
162         setup "$@"
163         ;;
164
165     'update-users'|'update-user'|'u')
166         source "${MASHAREDIR}/update_users"
167         update_users "$@"
168         ;;
169
170     'add-identity-certifier'|'add-id-certifier'|'add-certifier'|'c+')
171         source "${MASHAREDIR}/add_certifier"
172         add_certifier "$@"
173         ;;
174
175     'remove-identity-certifier'|'remove-id-certifier'|'remove-certifier'|'c-')
176         source "${MASHAREDIR}/remove_certifier"
177         remove_certifier "$@"
178         ;;
179
180     'list-identity-certifiers'|'list-id-certifiers'|'list-certifiers'|'list-certifier'|'c')
181         source "${MASHAREDIR}/list_certifiers"
182         list_certifiers "$@"
183         ;;
184
185     'expert'|'e')
186         SUBCOMMAND="$1"
187         shift
188         case "$SUBCOMMAND" in
189             'help'|'h'|'?')
190                 cat <<EOF
191 usage: $PGRM expert <subcommand> [options] [args]
192
193 expert subcommands:
194  diagnostics (d)                     monkeysphere authentication status
195  gpg-cmd CMD                         execute gpg command
196
197 EOF
198                 ;;
199
200             'diagnostics'|'d')
201                 source "${MASHAREDIR}/diagnostics"
202                 diagnostics
203                 ;;
204
205             'gpg-cmd')
206                 gpg_sphere "$@"
207                 ;;
208
209             *)
210                 failure "Unknown expert subcommand: '$COMMAND'
211 Type '$PGRM help' for usage."
212                 ;;
213         esac
214         ;;
215
216     'version'|'v')
217         echo "$VERSION"
218         ;;
219
220     '--help'|'help'|'-h'|'h'|'?')
221         usage
222         ;;
223
224     *)
225         failure "Unknown command: '$COMMAND'
226 Type '$PGRM help' for usage."
227         ;;
228 esac
229
230 exit "$RETURN"