b0dcc88fd85b70a38ed44f52d07b346e3c2a9ffc
[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 # set the pipefail option so pipelines fail on first command failure
18 set -o pipefail
19
20 PGRM=$(basename $0)
21
22 SYSSHAREDIR=${MONKEYSPHERE_SYSSHAREDIR:-"/usr/share/monkeysphere"}
23 export SYSSHAREDIR
24 . "${SYSSHAREDIR}/defaultenv"
25 . "${SYSSHAREDIR}/common"
26
27 SYSDATADIR=${MONKEYSPHERE_SYSDATADIR:-"/var/lib/monkeysphere"}
28 export SYSDATADIR
29
30 # sharedir for authentication functions
31 MASHAREDIR="${SYSSHAREDIR}/ma"
32
33 # datadir for authentication functions
34 MADATADIR="${SYSDATADIR}/authentication"
35
36 # temp directory to enable atomic moves of authorized_keys files
37 MATMPDIR="${MADATADIR}/tmp"
38 export MATMPDIR
39
40 # UTC date in ISO 8601 format if needed
41 DATE=$(date -u '+%FT%T')
42
43 # unset some environment variables that could screw things up
44 unset GREP_OPTIONS
45
46 ########################################################################
47 # FUNCTIONS
48 ########################################################################
49
50 usage() {
51     cat <<EOF >&2
52 usage: $PGRM <subcommand> [options] [args]
53 Monkeysphere authentication admin tool.
54
55 subcommands:
56  update-users (u) [USER]...        update user authorized_keys files
57
58  add-id-certifier (c+) KEYID|FILE  import and tsign a certification key
59    [--domain (-n) DOMAIN]            limit ID certifications to DOMAIN
60    [--trust (-t) TRUST]              trust level of certifier (default: full)
61    [--depth (-d) DEPTH]              trust depth for certifier (default: 1)
62  remove-id-certifier (c-) KEYID    remove a certification key
63  list-id-certifiers (c)            list certification keys
64
65  version (v)                       show version number
66  help (h,?)                        this help
67
68 See ${PGRM}(8) for more info.
69 EOF
70 }
71
72 # function to interact with the gpg core keyring
73 gpg_core() {
74     GNUPGHOME="$GNUPGHOME_CORE"
75     export GNUPGHOME
76
77     gpg --no-greeting --quiet --no-tty "$@"
78 }
79
80 # function to interact with the gpg sphere keyring
81 # FIXME: this function requires only a single argument because of
82 # problems with quote expansion.  this needs to be fixed/improved.
83 gpg_sphere() {
84     GNUPGHOME="$GNUPGHOME_SPHERE"
85     export GNUPGHOME
86  
87     su_monkeysphere_user "gpg --no-greeting --quiet --no-tty $@"
88 }
89
90 # output to stdout the core fingerprint from the gpg core secret
91 # keyring
92 core_fingerprint() {
93     log debug "determining core key fingerprint..."
94     gpg_core --list-secret-key --with-colons \
95         --fixed-list-mode --with-fingerprint \
96         | grep ^fpr: | cut -d: -f10
97 }
98
99 # export signatures from core to sphere
100 gpg_core_sphere_sig_transfer() {
101     log debug "exporting core local sigs to sphere..."
102     gpg_core --export-options export-local-sigs --export | \
103         gpg_sphere "--import-options import-local-sigs --import" 2>&1 | log debug
104 }
105
106 ########################################################################
107 # MAIN
108 ########################################################################
109
110 # set unset default variables
111 AUTHORIZED_USER_IDS="%h/.monkeysphere/authorized_user_ids"
112 RAW_AUTHORIZED_KEYS="%h/.ssh/authorized_keys"
113
114 # load configuration file
115 [ -e ${MONKEYSPHERE_AUTHENTICATION_CONFIG:="${SYSCONFIGDIR}/monkeysphere-authentication.conf"} ] \
116     && . "$MONKEYSPHERE_AUTHENTICATION_CONFIG"
117
118 # set empty config variable with ones from the environment
119 LOG_LEVEL=${MONKEYSPHERE_LOG_LEVEL:=$LOG_LEVEL}
120 KEYSERVER=${MONKEYSPHERE_KEYSERVER:=$KEYSERVER}
121 CHECK_KEYSERVER=${MONKEYSPHERE_CHECK_KEYSERVER:=$CHECK_KEYSERVER}
122 MONKEYSPHERE_USER=${MONKEYSPHERE_MONKEYSPHERE_USER:=$MONKEYSPHERE_USER}
123 PROMPT=${MONKEYSPHERE_PROMPT:=$PROMPT}
124 AUTHORIZED_USER_IDS=${MONKEYSPHERE_AUTHORIZED_USER_IDS:=$AUTHORIZED_USER_IDS}
125 RAW_AUTHORIZED_KEYS=${MONKEYSPHERE_RAW_AUTHORIZED_KEYS:=$RAW_AUTHORIZED_KEYS}
126
127 # other variables
128 REQUIRED_USER_KEY_CAPABILITY=${MONKEYSPHERE_REQUIRED_USER_KEY_CAPABILITY:="a"}
129 GNUPGHOME_CORE=${MONKEYSPHERE_GNUPGHOME_CORE:="${MADATADIR}/core"}
130 GNUPGHOME_SPHERE=${MONKEYSPHERE_GNUPGHOME_SPHERE:="${MADATADIR}/sphere"}
131 CORE_KEYLENGTH=${MONKEYSPHERE_CORE_KEYLENGTH:="2048"}
132
133 # export variables needed in su invocation
134 export DATE
135 export MODE
136 export LOG_LEVEL
137 export KEYSERVER
138 export MONKEYSPHERE_USER
139 export PROMPT
140 export CHECK_KEYSERVER
141 export REQUIRED_USER_KEY_CAPABILITY
142 export GNUPGHOME_CORE
143 export GNUPGHOME_SPHERE
144 export GNUPGHOME
145 export CORE_KEYLENGTH
146
147 # get subcommand
148 COMMAND="$1"
149 [ "$COMMAND" ] || failure "Type '$PGRM help' for usage."
150 shift
151
152 case $COMMAND in
153     'setup'|'setup'|'s')
154         source "${MASHAREDIR}/setup"
155         setup
156         ;;
157
158     'update-users'|'update-user'|'u')
159         source "${MASHAREDIR}/setup"
160         setup
161         source "${MASHAREDIR}/update_users"
162         update_users "$@"
163         ;;
164
165     'add-identity-certifier'|'add-id-certifier'|'add-certifier'|'c+')
166         source "${MASHAREDIR}/setup"
167         setup
168         source "${MASHAREDIR}/add_certifier"
169         add_certifier "$@"
170         ;;
171
172     'remove-identity-certifier'|'remove-id-certifier'|'remove-certifier'|'c-')
173         source "${MASHAREDIR}/setup"
174         setup
175         source "${MASHAREDIR}/remove_certifier"
176         remove_certifier "$@"
177         ;;
178
179     'list-identity-certifiers'|'list-id-certifiers'|'list-certifiers'|'list-certifier'|'c')
180         source "${MASHAREDIR}/setup"
181         setup
182         source "${MASHAREDIR}/list_certifiers"
183         list_certifiers
184         ;;
185
186     'diagnostics'|'d')
187         source "${MASHAREDIR}/setup"
188         setup
189         source "${MASHAREDIR}/diagnostics"
190         diagnostics
191         ;;
192
193     'gpg-cmd')
194         source "${MASHAREDIR}/setup"
195         setup
196         gpg_sphere "$@"
197         ;;
198
199     'version'|'v')
200         version
201         ;;
202
203     '--help'|'help'|'-h'|'h'|'?')
204         usage
205         ;;
206
207     *)
208         failure "Unknown command: '$COMMAND'
209 Type '$PGRM help' for usage."
210         ;;
211 esac