protocol.go 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577
  1. /*
  2. * Copyright (c) 2016, Psiphon Inc.
  3. * All rights reserved.
  4. *
  5. * This program is free software: you can redistribute it and/or modify
  6. * it under the terms of the GNU General Public License as published by
  7. * the Free Software Foundation, either version 3 of the License, or
  8. * (at your option) any later version.
  9. *
  10. * This program is distributed in the hope that it will be useful,
  11. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13. * GNU General Public License for more details.
  14. *
  15. * You should have received a copy of the GNU General Public License
  16. * along with this program. If not, see <http://www.gnu.org/licenses/>.
  17. *
  18. */
  19. package protocol
  20. import (
  21. "crypto/sha256"
  22. "encoding/json"
  23. "github.com/Psiphon-Labs/psiphon-tunnel-core/psiphon/common"
  24. "github.com/Psiphon-Labs/psiphon-tunnel-core/psiphon/common/errors"
  25. "github.com/Psiphon-Labs/psiphon-tunnel-core/psiphon/common/osl"
  26. "github.com/Psiphon-Labs/psiphon-tunnel-core/psiphon/common/prng"
  27. )
  28. const (
  29. TUNNEL_PROTOCOL_SSH = "SSH"
  30. TUNNEL_PROTOCOL_OBFUSCATED_SSH = "OSSH"
  31. TUNNEL_PROTOCOL_UNFRONTED_MEEK = "UNFRONTED-MEEK-OSSH"
  32. TUNNEL_PROTOCOL_UNFRONTED_MEEK_HTTPS = "UNFRONTED-MEEK-HTTPS-OSSH"
  33. TUNNEL_PROTOCOL_UNFRONTED_MEEK_SESSION_TICKET = "UNFRONTED-MEEK-SESSION-TICKET-OSSH"
  34. TUNNEL_PROTOCOL_FRONTED_MEEK = "FRONTED-MEEK-OSSH"
  35. TUNNEL_PROTOCOL_FRONTED_MEEK_HTTP = "FRONTED-MEEK-HTTP-OSSH"
  36. TUNNEL_PROTOCOL_QUIC_OBFUSCATED_SSH = "QUIC-OSSH"
  37. TUNNEL_PROTOCOL_FRONTED_MEEK_QUIC_OBFUSCATED_SSH = "FRONTED-MEEK-QUIC-OSSH"
  38. TUNNEL_PROTOCOL_TAPDANCE_OBFUSCATED_SSH = "TAPDANCE-OSSH"
  39. TUNNEL_PROTOCOL_CONJURE_OBFUSCATED_SSH = "CONJURE-OSSH"
  40. TUNNEL_PROTOCOLS_ALL = "All"
  41. SERVER_ENTRY_SOURCE_EMBEDDED = "EMBEDDED"
  42. SERVER_ENTRY_SOURCE_REMOTE = "REMOTE"
  43. SERVER_ENTRY_SOURCE_DISCOVERY = "DISCOVERY"
  44. SERVER_ENTRY_SOURCE_TARGET = "TARGET"
  45. SERVER_ENTRY_SOURCE_OBFUSCATED = "OBFUSCATED"
  46. SERVER_ENTRY_SOURCE_EXCHANGED = "EXCHANGED"
  47. CAPABILITY_SSH_API_REQUESTS = "ssh-api-requests"
  48. CAPABILITY_UNTUNNELED_WEB_API_REQUESTS = "handshake"
  49. CLIENT_CAPABILITY_SERVER_REQUESTS = "server-requests"
  50. PSIPHON_API_HANDSHAKE_REQUEST_NAME = "psiphon-handshake"
  51. PSIPHON_API_CONNECTED_REQUEST_NAME = "psiphon-connected"
  52. PSIPHON_API_STATUS_REQUEST_NAME = "psiphon-status"
  53. PSIPHON_API_OSL_REQUEST_NAME = "psiphon-osl"
  54. PSIPHON_API_ALERT_REQUEST_NAME = "psiphon-alert"
  55. PSIPHON_API_ALERT_DISALLOWED_TRAFFIC = "disallowed-traffic"
  56. PSIPHON_API_ALERT_UNSAFE_TRAFFIC = "unsafe-traffic"
  57. // PSIPHON_API_CLIENT_VERIFICATION_REQUEST_NAME may still be used by older Android clients
  58. PSIPHON_API_CLIENT_VERIFICATION_REQUEST_NAME = "psiphon-client-verification"
  59. PSIPHON_API_CLIENT_SESSION_ID_LENGTH = 16
  60. PSIPHON_SSH_API_PROTOCOL = "ssh"
  61. PSIPHON_WEB_API_PROTOCOL = "web"
  62. PACKET_TUNNEL_CHANNEL_TYPE = "tun@psiphon.ca"
  63. RANDOM_STREAM_CHANNEL_TYPE = "random@psiphon.ca"
  64. TCP_PORT_FORWARD_NO_SPLIT_TUNNEL_TYPE = "direct-tcpip-no-split-tunnel@psiphon.ca"
  65. // Reject reason codes are returned in SSH open channel responses.
  66. //
  67. // Values 0xFE000000 to 0xFFFFFFFF are reserved for "PRIVATE USE" (see
  68. // https://tools.ietf.org/rfc/rfc4254.html#section-5.1).
  69. CHANNEL_REJECT_REASON_SPLIT_TUNNEL = 0xFE000000
  70. PSIPHON_API_HANDSHAKE_AUTHORIZATIONS = "authorizations"
  71. CONJURE_TRANSPORT_MIN_OSSH = "Min-OSSH"
  72. CONJURE_TRANSPORT_OBFS4_OSSH = "Obfs4-OSSH"
  73. )
  74. var SupportedServerEntrySources = []string{
  75. SERVER_ENTRY_SOURCE_EMBEDDED,
  76. SERVER_ENTRY_SOURCE_REMOTE,
  77. SERVER_ENTRY_SOURCE_DISCOVERY,
  78. SERVER_ENTRY_SOURCE_TARGET,
  79. SERVER_ENTRY_SOURCE_OBFUSCATED,
  80. SERVER_ENTRY_SOURCE_EXCHANGED,
  81. }
  82. func AllowServerEntrySourceWithUpstreamProxy(source string) bool {
  83. return source == SERVER_ENTRY_SOURCE_EMBEDDED ||
  84. source == SERVER_ENTRY_SOURCE_REMOTE
  85. }
  86. type TunnelProtocols []string
  87. func (t TunnelProtocols) Validate() error {
  88. for _, p := range t {
  89. if !common.Contains(SupportedTunnelProtocols, p) {
  90. return errors.Tracef("invalid tunnel protocol: %s", p)
  91. }
  92. }
  93. return nil
  94. }
  95. func (t TunnelProtocols) PruneInvalid() TunnelProtocols {
  96. u := make(TunnelProtocols, 0)
  97. for _, p := range t {
  98. if common.Contains(SupportedTunnelProtocols, p) {
  99. u = append(u, p)
  100. }
  101. }
  102. return u
  103. }
  104. type LabeledTunnelProtocols map[string]TunnelProtocols
  105. func (labeledProtocols LabeledTunnelProtocols) Validate() error {
  106. for _, protocols := range labeledProtocols {
  107. err := protocols.Validate()
  108. if err != nil {
  109. return errors.Trace(err)
  110. }
  111. }
  112. return nil
  113. }
  114. func (labeledProtocols LabeledTunnelProtocols) PruneInvalid() LabeledTunnelProtocols {
  115. l := make(LabeledTunnelProtocols)
  116. for label, protocols := range labeledProtocols {
  117. l[label] = protocols.PruneInvalid()
  118. }
  119. return l
  120. }
  121. var SupportedTunnelProtocols = TunnelProtocols{
  122. TUNNEL_PROTOCOL_SSH,
  123. TUNNEL_PROTOCOL_OBFUSCATED_SSH,
  124. TUNNEL_PROTOCOL_UNFRONTED_MEEK,
  125. TUNNEL_PROTOCOL_UNFRONTED_MEEK_HTTPS,
  126. TUNNEL_PROTOCOL_UNFRONTED_MEEK_SESSION_TICKET,
  127. TUNNEL_PROTOCOL_FRONTED_MEEK,
  128. TUNNEL_PROTOCOL_FRONTED_MEEK_HTTP,
  129. TUNNEL_PROTOCOL_QUIC_OBFUSCATED_SSH,
  130. TUNNEL_PROTOCOL_FRONTED_MEEK_QUIC_OBFUSCATED_SSH,
  131. TUNNEL_PROTOCOL_TAPDANCE_OBFUSCATED_SSH,
  132. TUNNEL_PROTOCOL_CONJURE_OBFUSCATED_SSH,
  133. }
  134. var DefaultDisabledTunnelProtocols = TunnelProtocols{
  135. TUNNEL_PROTOCOL_FRONTED_MEEK_QUIC_OBFUSCATED_SSH,
  136. TUNNEL_PROTOCOL_TAPDANCE_OBFUSCATED_SSH,
  137. TUNNEL_PROTOCOL_CONJURE_OBFUSCATED_SSH,
  138. }
  139. func TunnelProtocolUsesTCP(protocol string) bool {
  140. return protocol != TUNNEL_PROTOCOL_QUIC_OBFUSCATED_SSH &&
  141. protocol != TUNNEL_PROTOCOL_FRONTED_MEEK_QUIC_OBFUSCATED_SSH
  142. }
  143. func TunnelProtocolUsesSSH(protocol string) bool {
  144. return true
  145. }
  146. func TunnelProtocolUsesObfuscatedSSH(protocol string) bool {
  147. return protocol != TUNNEL_PROTOCOL_SSH
  148. }
  149. func TunnelProtocolUsesMeek(protocol string) bool {
  150. return TunnelProtocolUsesMeekHTTP(protocol) ||
  151. TunnelProtocolUsesMeekHTTPS(protocol) ||
  152. TunnelProtocolUsesFrontedMeekQUIC(protocol)
  153. }
  154. func TunnelProtocolUsesFrontedMeek(protocol string) bool {
  155. return protocol == TUNNEL_PROTOCOL_FRONTED_MEEK ||
  156. protocol == TUNNEL_PROTOCOL_FRONTED_MEEK_HTTP ||
  157. protocol == TUNNEL_PROTOCOL_FRONTED_MEEK_QUIC_OBFUSCATED_SSH
  158. }
  159. func TunnelProtocolUsesMeekHTTP(protocol string) bool {
  160. return protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK ||
  161. protocol == TUNNEL_PROTOCOL_FRONTED_MEEK_HTTP
  162. }
  163. func TunnelProtocolUsesMeekHTTPNormalizer(protocol string) bool {
  164. return protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK
  165. }
  166. func TunnelProtocolUsesMeekHTTPS(protocol string) bool {
  167. return protocol == TUNNEL_PROTOCOL_FRONTED_MEEK ||
  168. protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK_HTTPS ||
  169. protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK_SESSION_TICKET
  170. }
  171. func TunnelProtocolUsesObfuscatedSessionTickets(protocol string) bool {
  172. return protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK_SESSION_TICKET
  173. }
  174. func TunnelProtocolUsesQUIC(protocol string) bool {
  175. return protocol == TUNNEL_PROTOCOL_QUIC_OBFUSCATED_SSH ||
  176. protocol == TUNNEL_PROTOCOL_FRONTED_MEEK_QUIC_OBFUSCATED_SSH
  177. }
  178. func TunnelProtocolUsesFrontedMeekQUIC(protocol string) bool {
  179. return protocol == TUNNEL_PROTOCOL_FRONTED_MEEK_QUIC_OBFUSCATED_SSH
  180. }
  181. func TunnelProtocolUsesRefractionNetworking(protocol string) bool {
  182. return protocol == TUNNEL_PROTOCOL_TAPDANCE_OBFUSCATED_SSH ||
  183. protocol == TUNNEL_PROTOCOL_CONJURE_OBFUSCATED_SSH
  184. }
  185. func TunnelProtocolUsesTapDance(protocol string) bool {
  186. return protocol == TUNNEL_PROTOCOL_TAPDANCE_OBFUSCATED_SSH
  187. }
  188. func TunnelProtocolUsesConjure(protocol string) bool {
  189. return protocol == TUNNEL_PROTOCOL_CONJURE_OBFUSCATED_SSH
  190. }
  191. func TunnelProtocolIsResourceIntensive(protocol string) bool {
  192. return TunnelProtocolUsesMeek(protocol) ||
  193. TunnelProtocolUsesQUIC(protocol) ||
  194. TunnelProtocolUsesRefractionNetworking(protocol)
  195. }
  196. func TunnelProtocolIsCompatibleWithFragmentor(protocol string) bool {
  197. return protocol == TUNNEL_PROTOCOL_SSH ||
  198. protocol == TUNNEL_PROTOCOL_OBFUSCATED_SSH ||
  199. protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK ||
  200. protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK_HTTPS ||
  201. protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK_SESSION_TICKET ||
  202. protocol == TUNNEL_PROTOCOL_FRONTED_MEEK ||
  203. protocol == TUNNEL_PROTOCOL_FRONTED_MEEK_HTTP ||
  204. protocol == TUNNEL_PROTOCOL_CONJURE_OBFUSCATED_SSH
  205. }
  206. func TunnelProtocolRequiresTLS12SessionTickets(protocol string) bool {
  207. return protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK_SESSION_TICKET
  208. }
  209. func TunnelProtocolSupportsPassthrough(protocol string) bool {
  210. return protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK_HTTPS ||
  211. protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK_SESSION_TICKET ||
  212. protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK
  213. }
  214. func TunnelProtocolSupportsUpstreamProxy(protocol string) bool {
  215. return !TunnelProtocolUsesQUIC(protocol)
  216. }
  217. func TunnelProtocolMayUseServerPacketManipulation(protocol string) bool {
  218. return protocol == TUNNEL_PROTOCOL_SSH ||
  219. protocol == TUNNEL_PROTOCOL_OBFUSCATED_SSH ||
  220. protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK ||
  221. protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK_HTTPS ||
  222. protocol == TUNNEL_PROTOCOL_UNFRONTED_MEEK_SESSION_TICKET
  223. }
  224. func IsValidClientTunnelProtocol(
  225. clientProtocol string,
  226. listenerProtocol string,
  227. serverProtocols TunnelProtocols) bool {
  228. if !common.Contains(serverProtocols, clientProtocol) {
  229. return false
  230. }
  231. // If the client reports the same tunnel protocol as the listener, the value
  232. // is valid.
  233. if clientProtocol == listenerProtocol {
  234. return true
  235. }
  236. // When the server is running multiple fronted protocols, and the client
  237. // reports a fronted protocol, the client's reported tunnel protocol is
  238. // presumed to be valid since some CDNs forward several protocols to the same
  239. // server port; in this case the listener port is not sufficient to
  240. // distinguish these protocols.
  241. if !TunnelProtocolUsesFrontedMeek(clientProtocol) {
  242. return false
  243. }
  244. frontedProtocolCount := 0
  245. for _, protocol := range serverProtocols {
  246. if TunnelProtocolUsesFrontedMeek(protocol) {
  247. frontedProtocolCount += 1
  248. if frontedProtocolCount > 1 {
  249. return true
  250. }
  251. }
  252. }
  253. return false
  254. }
  255. const (
  256. TLS_VERSION_12 = "TLSv1.2"
  257. TLS_VERSION_13 = "TLSv1.3"
  258. TLS_PROFILE_IOS_111 = "iOS-11.1"
  259. TLS_PROFILE_IOS_121 = "iOS-12.1"
  260. TLS_PROFILE_IOS_13 = "iOS-13"
  261. TLS_PROFILE_IOS_14 = "iOS-14"
  262. TLS_PROFILE_CHROME_58 = "Chrome-58"
  263. TLS_PROFILE_CHROME_62 = "Chrome-62"
  264. TLS_PROFILE_CHROME_70 = "Chrome-70"
  265. TLS_PROFILE_CHROME_72 = "Chrome-72"
  266. TLS_PROFILE_CHROME_83 = "Chrome-83"
  267. TLS_PROFILE_CHROME_96 = "Chrome-96"
  268. TLS_PROFILE_CHROME_102 = "Chrome-102"
  269. TLS_PROFILE_FIREFOX_55 = "Firefox-55"
  270. TLS_PROFILE_FIREFOX_56 = "Firefox-56"
  271. TLS_PROFILE_FIREFOX_65 = "Firefox-65"
  272. TLS_PROFILE_FIREFOX_99 = "Firefox-99"
  273. TLS_PROFILE_FIREFOX_105 = "Firefox-105"
  274. TLS_PROFILE_RANDOMIZED = "Randomized-v2"
  275. )
  276. var SupportedTLSProfiles = TLSProfiles{
  277. TLS_PROFILE_IOS_111,
  278. TLS_PROFILE_IOS_121,
  279. TLS_PROFILE_IOS_13,
  280. TLS_PROFILE_IOS_14,
  281. TLS_PROFILE_CHROME_58,
  282. TLS_PROFILE_CHROME_62,
  283. TLS_PROFILE_CHROME_70,
  284. TLS_PROFILE_CHROME_72,
  285. TLS_PROFILE_CHROME_83,
  286. TLS_PROFILE_CHROME_96,
  287. TLS_PROFILE_CHROME_102,
  288. TLS_PROFILE_FIREFOX_55,
  289. TLS_PROFILE_FIREFOX_56,
  290. TLS_PROFILE_FIREFOX_65,
  291. TLS_PROFILE_FIREFOX_99,
  292. TLS_PROFILE_FIREFOX_105,
  293. TLS_PROFILE_RANDOMIZED,
  294. }
  295. var legacyTLSProfiles = TLSProfiles{
  296. "iOS-Safari-11.3.1",
  297. "Android-6.0",
  298. "Android-5.1",
  299. "Chrome-57",
  300. "Randomized",
  301. "TLS-1.3-Randomized",
  302. "Firefox-102",
  303. }
  304. func TLSProfileIsRandomized(tlsProfile string) bool {
  305. return tlsProfile == TLS_PROFILE_RANDOMIZED
  306. }
  307. func TLS12ProfileOmitsSessionTickets(tlsProfile string) bool {
  308. if tlsProfile == TLS_PROFILE_IOS_111 ||
  309. tlsProfile == TLS_PROFILE_IOS_121 {
  310. return true
  311. }
  312. return false
  313. }
  314. type TLSProfiles []string
  315. func (profiles TLSProfiles) Validate(customTLSProfiles []string) error {
  316. for _, p := range profiles {
  317. if !common.Contains(SupportedTLSProfiles, p) &&
  318. !common.Contains(customTLSProfiles, p) &&
  319. !common.Contains(legacyTLSProfiles, p) {
  320. return errors.Tracef("invalid TLS profile: %s", p)
  321. }
  322. }
  323. return nil
  324. }
  325. func (profiles TLSProfiles) PruneInvalid(customTLSProfiles []string) TLSProfiles {
  326. q := make(TLSProfiles, 0)
  327. for _, p := range profiles {
  328. if common.Contains(SupportedTLSProfiles, p) ||
  329. common.Contains(customTLSProfiles, p) {
  330. q = append(q, p)
  331. }
  332. }
  333. return q
  334. }
  335. type LabeledTLSProfiles map[string]TLSProfiles
  336. func (labeledProfiles LabeledTLSProfiles) Validate(customTLSProfiles []string) error {
  337. for _, profiles := range labeledProfiles {
  338. err := profiles.Validate(customTLSProfiles)
  339. if err != nil {
  340. return errors.Trace(err)
  341. }
  342. }
  343. return nil
  344. }
  345. func (labeledProfiles LabeledTLSProfiles) PruneInvalid(customTLSProfiles []string) LabeledTLSProfiles {
  346. l := make(LabeledTLSProfiles)
  347. for label, profiles := range labeledProfiles {
  348. l[label] = profiles.PruneInvalid(customTLSProfiles)
  349. }
  350. return l
  351. }
  352. const (
  353. QUIC_VERSION_GQUIC39 = "gQUICv39"
  354. QUIC_VERSION_GQUIC43 = "gQUICv43"
  355. QUIC_VERSION_GQUIC44 = "gQUICv44"
  356. QUIC_VERSION_OBFUSCATED = "OBFUSCATED"
  357. QUIC_VERSION_V1 = "QUICv1"
  358. QUIC_VERSION_RANDOMIZED_V1 = "RANDOMIZED-QUICv1"
  359. QUIC_VERSION_OBFUSCATED_V1 = "OBFUSCATED-QUICv1"
  360. QUIC_VERSION_DECOY_V1 = "DECOY-QUICv1"
  361. )
  362. // The value of SupportedQUICVersions is conditionally compiled based on
  363. // whether gQUIC is enabled. SupportedQUICv1Versions are the supported QUIC
  364. // versions that are based on QUICv1.
  365. var SupportedQUICv1Versions = QUICVersions{
  366. QUIC_VERSION_V1,
  367. QUIC_VERSION_RANDOMIZED_V1,
  368. QUIC_VERSION_OBFUSCATED_V1,
  369. QUIC_VERSION_DECOY_V1,
  370. }
  371. var legacyQUICVersions = QUICVersions{
  372. "IETF-draft-24",
  373. }
  374. func QUICVersionHasRandomizedClientHello(version string) bool {
  375. return version == QUIC_VERSION_RANDOMIZED_V1
  376. }
  377. func QUICVersionIsObfuscated(version string) bool {
  378. return version == QUIC_VERSION_OBFUSCATED ||
  379. version == QUIC_VERSION_OBFUSCATED_V1 ||
  380. version == QUIC_VERSION_DECOY_V1
  381. }
  382. func QUICVersionUsesPathMTUDiscovery(version string) bool {
  383. return version != QUIC_VERSION_GQUIC39 &&
  384. version != QUIC_VERSION_GQUIC43 &&
  385. version != QUIC_VERSION_GQUIC44 &&
  386. version != QUIC_VERSION_OBFUSCATED
  387. }
  388. type QUICVersions []string
  389. func (versions QUICVersions) Validate() error {
  390. for _, v := range versions {
  391. if !common.Contains(SupportedQUICVersions, v) &&
  392. !common.Contains(legacyQUICVersions, v) {
  393. return errors.Tracef("invalid QUIC version: %s", v)
  394. }
  395. }
  396. return nil
  397. }
  398. func (versions QUICVersions) PruneInvalid() QUICVersions {
  399. u := make(QUICVersions, 0)
  400. for _, v := range versions {
  401. if common.Contains(SupportedQUICVersions, v) {
  402. u = append(u, v)
  403. }
  404. }
  405. return u
  406. }
  407. type LabeledQUICVersions map[string]QUICVersions
  408. func (labeledVersions LabeledQUICVersions) Validate() error {
  409. for _, versions := range labeledVersions {
  410. err := versions.Validate()
  411. if err != nil {
  412. return errors.Trace(err)
  413. }
  414. }
  415. return nil
  416. }
  417. func (labeledVersions LabeledQUICVersions) PruneInvalid() LabeledQUICVersions {
  418. l := make(LabeledQUICVersions)
  419. for label, versions := range labeledVersions {
  420. l[label] = versions.PruneInvalid()
  421. }
  422. return l
  423. }
  424. type HandshakeResponse struct {
  425. SSHSessionID string `json:"ssh_session_id"`
  426. Homepages []string `json:"homepages"`
  427. UpgradeClientVersion string `json:"upgrade_client_version"`
  428. PageViewRegexes []map[string]string `json:"page_view_regexes"`
  429. HttpsRequestRegexes []map[string]string `json:"https_request_regexes"`
  430. EncodedServerList []string `json:"encoded_server_list"`
  431. ClientRegion string `json:"client_region"`
  432. ClientAddress string `json:"client_address"`
  433. ServerTimestamp string `json:"server_timestamp"`
  434. ActiveAuthorizationIDs []string `json:"active_authorization_ids"`
  435. TacticsPayload json.RawMessage `json:"tactics_payload"`
  436. UpstreamBytesPerSecond int64 `json:"upstream_bytes_per_second"`
  437. DownstreamBytesPerSecond int64 `json:"downstream_bytes_per_second"`
  438. Padding string `json:"padding"`
  439. }
  440. type ConnectedResponse struct {
  441. ConnectedTimestamp string `json:"connected_timestamp"`
  442. Padding string `json:"padding"`
  443. }
  444. type StatusResponse struct {
  445. InvalidServerEntryTags []string `json:"invalid_server_entry_tags"`
  446. Padding string `json:"padding"`
  447. }
  448. type OSLRequest struct {
  449. ClearLocalSLOKs bool `json:"clear_local_sloks"`
  450. SeedPayload *osl.SeedPayload `json:"seed_payload"`
  451. }
  452. type SSHPasswordPayload struct {
  453. SessionId string `json:"SessionId"`
  454. SshPassword string `json:"SshPassword"`
  455. ClientCapabilities []string `json:"ClientCapabilities"`
  456. }
  457. type MeekCookieData struct {
  458. MeekProtocolVersion int `json:"v"`
  459. ClientTunnelProtocol string `json:"t"`
  460. EndPoint string `json:"e"`
  461. }
  462. type RandomStreamRequest struct {
  463. UpstreamBytes int `json:"u"`
  464. DownstreamBytes int `json:"d"`
  465. }
  466. type AlertRequest struct {
  467. Reason string `json:"reason"`
  468. Subject string `json:"subject"`
  469. ActionURLs []string `json:"action"`
  470. }
  471. func DeriveSSHServerKEXPRNGSeed(obfuscatedKey string) (*prng.Seed, error) {
  472. // By convention, the obfuscatedKey will often be a hex-encoded 32 byte value,
  473. // but this isn't strictly required or validated, so we use SHA256 to map the
  474. // obfuscatedKey to the necessary 32-byte seed value.
  475. seed := prng.Seed(sha256.Sum256([]byte(obfuscatedKey)))
  476. return prng.NewSaltedSeed(&seed, "ssh-server-kex")
  477. }
  478. func DeriveSSHServerVersionPRNGSeed(obfuscatedKey string) (*prng.Seed, error) {
  479. seed := prng.Seed(sha256.Sum256([]byte(obfuscatedKey)))
  480. return prng.NewSaltedSeed(&seed, "ssh-server-version")
  481. }
  482. func DeriveBPFServerProgramPRNGSeed(obfuscatedKey string) (*prng.Seed, error) {
  483. seed := prng.Seed(sha256.Sum256([]byte(obfuscatedKey)))
  484. return prng.NewSaltedSeed(&seed, "bpf-server-program")
  485. }