xref: /qemu/ui/vnc-ws.c (revision 4a48aaa9f52dbac148be24f591de2f28c58ccb5d)
17536ee4bSTim Hardeck /*
27536ee4bSTim Hardeck  * QEMU VNC display driver: Websockets support
37536ee4bSTim Hardeck  *
47536ee4bSTim Hardeck  * Copyright (C) 2010 Joel Martin
57536ee4bSTim Hardeck  * Copyright (C) 2012 Tim Hardeck
67536ee4bSTim Hardeck  *
77536ee4bSTim Hardeck  * This is free software; you can redistribute it and/or modify
87536ee4bSTim Hardeck  * it under the terms of the GNU General Public License as published by
97536ee4bSTim Hardeck  * the Free Software Foundation; either version 2 of the License, or
107536ee4bSTim Hardeck  * (at your option) any later version.
117536ee4bSTim Hardeck  *
127536ee4bSTim Hardeck  * This software is distributed in the hope that it will be useful,
137536ee4bSTim Hardeck  * but WITHOUT ANY WARRANTY; without even the implied warranty of
147536ee4bSTim Hardeck  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
157536ee4bSTim Hardeck  * GNU General Public License for more details.
167536ee4bSTim Hardeck  *
177536ee4bSTim Hardeck  * You should have received a copy of the GNU General Public License
187536ee4bSTim Hardeck  * along with this software; if not, see <http://www.gnu.org/licenses/>.
197536ee4bSTim Hardeck  */
207536ee4bSTim Hardeck 
217536ee4bSTim Hardeck #include "vnc.h"
226a1751b7SAlex Bligh #include "qemu/main-loop.h"
237536ee4bSTim Hardeck 
240057a0d5STim Hardeck #ifdef CONFIG_VNC_TLS
250057a0d5STim Hardeck #include "qemu/sockets.h"
260057a0d5STim Hardeck 
270057a0d5STim Hardeck static int vncws_start_tls_handshake(struct VncState *vs)
280057a0d5STim Hardeck {
297b45a00dSDaniel P. Berrange     int ret = gnutls_handshake(vs->tls.session);
300057a0d5STim Hardeck 
310057a0d5STim Hardeck     if (ret < 0) {
320057a0d5STim Hardeck         if (!gnutls_error_is_fatal(ret)) {
330057a0d5STim Hardeck             VNC_DEBUG("Handshake interrupted (blocking)\n");
347b45a00dSDaniel P. Berrange             if (!gnutls_record_get_direction(vs->tls.session)) {
350057a0d5STim Hardeck                 qemu_set_fd_handler(vs->csock, vncws_tls_handshake_io,
360057a0d5STim Hardeck                                     NULL, vs);
370057a0d5STim Hardeck             } else {
380057a0d5STim Hardeck                 qemu_set_fd_handler(vs->csock, NULL, vncws_tls_handshake_io,
390057a0d5STim Hardeck                                     vs);
400057a0d5STim Hardeck             }
410057a0d5STim Hardeck             return 0;
420057a0d5STim Hardeck         }
430057a0d5STim Hardeck         VNC_DEBUG("Handshake failed %s\n", gnutls_strerror(ret));
440057a0d5STim Hardeck         vnc_client_error(vs);
450057a0d5STim Hardeck         return -1;
460057a0d5STim Hardeck     }
470057a0d5STim Hardeck 
48*4a48aaa9SDaniel P. Berrange     if (vs->vd->tls.x509verify) {
49*4a48aaa9SDaniel P. Berrange         if (vnc_tls_validate_certificate(vs) < 0) {
50*4a48aaa9SDaniel P. Berrange             VNC_DEBUG("Client verification failed\n");
51*4a48aaa9SDaniel P. Berrange             vnc_client_error(vs);
52*4a48aaa9SDaniel P. Berrange             return -1;
53*4a48aaa9SDaniel P. Berrange         } else {
54*4a48aaa9SDaniel P. Berrange             VNC_DEBUG("Client verification passed\n");
55*4a48aaa9SDaniel P. Berrange         }
56*4a48aaa9SDaniel P. Berrange     }
57*4a48aaa9SDaniel P. Berrange 
580057a0d5STim Hardeck     VNC_DEBUG("Handshake done, switching to TLS data mode\n");
590057a0d5STim Hardeck     qemu_set_fd_handler2(vs->csock, NULL, vncws_handshake_read, NULL, vs);
600057a0d5STim Hardeck 
610057a0d5STim Hardeck     return 0;
620057a0d5STim Hardeck }
630057a0d5STim Hardeck 
6451941e46SDaniel P. Berrange void vncws_tls_handshake_io(void *opaque)
650057a0d5STim Hardeck {
660057a0d5STim Hardeck     struct VncState *vs = (struct VncState *)opaque;
670057a0d5STim Hardeck 
6851941e46SDaniel P. Berrange     if (!vs->tls.session) {
6951941e46SDaniel P. Berrange         VNC_DEBUG("TLS Websocket setup\n");
7051941e46SDaniel P. Berrange         if (vnc_tls_client_setup(vs, vs->vd->tls.x509cert != NULL) < 0) {
7151941e46SDaniel P. Berrange             return;
7251941e46SDaniel P. Berrange         }
7351941e46SDaniel P. Berrange     }
740057a0d5STim Hardeck     VNC_DEBUG("Handshake IO continue\n");
750057a0d5STim Hardeck     vncws_start_tls_handshake(vs);
760057a0d5STim Hardeck }
770057a0d5STim Hardeck #endif /* CONFIG_VNC_TLS */
780057a0d5STim Hardeck 
797536ee4bSTim Hardeck void vncws_handshake_read(void *opaque)
807536ee4bSTim Hardeck {
817536ee4bSTim Hardeck     VncState *vs = opaque;
827536ee4bSTim Hardeck     uint8_t *handshake_end;
837536ee4bSTim Hardeck     long ret;
847536ee4bSTim Hardeck     buffer_reserve(&vs->ws_input, 4096);
857536ee4bSTim Hardeck     ret = vnc_client_read_buf(vs, buffer_end(&vs->ws_input), 4096);
867536ee4bSTim Hardeck 
877536ee4bSTim Hardeck     if (!ret) {
887536ee4bSTim Hardeck         if (vs->csock == -1) {
897536ee4bSTim Hardeck             vnc_disconnect_finish(vs);
907536ee4bSTim Hardeck         }
917536ee4bSTim Hardeck         return;
927536ee4bSTim Hardeck     }
937536ee4bSTim Hardeck     vs->ws_input.offset += ret;
947536ee4bSTim Hardeck 
957536ee4bSTim Hardeck     handshake_end = (uint8_t *)g_strstr_len((char *)vs->ws_input.buffer,
967536ee4bSTim Hardeck             vs->ws_input.offset, WS_HANDSHAKE_END);
977536ee4bSTim Hardeck     if (handshake_end) {
987536ee4bSTim Hardeck         qemu_set_fd_handler2(vs->csock, NULL, vnc_client_read, NULL, vs);
997536ee4bSTim Hardeck         vncws_process_handshake(vs, vs->ws_input.buffer, vs->ws_input.offset);
1007536ee4bSTim Hardeck         buffer_advance(&vs->ws_input, handshake_end - vs->ws_input.buffer +
1017536ee4bSTim Hardeck                 strlen(WS_HANDSHAKE_END));
1027536ee4bSTim Hardeck     }
1037536ee4bSTim Hardeck }
1047536ee4bSTim Hardeck 
1057536ee4bSTim Hardeck 
1067536ee4bSTim Hardeck long vnc_client_read_ws(VncState *vs)
1077536ee4bSTim Hardeck {
1087536ee4bSTim Hardeck     int ret, err;
1097536ee4bSTim Hardeck     uint8_t *payload;
1107536ee4bSTim Hardeck     size_t payload_size, frame_size;
1117536ee4bSTim Hardeck     VNC_DEBUG("Read websocket %p size %zd offset %zd\n", vs->ws_input.buffer,
1127536ee4bSTim Hardeck             vs->ws_input.capacity, vs->ws_input.offset);
1137536ee4bSTim Hardeck     buffer_reserve(&vs->ws_input, 4096);
1147536ee4bSTim Hardeck     ret = vnc_client_read_buf(vs, buffer_end(&vs->ws_input), 4096);
1157536ee4bSTim Hardeck     if (!ret) {
1167536ee4bSTim Hardeck         return 0;
1177536ee4bSTim Hardeck     }
1187536ee4bSTim Hardeck     vs->ws_input.offset += ret;
1197536ee4bSTim Hardeck 
1207536ee4bSTim Hardeck     /* make sure that nothing is left in the ws_input buffer */
1217536ee4bSTim Hardeck     do {
1227536ee4bSTim Hardeck         err = vncws_decode_frame(&vs->ws_input, &payload,
1237536ee4bSTim Hardeck                               &payload_size, &frame_size);
1247536ee4bSTim Hardeck         if (err <= 0) {
1257536ee4bSTim Hardeck             return err;
1267536ee4bSTim Hardeck         }
1277536ee4bSTim Hardeck 
1287536ee4bSTim Hardeck         buffer_reserve(&vs->input, payload_size);
1297536ee4bSTim Hardeck         buffer_append(&vs->input, payload, payload_size);
1307536ee4bSTim Hardeck 
1317536ee4bSTim Hardeck         buffer_advance(&vs->ws_input, frame_size);
1327536ee4bSTim Hardeck     } while (vs->ws_input.offset > 0);
1337536ee4bSTim Hardeck 
1347536ee4bSTim Hardeck     return ret;
1357536ee4bSTim Hardeck }
1367536ee4bSTim Hardeck 
1377536ee4bSTim Hardeck long vnc_client_write_ws(VncState *vs)
1387536ee4bSTim Hardeck {
1397536ee4bSTim Hardeck     long ret;
1407536ee4bSTim Hardeck     VNC_DEBUG("Write WS: Pending output %p size %zd offset %zd\n",
1417536ee4bSTim Hardeck               vs->output.buffer, vs->output.capacity, vs->output.offset);
1427536ee4bSTim Hardeck     vncws_encode_frame(&vs->ws_output, vs->output.buffer, vs->output.offset);
1437536ee4bSTim Hardeck     buffer_reset(&vs->output);
1447536ee4bSTim Hardeck     ret = vnc_client_write_buf(vs, vs->ws_output.buffer, vs->ws_output.offset);
1457536ee4bSTim Hardeck     if (!ret) {
1467536ee4bSTim Hardeck         return 0;
1477536ee4bSTim Hardeck     }
1487536ee4bSTim Hardeck 
1497536ee4bSTim Hardeck     buffer_advance(&vs->ws_output, ret);
1507536ee4bSTim Hardeck 
1517536ee4bSTim Hardeck     if (vs->ws_output.offset == 0) {
1527536ee4bSTim Hardeck         qemu_set_fd_handler2(vs->csock, NULL, vnc_client_read, NULL, vs);
1537536ee4bSTim Hardeck     }
1547536ee4bSTim Hardeck 
1557536ee4bSTim Hardeck     return ret;
1567536ee4bSTim Hardeck }
1577536ee4bSTim Hardeck 
1587536ee4bSTim Hardeck static char *vncws_extract_handshake_entry(const char *handshake,
1597536ee4bSTim Hardeck         size_t handshake_len, const char *name)
1607536ee4bSTim Hardeck {
1617536ee4bSTim Hardeck     char *begin, *end, *ret = NULL;
1627536ee4bSTim Hardeck     char *line = g_strdup_printf("%s%s: ", WS_HANDSHAKE_DELIM, name);
1637536ee4bSTim Hardeck     begin = g_strstr_len(handshake, handshake_len, line);
1647536ee4bSTim Hardeck     if (begin != NULL) {
1657536ee4bSTim Hardeck         begin += strlen(line);
1667536ee4bSTim Hardeck         end = g_strstr_len(begin, handshake_len - (begin - handshake),
1677536ee4bSTim Hardeck                 WS_HANDSHAKE_DELIM);
1687536ee4bSTim Hardeck         if (end != NULL) {
1697536ee4bSTim Hardeck             ret = g_strndup(begin, end - begin);
1707536ee4bSTim Hardeck         }
1717536ee4bSTim Hardeck     }
1727536ee4bSTim Hardeck     g_free(line);
1737536ee4bSTim Hardeck     return ret;
1747536ee4bSTim Hardeck }
1757536ee4bSTim Hardeck 
1767536ee4bSTim Hardeck static void vncws_send_handshake_response(VncState *vs, const char* key)
1777536ee4bSTim Hardeck {
1787536ee4bSTim Hardeck     char combined_key[WS_CLIENT_KEY_LEN + WS_GUID_LEN + 1];
179cfba8e6fSMarkus Armbruster     unsigned char hash[SHA1_DIGEST_LEN];
180cfba8e6fSMarkus Armbruster     size_t hash_size = sizeof(hash);
1817536ee4bSTim Hardeck     char *accept = NULL, *response = NULL;
1827536ee4bSTim Hardeck     gnutls_datum_t in;
183cfba8e6fSMarkus Armbruster     int ret;
1847536ee4bSTim Hardeck 
1857536ee4bSTim Hardeck     g_strlcpy(combined_key, key, WS_CLIENT_KEY_LEN + 1);
1867536ee4bSTim Hardeck     g_strlcat(combined_key, WS_GUID, WS_CLIENT_KEY_LEN + WS_GUID_LEN + 1);
1877536ee4bSTim Hardeck 
1887536ee4bSTim Hardeck     /* hash and encode it */
1897536ee4bSTim Hardeck     in.data = (void *)combined_key;
1907536ee4bSTim Hardeck     in.size = WS_CLIENT_KEY_LEN + WS_GUID_LEN;
191cfba8e6fSMarkus Armbruster     ret = gnutls_fingerprint(GNUTLS_DIG_SHA1, &in, hash, &hash_size);
192cfba8e6fSMarkus Armbruster     if (ret == GNUTLS_E_SUCCESS && hash_size <= SHA1_DIGEST_LEN) {
193cfba8e6fSMarkus Armbruster         accept = g_base64_encode(hash, hash_size);
1947536ee4bSTim Hardeck     }
1957536ee4bSTim Hardeck     if (accept == NULL) {
1967536ee4bSTim Hardeck         VNC_DEBUG("Hashing Websocket combined key failed\n");
1977536ee4bSTim Hardeck         vnc_client_error(vs);
1987536ee4bSTim Hardeck         return;
1997536ee4bSTim Hardeck     }
2007536ee4bSTim Hardeck 
2017536ee4bSTim Hardeck     response = g_strdup_printf(WS_HANDSHAKE, accept);
202b57489cfSJorge Acereda Maciá     vnc_client_write_buf(vs, (const uint8_t *)response, strlen(response));
2037536ee4bSTim Hardeck 
2047536ee4bSTim Hardeck     g_free(accept);
2057536ee4bSTim Hardeck     g_free(response);
2067536ee4bSTim Hardeck 
2077536ee4bSTim Hardeck     vs->encode_ws = 1;
2087536ee4bSTim Hardeck     vnc_init_state(vs);
2097536ee4bSTim Hardeck }
2107536ee4bSTim Hardeck 
2117536ee4bSTim Hardeck void vncws_process_handshake(VncState *vs, uint8_t *line, size_t size)
2127536ee4bSTim Hardeck {
2137536ee4bSTim Hardeck     char *protocols = vncws_extract_handshake_entry((const char *)line, size,
2147536ee4bSTim Hardeck             "Sec-WebSocket-Protocol");
2157536ee4bSTim Hardeck     char *version = vncws_extract_handshake_entry((const char *)line, size,
2167536ee4bSTim Hardeck             "Sec-WebSocket-Version");
2177536ee4bSTim Hardeck     char *key = vncws_extract_handshake_entry((const char *)line, size,
2187536ee4bSTim Hardeck             "Sec-WebSocket-Key");
2197536ee4bSTim Hardeck 
2207536ee4bSTim Hardeck     if (protocols && version && key
2217536ee4bSTim Hardeck             && g_strrstr(protocols, "binary")
2227536ee4bSTim Hardeck             && !strcmp(version, WS_SUPPORTED_VERSION)
2237536ee4bSTim Hardeck             && strlen(key) == WS_CLIENT_KEY_LEN) {
2247536ee4bSTim Hardeck         vncws_send_handshake_response(vs, key);
2257536ee4bSTim Hardeck     } else {
2267536ee4bSTim Hardeck         VNC_DEBUG("Defective Websockets header or unsupported protocol\n");
2277536ee4bSTim Hardeck         vnc_client_error(vs);
2287536ee4bSTim Hardeck     }
2297536ee4bSTim Hardeck 
2307536ee4bSTim Hardeck     g_free(protocols);
2317536ee4bSTim Hardeck     g_free(version);
2327536ee4bSTim Hardeck     g_free(key);
2337536ee4bSTim Hardeck }
2347536ee4bSTim Hardeck 
2357536ee4bSTim Hardeck void vncws_encode_frame(Buffer *output, const void *payload,
2367536ee4bSTim Hardeck         const size_t payload_size)
2377536ee4bSTim Hardeck {
2387536ee4bSTim Hardeck     size_t header_size = 0;
2397536ee4bSTim Hardeck     unsigned char opcode = WS_OPCODE_BINARY_FRAME;
2407536ee4bSTim Hardeck     union {
2417536ee4bSTim Hardeck         char buf[WS_HEAD_MAX_LEN];
2427536ee4bSTim Hardeck         WsHeader ws;
2437536ee4bSTim Hardeck     } header;
2447536ee4bSTim Hardeck 
2457536ee4bSTim Hardeck     if (!payload_size) {
2467536ee4bSTim Hardeck         return;
2477536ee4bSTim Hardeck     }
2487536ee4bSTim Hardeck 
2497536ee4bSTim Hardeck     header.ws.b0 = 0x80 | (opcode & 0x0f);
2507536ee4bSTim Hardeck     if (payload_size <= 125) {
2517536ee4bSTim Hardeck         header.ws.b1 = (uint8_t)payload_size;
2527536ee4bSTim Hardeck         header_size = 2;
2537536ee4bSTim Hardeck     } else if (payload_size < 65536) {
2547536ee4bSTim Hardeck         header.ws.b1 = 0x7e;
2557536ee4bSTim Hardeck         header.ws.u.s16.l16 = cpu_to_be16((uint16_t)payload_size);
2567536ee4bSTim Hardeck         header_size = 4;
2577536ee4bSTim Hardeck     } else {
2587536ee4bSTim Hardeck         header.ws.b1 = 0x7f;
2597536ee4bSTim Hardeck         header.ws.u.s64.l64 = cpu_to_be64(payload_size);
2607536ee4bSTim Hardeck         header_size = 10;
2617536ee4bSTim Hardeck     }
2627536ee4bSTim Hardeck 
2637536ee4bSTim Hardeck     buffer_reserve(output, header_size + payload_size);
2647536ee4bSTim Hardeck     buffer_append(output, header.buf, header_size);
2657536ee4bSTim Hardeck     buffer_append(output, payload, payload_size);
2667536ee4bSTim Hardeck }
2677536ee4bSTim Hardeck 
2687536ee4bSTim Hardeck int vncws_decode_frame(Buffer *input, uint8_t **payload,
2697536ee4bSTim Hardeck                            size_t *payload_size, size_t *frame_size)
2707536ee4bSTim Hardeck {
2717536ee4bSTim Hardeck     unsigned char opcode = 0, fin = 0, has_mask = 0;
2727536ee4bSTim Hardeck     size_t header_size = 0;
2737536ee4bSTim Hardeck     uint32_t *payload32;
2747536ee4bSTim Hardeck     WsHeader *header = (WsHeader *)input->buffer;
2757536ee4bSTim Hardeck     WsMask mask;
2767536ee4bSTim Hardeck     int i;
2777536ee4bSTim Hardeck 
2787536ee4bSTim Hardeck     if (input->offset < WS_HEAD_MIN_LEN + 4) {
2797536ee4bSTim Hardeck         /* header not complete */
2807536ee4bSTim Hardeck         return 0;
2817536ee4bSTim Hardeck     }
2827536ee4bSTim Hardeck 
2837536ee4bSTim Hardeck     fin = (header->b0 & 0x80) >> 7;
2847536ee4bSTim Hardeck     opcode = header->b0 & 0x0f;
2857536ee4bSTim Hardeck     has_mask = (header->b1 & 0x80) >> 7;
2867536ee4bSTim Hardeck     *payload_size = header->b1 & 0x7f;
2877536ee4bSTim Hardeck 
2887536ee4bSTim Hardeck     if (opcode == WS_OPCODE_CLOSE) {
2897536ee4bSTim Hardeck         /* disconnect */
2907536ee4bSTim Hardeck         return -1;
2917536ee4bSTim Hardeck     }
2927536ee4bSTim Hardeck 
2937536ee4bSTim Hardeck     /* Websocket frame sanity check:
2947536ee4bSTim Hardeck      * * Websocket fragmentation is not supported.
2957536ee4bSTim Hardeck      * * All  websockets frames sent by a client have to be masked.
2967536ee4bSTim Hardeck      * * Only binary encoding is supported.
2977536ee4bSTim Hardeck      */
2987536ee4bSTim Hardeck     if (!fin || !has_mask || opcode != WS_OPCODE_BINARY_FRAME) {
2997536ee4bSTim Hardeck         VNC_DEBUG("Received faulty/unsupported Websocket frame\n");
3007536ee4bSTim Hardeck         return -2;
3017536ee4bSTim Hardeck     }
3027536ee4bSTim Hardeck 
3037536ee4bSTim Hardeck     if (*payload_size < 126) {
3047536ee4bSTim Hardeck         header_size = 6;
3057536ee4bSTim Hardeck         mask = header->u.m;
3067536ee4bSTim Hardeck     } else if (*payload_size == 126 && input->offset >= 8) {
3077536ee4bSTim Hardeck         *payload_size = be16_to_cpu(header->u.s16.l16);
3087536ee4bSTim Hardeck         header_size = 8;
3097536ee4bSTim Hardeck         mask = header->u.s16.m16;
3107536ee4bSTim Hardeck     } else if (*payload_size == 127 && input->offset >= 14) {
3117536ee4bSTim Hardeck         *payload_size = be64_to_cpu(header->u.s64.l64);
3127536ee4bSTim Hardeck         header_size = 14;
3137536ee4bSTim Hardeck         mask = header->u.s64.m64;
3147536ee4bSTim Hardeck     } else {
3157536ee4bSTim Hardeck         /* header not complete */
3167536ee4bSTim Hardeck         return 0;
3177536ee4bSTim Hardeck     }
3187536ee4bSTim Hardeck 
3197536ee4bSTim Hardeck     *frame_size = header_size + *payload_size;
3207536ee4bSTim Hardeck 
3217536ee4bSTim Hardeck     if (input->offset < *frame_size) {
3227536ee4bSTim Hardeck         /* frame not complete */
3237536ee4bSTim Hardeck         return 0;
3247536ee4bSTim Hardeck     }
3257536ee4bSTim Hardeck 
3267536ee4bSTim Hardeck     *payload = input->buffer + header_size;
3277536ee4bSTim Hardeck 
3287536ee4bSTim Hardeck     /* unmask frame */
3297536ee4bSTim Hardeck     /* process 1 frame (32 bit op) */
3307536ee4bSTim Hardeck     payload32 = (uint32_t *)(*payload);
3317536ee4bSTim Hardeck     for (i = 0; i < *payload_size / 4; i++) {
3327536ee4bSTim Hardeck         payload32[i] ^= mask.u;
3337536ee4bSTim Hardeck     }
3347536ee4bSTim Hardeck     /* process the remaining bytes (if any) */
3357536ee4bSTim Hardeck     for (i *= 4; i < *payload_size; i++) {
3367536ee4bSTim Hardeck         (*payload)[i] ^= mask.c[i % 4];
3377536ee4bSTim Hardeck     }
3387536ee4bSTim Hardeck 
3397536ee4bSTim Hardeck     return 1;
3407536ee4bSTim Hardeck }
341