1 | //auth.c: |
---|
2 | |
---|
3 | /* |
---|
4 | * Copyright (C) Philipp 'ph3-der-loewe' Schafft - 2008-2010 |
---|
5 | * |
---|
6 | * This file is part of libroar a part of RoarAudio, |
---|
7 | * a cross-platform sound system for both, home and professional use. |
---|
8 | * See README for details. |
---|
9 | * |
---|
10 | * This file is free software; you can redistribute it and/or modify |
---|
11 | * it under the terms of the GNU General Public License version 3 |
---|
12 | * as published by the Free Software Foundation. |
---|
13 | * |
---|
14 | * libroar is distributed in the hope that it will be useful, |
---|
15 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
16 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
---|
17 | * GNU General Public License for more details. |
---|
18 | * |
---|
19 | * You should have received a copy of the GNU General Public License |
---|
20 | * along with this software; see the file COPYING. If not, write to |
---|
21 | * the Free Software Foundation, 51 Franklin Street, Fifth Floor, |
---|
22 | * Boston, MA 02110-1301, USA. |
---|
23 | * |
---|
24 | * NOTE for everyone want's to change something and send patches: |
---|
25 | * read README and HACKING! There a addition information on |
---|
26 | * the license of this document you need to read before you send |
---|
27 | * any patches. |
---|
28 | * |
---|
29 | * NOTE for uses of non-GPL (LGPL,...) software using libesd, libartsc |
---|
30 | * or libpulse*: |
---|
31 | * The libs libroaresd, libroararts and libroarpulse link this lib |
---|
32 | * and are therefore GPL. Because of this it may be illegal to use |
---|
33 | * them with any software that uses libesd, libartsc or libpulse*. |
---|
34 | */ |
---|
35 | |
---|
36 | #include "libroar.h" |
---|
37 | |
---|
38 | /* How auth works: |
---|
39 | * 0) set stage to zero |
---|
40 | * 1) get server address and local node name (from uname()) |
---|
41 | * 2) look up authfile/authdb/authservice for the server+local address + stage. |
---|
42 | * if no data was found send NONE-Auth. |
---|
43 | * 3) send data to server |
---|
44 | * 4) read answer from server |
---|
45 | * 5) if stage of server response is non-zero increment stage to server stage+1 |
---|
46 | * and repeat from step 2) |
---|
47 | * 6) check if we got an OK or an ERROR, return correct value |
---|
48 | */ |
---|
49 | |
---|
50 | /* The protocol: |
---|
51 | * Auth request: |
---|
52 | * Byte 0: auth type |
---|
53 | * Byte 1: stage |
---|
54 | * Byte 2: reserved (must be zero) |
---|
55 | * Byte 3: reserved (must be zero) |
---|
56 | * Byte 4-end: auth type depending data. |
---|
57 | * |
---|
58 | * If no data is to be send bytes 2 and 3 can be omitted. |
---|
59 | * If no data is to be send and stage is zero bytes 1, 2 and 3 can be omitted. |
---|
60 | * |
---|
61 | * Auth response: |
---|
62 | * The same as the auth request. |
---|
63 | * if the server sends an zero size message back it means the server accepted our connection |
---|
64 | * and no additional stage is needed. |
---|
65 | * if the message type is OK the server accepted our auth. |
---|
66 | * if the message type is ERROR the server rejected us. we may try other auth methods. |
---|
67 | * if the server accepted our data and the stage is non-zero we need to continue with the next |
---|
68 | * stage of the auth. |
---|
69 | * if the server rejected us the auth type value of the response is a suggested next auth type |
---|
70 | * we should try if possible. This may help the client to find a working auth type. |
---|
71 | */ |
---|
72 | |
---|
73 | /* The protocol by auth type: |
---|
74 | * |
---|
75 | * --- NONE: |
---|
76 | * No data is send, the server accepts the connect or rejects it depending on some |
---|
77 | * magic within the server. we do not care about this. |
---|
78 | * The data block is not used. |
---|
79 | * |
---|
80 | * --- COOKIE: |
---|
81 | * We send cookies for all stages the server ask us to provide a cookie. |
---|
82 | * if a cookie is wrong the server rejects us or asks us for another. |
---|
83 | * The cookie is send as binary data in the data block. |
---|
84 | * |
---|
85 | * --- TRUST: |
---|
86 | * We ask the server to auth us based on our UID/GID/PID. |
---|
87 | * The server may reject this because we are not allowed or because it is not |
---|
88 | * supported by the transport. |
---|
89 | * If we get rejected we may try to continue with IDENT then RHOST before we use NONE. |
---|
90 | * The data block is not used. |
---|
91 | * |
---|
92 | * --- PASSWORD: |
---|
93 | * This is technically the same as COOKIE just that the cookie is limited to |
---|
94 | * printable ASCII chars and that the user should be asked to provide the password. |
---|
95 | * This may be done via a GUI popup window. |
---|
96 | * |
---|
97 | * --- SYSUSER: |
---|
98 | * We provide a Username + Password for a system user. |
---|
99 | * The data block contains of two main parts: |
---|
100 | * The first part is a one byte long subtype. |
---|
101 | * The value must be 0x01 for username+password. |
---|
102 | * future versions may define other types. |
---|
103 | * the second part is the actual data block. |
---|
104 | * for username+password it is splited into two fields, both terminated with \0. |
---|
105 | * the first is the username the last one the password as clear text. |
---|
106 | * Example: char data[] = "\001MyUser\0MyPassword\0"; |
---|
107 | * |
---|
108 | * --- OPENPGP_SIGN: |
---|
109 | * |
---|
110 | * --- OPENPGP_ENCRYPT: |
---|
111 | * |
---|
112 | * --- OPENPGP_AUTH: |
---|
113 | * |
---|
114 | * --- KERBEROS: |
---|
115 | * We use Kerberos to auth. |
---|
116 | * |
---|
117 | * --- RHOST: |
---|
118 | * The server is asked to auth us based on our source address. |
---|
119 | * The data block is not used. |
---|
120 | * |
---|
121 | * --- XAUTH: |
---|
122 | * We send an X11 Cookie. |
---|
123 | * |
---|
124 | * --- IDENT: |
---|
125 | * The server is asked to auth us based on our source address using the IDENT protocol. |
---|
126 | * The data block is not used. |
---|
127 | * |
---|
128 | */ |
---|
129 | |
---|
130 | static int roar_auth_ask_server (struct roar_connection * con, struct roar_auth_message * authmes) { |
---|
131 | struct roar_message mes; |
---|
132 | char * header = mes.data; |
---|
133 | int ret; |
---|
134 | |
---|
135 | memset(&mes, 0, sizeof(struct roar_message)); // make valgrind happy! |
---|
136 | |
---|
137 | mes.cmd = ROAR_CMD_AUTH; |
---|
138 | mes.datalen = 4; |
---|
139 | |
---|
140 | header[0] = authmes->type; |
---|
141 | header[1] = authmes->stage; |
---|
142 | header[2] = authmes->reserved.c[0]; |
---|
143 | header[3] = authmes->reserved.c[1]; |
---|
144 | |
---|
145 | if ( (ret = roar_req(con, &mes, NULL)) == -1 ) |
---|
146 | return -1; |
---|
147 | |
---|
148 | if ( mes.datalen < 4 ) { |
---|
149 | memset(header+mes.datalen, 0, 4-mes.datalen); |
---|
150 | } |
---|
151 | |
---|
152 | authmes->type = header[0]; |
---|
153 | authmes->stage = header[1]; |
---|
154 | authmes->reserved.c[0] = header[2]; |
---|
155 | authmes->reserved.c[1] = header[3]; |
---|
156 | |
---|
157 | return 0; |
---|
158 | } |
---|
159 | |
---|
160 | static void roar_auth_mes_init(struct roar_auth_message * authmes, int type) { |
---|
161 | memset(authmes, 0, sizeof(struct roar_auth_message)); |
---|
162 | |
---|
163 | authmes->type = type; |
---|
164 | authmes->stage = 0; |
---|
165 | authmes->data = NULL; |
---|
166 | authmes->len = 0; |
---|
167 | } |
---|
168 | |
---|
169 | #define _EOL ROAR_AUTH_T_AUTO |
---|
170 | int roar_auth (struct roar_connection * con) { |
---|
171 | struct roar_auth_message authmes; |
---|
172 | int ret; |
---|
173 | int i; |
---|
174 | int ltt[] = { |
---|
175 | ROAR_AUTH_T_TRUST, |
---|
176 | ROAR_AUTH_T_IDENT, |
---|
177 | ROAR_AUTH_T_RHOST, |
---|
178 | ROAR_AUTH_T_NONE, |
---|
179 | _EOL |
---|
180 | }; |
---|
181 | |
---|
182 | for (i = 0; ltt[i] != _EOL; i++) { |
---|
183 | roar_auth_mes_init(&authmes, ltt[i]); |
---|
184 | |
---|
185 | if ( (ret = roar_auth_ask_server(con, &authmes)) == -1 ) |
---|
186 | continue; |
---|
187 | |
---|
188 | if ( authmes.stage != 0 ) |
---|
189 | continue; |
---|
190 | |
---|
191 | return 0; |
---|
192 | } |
---|
193 | |
---|
194 | return -1; |
---|
195 | } |
---|
196 | |
---|
197 | // String functions: |
---|
198 | static struct { |
---|
199 | int type; |
---|
200 | char * name; |
---|
201 | } _g_authts[] = { |
---|
202 | // grep ^'#define ROAR_AUTH_T_' auth.h | while read d t d; do n=$(cut -d_ -f4 <<<$t | tr A-Z a-z); printf ' {%-28s %-10s},\n' $t, \"$n\"; done |
---|
203 | {ROAR_AUTH_T_NONE, "none" }, |
---|
204 | {ROAR_AUTH_T_COOKIE, "cookie" }, |
---|
205 | {ROAR_AUTH_T_TRUST, "trust" }, |
---|
206 | {ROAR_AUTH_T_PASSWORD, "password"}, |
---|
207 | {ROAR_AUTH_T_SYSUSER, "sysuser" }, |
---|
208 | {ROAR_AUTH_T_OPENPGP_SIGN, "openpgp" }, |
---|
209 | {ROAR_AUTH_T_OPENPGP_ENCRYPT, "openpgp" }, |
---|
210 | {ROAR_AUTH_T_OPENPGP_AUTH, "openpgp" }, |
---|
211 | {ROAR_AUTH_T_KERBEROS, "kerberos"}, |
---|
212 | {ROAR_AUTH_T_RHOST, "rhost" }, |
---|
213 | {ROAR_AUTH_T_XAUTH, "xauth" }, |
---|
214 | {ROAR_AUTH_T_IDENT, "ident" }, |
---|
215 | {-1, NULL} |
---|
216 | }; |
---|
217 | |
---|
218 | int roar_str2autht(char * str) { |
---|
219 | int i; |
---|
220 | |
---|
221 | for (i = 0; _g_authts[i].name != NULL; i++) |
---|
222 | if ( !strcasecmp(_g_authts[i].name, str) ) |
---|
223 | return _g_authts[i].type; |
---|
224 | |
---|
225 | return -1; |
---|
226 | } |
---|
227 | |
---|
228 | char * roar_autht2str(int auth) { |
---|
229 | int i; |
---|
230 | |
---|
231 | for (i = 0; _g_authts[i].name != NULL; i++) |
---|
232 | if ( _g_authts[i].type == auth ) |
---|
233 | return _g_authts[i].name; |
---|
234 | |
---|
235 | return "(UNKNOWN)"; |
---|
236 | } |
---|
237 | |
---|
238 | //ll |
---|