It's Friday night, Wesley is out, Sammi is not hungry, and Miss Melissa is asleep...
[citadel.git] / webcit-ng / http.c
1 //
2 // This module handles HTTP transactions.
3 //
4 // Copyright (c) 1996-2021 by the citadel.org team
5 //
6 // This program is open source software.  It runs great on the
7 // Linux operating system (and probably elsewhere).  You can use,
8 // copy, and run it under the terms of the GNU General Public
9 // License version 3.
10 //
11 // This program is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 // GNU General Public License for more details.
15
16 #include "webcit.h"
17
18 // Write data to the HTTP client.  Encrypt if necessary.
19 int client_write(struct client_handle *ch, char *buf, int nbytes) {
20         if (is_https) {
21                 return client_write_ssl(ch, buf, nbytes);
22         }
23         else {
24                 return write(ch->sock, buf, nbytes);
25         }
26 }
27
28
29 // Read data from the HTTP client.  Decrypt if necessary.
30 // Returns number of bytes read, or -1 to indicate an error.
31 int client_read(struct client_handle *ch, char *buf, int nbytes) {
32         if (is_https) {
33                 return client_read_ssl(ch, buf, nbytes);
34         }
35         else {
36                 int bytes_received = 0;
37                 int bytes_this_block = 0;
38                 while (bytes_received < nbytes) {
39                         bytes_this_block = read(ch->sock, &buf[bytes_received], nbytes - bytes_received);
40                         if (bytes_this_block < 1) {
41                                 return (-1);
42                         }
43                         bytes_received += bytes_this_block;
44                 }
45                 return (nbytes);
46         }
47 }
48
49
50 // Read a newline-terminated line of text from the client.
51 // Implemented in terms of client_read() and is therefore transparent...
52 // Returns the string length or -1 for error.
53 int client_readline(struct client_handle *ch, char *buf, int maxbytes) {
54         int len = 0;
55         int c = 0;
56
57         if (buf == NULL) {
58                 return (-1);
59         }
60
61         while (len < maxbytes) {
62                 c = client_read(ch, &buf[len], 1);
63                 if (c <= 0) {
64                         syslog(LOG_DEBUG, "Socket error or zero-length read");
65                         return (-1);
66                 }
67                 if (buf[len] == '\n') {
68                         if ((len > 0) && (buf[len - 1] == '\r')) {
69                                 --len;
70                         }
71                         buf[len] = 0;
72                         return (len);
73                 }
74                 ++len;
75         }
76         return (len);
77 }
78
79
80 // printf() type function to send data to the web client.
81 void client_printf(struct client_handle *ch, const char *format, ...) {
82         va_list arg_ptr;
83         StrBuf *Buf = NewStrBuf();
84
85         va_start(arg_ptr, format);
86         StrBufVAppendPrintf(Buf, format, arg_ptr);
87         va_end(arg_ptr);
88
89         client_write(ch, (char *) ChrPtr(Buf), StrLength(Buf));
90         FreeStrBuf(&Buf);
91 }
92
93
94 // Push one new header into the response of an HTTP request.
95 // When completed, the HTTP transaction now owns the memory allocated for key and val.
96 void add_response_header(struct http_transaction *h, char *key, char *val) {
97         struct keyval new_response_header;
98         new_response_header.key = key;
99         new_response_header.val = val;
100         array_append(h->response_headers, &new_response_header);
101 }
102
103
104 // Entry point for this layer.  Socket is connected.  If running as an HTTPS
105 // server, SSL has already been negotiated.  Now perform one transaction.
106 void perform_one_http_transaction(struct client_handle *ch) {
107         char buf[1024];
108         int len;
109         int lines_read = 0;
110         struct http_transaction h;
111         char *c, *d;
112         struct sockaddr_in sin;
113         int i;                                  // general purpose iterator variable
114
115         memset(&h, 0, sizeof h);
116         h.request_headers = array_new(sizeof(struct keyval));
117         h.request_parms = array_new(sizeof(struct keyval));
118         h.response_headers = array_new(sizeof(struct keyval));
119
120         while (len = client_readline(ch, buf, sizeof buf), (len > 0)) {
121                 ++lines_read;
122
123                 if (lines_read == 1) {          // First line is method and URL.
124                         c = strchr(buf, ' ');   // IGnore the HTTP-version.
125                         if (c == NULL) {
126                                 h.method = strdup("NULL");
127                                 h.url = strdup("/");
128                         }
129                         else {
130                                 *c = 0;
131                                 h.method = strdup(buf);
132                                 ++c;
133                                 d = c;
134                                 c = strchr(d, ' ');
135                                 if (c != NULL) {
136                                         *c = 0;
137                                 }
138                                 ++c;
139                                 h.url = strdup(d);
140                         }
141                 }
142                 else {                  // Subsequent lines are headers.
143                         c = strchr(buf, ':');   // Header line folding is obsolete so we don't support it.
144                         if (c != NULL) {
145
146                                 struct keyval new_request_header;
147                                 *c = 0;
148                                 new_request_header.key = strdup(buf);
149                                 ++c;
150                                 new_request_header.val = strdup(c);
151                                 striplt(new_request_header.key);
152                                 striplt(new_request_header.val);
153                                 array_append(h.request_headers, &new_request_header);
154 #ifdef DEBUG_HTTP
155                                 syslog(LOG_DEBUG, "\033[1m\033[35m{ %s: %s\033[0m", new_request_header.key, new_request_header.val);
156 #endif
157                         }
158                 }
159
160         }
161
162         // If the URL had any query parameters in it, parse them out now.
163         char *p = strchr(h.url, '?');
164         if (p) {
165                 *p++ = 0;                                               // insert a null to remove parameters from the URL
166                 char *tok, *saveptr = NULL;
167                 for (tok = strtok_r(p, "&", &saveptr); tok!=NULL; tok = strtok_r(NULL, "&", &saveptr)) {
168                         char *eq = strchr(tok, '=');
169                         if (eq) {
170                                 *eq++ = 0;
171                                 unescape_input(eq);
172                                 struct keyval kv;
173                                 kv.key = strdup(tok);
174                                 kv.val = strdup(eq);
175                                 array_append(h.request_parms, &kv);
176                         }
177                 }
178         }
179
180         // build up the site prefix, such as https://foo.bar.com:4343
181         h.site_prefix = malloc(256);
182         strcpy(h.site_prefix, (is_https ? "https://" : "http://"));
183         char *hostheader = header_val(&h, "Host");
184         if (hostheader) {
185                 strcat(h.site_prefix, hostheader);
186         }
187         else {
188                 strcat(h.site_prefix, "127.0.0.1");
189         }
190         socklen_t llen = sizeof(sin);
191         if (getsockname(ch->sock, (struct sockaddr *) &sin, &llen) >= 0) {
192                 sprintf(&h.site_prefix[strlen(h.site_prefix)], ":%d", ntohs(sin.sin_port));
193         }
194
195         // Now try to read in the request body (if one is present)
196         if (len < 0) {
197                 syslog(LOG_DEBUG, "Client disconnected");
198         }
199         else {
200                 syslog(LOG_DEBUG, "\033[33m\033[1m< %s %s\033[0m", h.method, h.url);
201
202                 // If there is a request body, read it now.
203                 char *ccl = header_val(&h, "Content-Length");
204                 if (ccl) {
205                         h.request_body_length = atol(ccl);
206                 }
207                 if (h.request_body_length > 0) {
208                         syslog(LOG_DEBUG, "Reading request body (%ld bytes)", h.request_body_length);
209                         h.request_body = malloc(h.request_body_length);
210                         client_read(ch, h.request_body, h.request_body_length);
211
212                         //write(2, HKEY("\033[31m"));
213                         //write(2, h.request_body, h.request_body_length);
214                         //write(2, HKEY("\033[0m\n"));
215
216                 }
217                 // Now pass control up to the next layer to perform the request.
218                 perform_request(&h);
219
220                 // Output the results back to the client.
221                 //write(2, HKEY("\033[32m"));
222                 //write(2, h.response_body, h.response_body_length);
223                 //write(2, HKEY("\033[0m\n"));
224
225                 syslog(LOG_DEBUG, "> %03d %s", h.response_code, h.response_string);
226                 client_printf(ch, "HTTP/1.1 %03d %s\r\n", h.response_code, h.response_string);
227                 client_printf(ch, "Connection: close\r\n");
228                 client_printf(ch, "Content-Length: %ld\r\n", h.response_body_length);
229                 char *datestring = http_datestring(time(NULL));
230                 if (datestring) {
231                         client_printf(ch, "Date: %s\r\n", datestring);
232                         free(datestring);
233                 }
234
235                 client_printf(ch, "Content-encoding: identity\r\n");    // change if we gzip/deflate
236                 int number_of_response_headers = array_len(h.response_headers);
237                 for (i=0; i<number_of_response_headers; ++i) {
238                         struct keyval *kv = array_get_element_at(h.response_headers, i);
239 #ifdef DEBUG_HTTP
240                         syslog(LOG_DEBUG, "\033[1m\033[35m} %s: %s\033[0m", kv->key, kv->val);
241 #endif
242                         client_printf(ch, "%s: %s\r\n", kv->key, kv->val);
243                 }
244                 client_printf(ch, "\r\n");
245                 if ((h.response_body_length > 0) && (h.response_body != NULL)) {
246                         client_write(ch, h.response_body, h.response_body_length);
247                 }
248         }
249
250         // free the transaction memory
251         while (array_len(h.request_headers) > 0) {
252                 struct keyval *kv = array_get_element_at(h.request_headers, 0);
253                 if (kv->key) free(kv->key);
254                 if (kv->val) free(kv->val);
255                 array_delete_element_at(h.request_headers, 0);
256         }
257         array_free(h.request_headers);
258         while (array_len(h.request_parms) > 0) {
259                 struct keyval *kv = array_get_element_at(h.request_parms, 0);
260                 if (kv->key) free(kv->key);
261                 if (kv->val) free(kv->val);
262                 array_delete_element_at(h.request_parms, 0);
263         }
264         array_free(h.request_parms);
265         while (array_len(h.response_headers) > 0) {
266                 struct keyval *kv = array_get_element_at(h.response_headers, 0);
267                 if (kv->key) free(kv->key);
268                 if (kv->val) free(kv->val);
269                 array_delete_element_at(h.response_headers, 0);
270         }
271         array_free(h.response_headers);
272         if (h.method) {
273                 free(h.method);
274         }
275         if (h.url) {
276                 free(h.url);
277         }
278         if (h.request_body) {
279                 free(h.request_body);
280         }
281         if (h.response_string) {
282                 free(h.response_string);
283         }
284         if (h.site_prefix) {
285                 free(h.site_prefix);
286         }
287 }
288
289
290 // Utility function to fetch a specific header from a completely read-in request.
291 // Returns the value of the requested header, or NULL if the specified header was not sent.
292 // The caller does NOT own the memory of the returned pointer, but can count on the pointer
293 // to still be valid through the end of the transaction.
294 char *header_val(struct http_transaction *h, char *requested_header) {
295         struct keyval *kv;
296         int i;
297         for (i=0; i<array_len(h->request_headers); ++i) {
298                 kv = array_get_element_at(h->request_headers, i);
299                 if (!strcasecmp(kv->key, requested_header)) {
300                         return (kv->val);
301                 }
302         }
303         return (NULL);
304 }