#include #include #include #include #include #include #include "wg-obfuscator.h" #include "masking.h" #include "masking_stun.h" // Bytes prepended in front of the payload when wrapping data in a STUN Data Indication // (20-byte STUN header + 4-byte attribute header). Must fit into PREBUFFER_SIZE so that // wrapping can be done by shifting the buffer pointer instead of moving the payload. #define STUN_WRAP_OVERHEAD 24 _Static_assert(STUN_WRAP_OVERHEAD <= PREBUFFER_SIZE, "PREBUFFER_SIZE is too small to hold the STUN wrap header"); static void rand_bytes(uint8_t* p, size_t n){ for(size_t i=0;i> 8; b[1] = type & 0xFF; b[2] = mlen >> 8; b[3] = mlen & 0xFF; memcpy(b + 4, COOKIE_BE, 4); memcpy(b + 8, txid, 12); return 20; } static int stun_attr_xor_mapped_addr(uint8_t *b, const struct sockaddr_in *src) { // type,len b[0] = STUN_ATTR_XORMAPPED >> 8; b[1] = STUN_ATTR_XORMAPPED & 0xFF; b[2] = 0; b[3] = 8; // len=8 (family + port + addr) b[4] = 0; b[5] = 0x01; // family IPv4 memcpy(b + 6, &src->sin_port, 2); // network-order bytes ((uint8_t*)b)[6] ^= COOKIE_BE[0]; ((uint8_t*)b)[7] ^= COOKIE_BE[1]; memcpy(b + 8, &src->sin_addr.s_addr, 4); // network-order bytes ((uint8_t*)b)[8] ^= COOKIE_BE[0]; ((uint8_t*)b)[9] ^= COOKIE_BE[1]; ((uint8_t*)b)[10] ^= COOKIE_BE[2]; ((uint8_t*)b)[11] ^= COOKIE_BE[3]; return 12; // 4 hdr + 8 val } /* static int stun_attr_software(uint8_t *b, const char *s) { uint16_t n = (uint16_t)strlen(s); uint16_t pad = (4 - (n & 3)) & 3; if (b) { b[0] = STUN_ATTR_SOFTWARE >> 8; b[1] = STUN_ATTR_SOFTWARE&0xFF; b[2] = n>>8; b[3] = n&0xFF; memcpy(b+4,s,n); if (pad) memset(b+4+n,0,pad); } return 4 + n + pad; } */ static uint32_t crc32(const uint8_t *p, size_t n) { uint32_t crc = ~0u; for(size_t i = 0; i < n; i++){ crc ^= p[i]; for(int k = 0; k < 8; k++) crc = (crc >> 1) ^ (0xEDB88320u & (-(int)(crc & 1))); } return ~crc; } static int stun_attr_fingerprint(uint8_t *pkt, size_t cur_len) { uint8_t *b = pkt + cur_len; b[0] = STUN_ATTR_FINGERPR >> 8; b[1] = STUN_ATTR_FINGERPR & 0xFF; b[2] = 0; b[3] = 4; uint32_t fp = htonl(crc32(pkt, cur_len) ^ 0x5354554eu); memcpy(b + 4, &fp, 4); return 8; // 4 hdr + 4 val } static int stun_build_binding_request(uint8_t *out) { uint8_t txid[12]; rand_bytes(txid, 12); stun_write_header(out, STUN_BINDING_REQ, 0, txid); size_t mlen = 0; // optional SOFTWARE //mlen += stun_attr_software(out+20+mlen, "wgo/1.0"); mlen += stun_attr_fingerprint(out, 20 + mlen); out[2] = (mlen >> 8) & 0xFF; out[3] = mlen & 0xFF; return (int)(20 + mlen); } static int stun_build_binding_success(uint8_t *out, const uint8_t txid[12], const struct sockaddr_in *src) { if (BUFFER_SIZE < 20 + 12 + 8) return -1; // header + XOR-MAPPED-ADDRESS + fingerprint stun_write_header(out, STUN_BINDING_RESP, 0, (uint8_t*)txid); size_t mlen = 0; mlen += stun_attr_xor_mapped_addr(out + 20 + mlen, src); // optional SOFTWARE //mlen += stun_attr_software(out+20+mlen, "wgo/1.0"); mlen += stun_attr_fingerprint(out, 20 + mlen); out[2] = (mlen >> 8) & 0xFF; out[3] = mlen & 0xFF; return (int)(20 + mlen); } static int stun_wrap(uint8_t **buf_ptr, size_t data_len) { size_t mlen = 0; // The caller guarantees the payload already fits into the main buffer (it was // received/encoded within BUFFER_SIZE), so the wrapped packet cannot overflow // the tail of full_buffer. The attribute length field is also 16-bit only. // Note: BUFFER_SIZE (65535) equals the maximum value of a 16-bit unsigned // integer (0xFFFF), so this single check covers both the buffer limit and // the STUN attribute length field limit. if (data_len > BUFFER_SIZE) { log(LL_WARN, "Can't wrap data in STUN, data too large (%zu bytes)", data_len); return -ENOMEM; } // Header is prepended into the prebuffer (checked at compile time via _Static_assert). *buf_ptr -= STUN_WRAP_OVERHEAD; uint8_t *buf = *buf_ptr; uint8_t txid[12]; rand_bytes(txid,12); mlen += stun_write_header(buf, STUN_TYPE_DATA_IND, 0, txid); buf[mlen] = STUN_ATTR_DATA >> 8; buf[mlen + 1] = STUN_ATTR_DATA & 0xFF; buf[mlen + 2] = data_len >> 8; buf[mlen + 3] = data_len & 0xFF; return STUN_WRAP_OVERHEAD + data_len; } static int stun_unwrap(uint8_t **buf_ptr, size_t len) { uint8_t *buf = *buf_ptr; if (len < 20 + 4) return -1; // header + attr uint16_t msg_type = (buf[0] << 8) | buf[1]; if (msg_type != STUN_TYPE_DATA_IND) return -1; uint16_t msg_len = (buf[2] << 8) | buf[3]; if (msg_len + 20 > len) return -1; uint16_t attr_type = (buf[20] << 8) | buf[21]; if (attr_type != STUN_ATTR_DATA) return -1; uint16_t data_len = (buf[22] << 8) | buf[23]; if (data_len + 24 > len) return -1; // Move the buffer pointer to avoid moving the data *buf_ptr += 24; return data_len; } static void stun_on_handshake_req(obfuscator_config_t *config, client_entry_t *client, direction_t direction, const struct sockaddr_in *src_addr, const struct sockaddr_in *dest_addr, send_data_callback_t send_back_callback, send_data_callback_t send_forward_callback) { uint8_t buffer[128]; int len = stun_build_binding_request(buffer); if (len < 0) return; int sent = send_forward_callback(buffer, len); if (sent < 0) { serror("Can't send STUN binding request to %s:%d", inet_ntoa(dest_addr->sin_addr), ntohs(dest_addr->sin_port)); } else if (sent != len) { log(LL_WARN, "Partial send of STUN binding request to %s:%d (%d of %d bytes)", inet_ntoa(dest_addr->sin_addr), ntohs(dest_addr->sin_port), sent, len); } else { log(LL_TRACE, "Sent STUN binding request (%d bytes) to %s:%d", len, inet_ntoa(dest_addr->sin_addr), ntohs(dest_addr->sin_port)); } } static int stun_on_data_unwrap(uint8_t **buffer_ptr, int length, obfuscator_config_t *config, client_entry_t *client, direction_t direction, const struct sockaddr_in *src_addr, const struct sockaddr_in *dest_addr, send_data_callback_t send_back_callback, send_data_callback_t send_forward_callback) { if (!stun_check_magic(*buffer_ptr, length)) { return -EINVAL; } uint16_t stun_type = stun_peek_type(*buffer_ptr); switch (stun_type) { case STUN_BINDING_REQ: { // Received STUN Binding Request from client, send Binding Success Response log(LL_TRACE, "Received STUN Binding Request from %s:%d", inet_ntoa(src_addr->sin_addr), ntohs(src_addr->sin_port)); uint8_t txid[12]; memcpy(txid, (*buffer_ptr) + 8, 12); int resp_len = stun_build_binding_success(*buffer_ptr, txid, src_addr); if (resp_len > 0) { int sent = send_back_callback(*buffer_ptr, resp_len); if (sent < 0) { serror("sendto STUN response to %s:%d", inet_ntoa(src_addr->sin_addr), ntohs(src_addr->sin_port)); } else if (sent != resp_len) { log(LL_WARN, "Partial send of STUN Binding Success Response to %s:%d (%d of %d bytes)", inet_ntoa(src_addr->sin_addr), ntohs(src_addr->sin_port), sent, resp_len); } else { log(LL_TRACE, "Sent STUN Binding Success Response (%d bytes) to %s:%d", resp_len, inet_ntoa(src_addr->sin_addr), ntohs(src_addr->sin_port)); } } else { log(LL_ERROR, "Failed to build STUN Binding Success Response"); } return 0; } case STUN_BINDING_RESP: log(LL_TRACE, "Received STUN Binding Success Response from %s:%d, ignoring", inet_ntoa(src_addr->sin_addr), ntohs(src_addr->sin_port)); return 0; case STUN_TYPE_DATA_IND: length = stun_unwrap(buffer_ptr, length); if (length < 0) { log(LL_DEBUG, "Failed to unwrap STUN Data Indication from %s:%d", inet_ntoa(src_addr->sin_addr), ntohs(src_addr->sin_port)); return length; } log(LL_TRACE, "Unwrapped STUN Data Indication from %s:%d (%d bytes)", inet_ntoa(src_addr->sin_addr), ntohs(src_addr->sin_port), length); return length; default: log(LL_DEBUG, "Received unknown STUN type %04X from %s:%d, ignoring", stun_type, inet_ntoa(src_addr->sin_addr), ntohs(src_addr->sin_port)); return 0; } } static int stun_on_data_wrap(uint8_t **buffer_ptr, int length, obfuscator_config_t *config, client_entry_t *client, direction_t direction, const struct sockaddr_in *src_addr, const struct sockaddr_in *dest_addr, send_data_callback_t send_back_callback, send_data_callback_t send_forward_callback) { return stun_wrap(buffer_ptr, length); } static void stun_on_timer(obfuscator_config_t *config, client_entry_t *client, const struct sockaddr_in *client_addr, const struct sockaddr_in *server_addr, send_data_callback_t send_to_client_callback, send_data_callback_t send_to_server_callback) { uint8_t buffer[128]; int len = stun_build_binding_request(buffer); if (len < 0) return; if (client->client_obfuscated) { int sent = send_to_client_callback(buffer, len); if (sent < 0) { serror("STUN binding request to client"); } else if (sent != len) { log(LL_WARN, "Partial send of STUN binding request to client (%d of %d bytes)", sent, len); } else { log(LL_TRACE, "Sent STUN binding request (%d bytes) to %s:%d", len, inet_ntoa(client_addr->sin_addr), ntohs(client_addr->sin_port)); } } if (client->server_obfuscated) { int sent = send_to_server_callback(buffer, len); if (sent < 0) { serror("STUN binding request to server"); } else if (sent != len) { log(LL_WARN, "Partial send of STUN binding request to server (%d of %d bytes)", sent, len); } else { log(LL_TRACE, "Sent STUN binding request (%d bytes) to %s:%d", len, inet_ntoa(server_addr->sin_addr), ntohs(server_addr->sin_port)); } } } masking_handler_t stun_masking_handler = { .name = "STUN", .on_handshake_req = stun_on_handshake_req, .on_data_wrap = stun_on_data_wrap, .on_data_unwrap = stun_on_data_unwrap, .on_timer = stun_on_timer, .timer_interval_s = 10, // 10 seconds };