chiark / gitweb /
server/: Post-merge fixup.
[tripe] / contrib / knock.in
1 #! /bin/sh
2 ###
3 ### SSH forced-command script for establishing dynamic associations.
4 ###
5 ### (c) 2012 Mark Wooding
6 ###
7
8 ###----- Licensing notice ---------------------------------------------------
9 ###
10 ### This file is part of Trivial IP Encryption (TrIPE).
11 ###
12 ### TrIPE is free software: you can redistribute it and/or modify it under
13 ### the terms of the GNU General Public License as published by the Free
14 ### Software Foundation; either version 3 of the License, or (at your
15 ### option) any later version.
16 ###
17 ### TrIPE is distributed in the hope that it will be useful, but WITHOUT
18 ### ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
19 ### FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
20 ### for more details.
21 ###
22 ### You should have received a copy of the GNU General Public License
23 ### along with TrIPE.  If not, see <https://www.gnu.org/licenses/>.
24
25 set -e
26
27 ### This script performs the passive side of a dynamic association.  It is
28 ### intended to be set as the forced command in an `.ssh/authorized_keys'
29 ### file.  Specifically, for each dynamic peer, add a line to
30 ### `.ssh/authorized_keys' of the form
31 ###
32 ###     environment="TRIPE_USER=PEER" ssh-rsa ...
33 ###
34 ### There's an additional wrinkle.  Suppose that the passive TrIPE endpoint
35 ### is behind a NAT, and the SSH gateway is on a different machine.  The
36 ### gateway should have its own `tripe' user, and this script should again be
37 ### its shell.  On the gateway, add a `.ssh/authorized_keys' entry
38 ###
39 ###     environment="TRIPE_USER=tripe@SERVER:PEER" ssh-rsa ...
40 ###
41 ### for the dynamic endpoint.  On the passive endpoint itself, you need an
42 ### entry for the gateway's `tripe' user's key, with `TRIPE_GATEWAY' set to
43 ### any value, like
44 ###
45 ###     environment="TRIPE_GATEWAY=t" ssh-rsa ...
46 ###
47 ### For backwards compatibility, it can also be set as the `tripe' user's
48 ### shell, with the `[tripe@SERVER:]PEER' indicator set as the forced
49 ### command.  If there are no forced command or `TRIPE_*' environment
50 ### variables then it is assumed that a gateway is calling.
51
52 : ${prefix=@prefix@} ${exec_prefix=@exec_prefix@}
53 : ${bindir=@bindir@}
54 : ${TRIPEDIR=@configdir@} ${TRIPESOCK=@socketdir@/tripesock}
55 : ${tripectl=$bindir/tripectl}
56 export TRIPEDIR TRIPESOCK
57
58 ## Make sure we're being called properly, and figure out the peer identity.
59 case "${TRIPE_USER+t},${TRIPE_GATEWAY+t},$#,$1" in
60   t,,0,) set -- "$TRIPE_USER" ;;
61   ,t,0,) set -- $SSH_ORIGINAL_COMMAND; unset SSH_ORIGINAL_COMMAND ;;
62   ,,2,-c) ;;
63   *)
64     echo >&2 "usage: $0 -c [SERVER:]PEER [ACTION]"
65     exit 1
66     ;;
67 esac
68
69 ## Examine the peer identifier and work out how to proceed.
70 case "$#,$1" in
71   0,*) echo >&2 "missing peer identifier"; exit 1 ;;
72   *:*) mode=proxy server=${1%:*} user=${1##*:} ;;
73   *) mode=local user=$1 ;;
74 esac
75 shift
76
77 ## Fetch the optional command from where SSH stashed it.
78 case "$#" in 0) set -- $SSH_ORIGINAL_COMMAND ;; esac
79 case "$#,$1" in
80   0, | 1,hello) act=hello ;;
81   1,goodbye) act=goodbye ;;
82   *) echo >&2 "$0: unknown action spec \`$*'"; exit 1 ;;
83 esac
84
85 ## Now actually do something.
86 case "$mode,$act" in
87   proxy,*)
88     exec ssh "$server" "$user" "$act"
89     ;;
90   local,hello)
91     exec $tripectl SVCSUBMIT connect passive "$user"
92     ;;
93   local,goodbye)
94     peer=$($tripectl SVCSUBMIT connect userpeer "$user")
95     exec $tripectl KILL "$peer"
96     ;;
97   *)
98     echo >&2 "$0: unknown mode/action $mode/$act"
99     exit 1
100     ;;
101 esac