agent_test.go 46 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801
  1. // SPDX-FileCopyrightText: 2023 The Pion community <https://pion.ly>
  2. // SPDX-License-Identifier: MIT
  3. //go:build !js
  4. // +build !js
  5. package ice
  6. import (
  7. "context"
  8. "errors"
  9. "net"
  10. "strconv"
  11. "sync"
  12. "testing"
  13. "time"
  14. "github.com/pion/ice/v2/internal/fakenet"
  15. "github.com/pion/logging"
  16. "github.com/pion/stun"
  17. "github.com/pion/transport/v2/test"
  18. "github.com/pion/transport/v2/vnet"
  19. "github.com/stretchr/testify/assert"
  20. "github.com/stretchr/testify/require"
  21. )
  22. type BadAddr struct{}
  23. func (ba *BadAddr) Network() string {
  24. return "xxx"
  25. }
  26. func (ba *BadAddr) String() string {
  27. return "yyy"
  28. }
  29. func runAgentTest(t *testing.T, config *AgentConfig, task func(ctx context.Context, a *Agent)) {
  30. a, err := NewAgent(config)
  31. if err != nil {
  32. t.Fatalf("Error constructing ice.Agent")
  33. }
  34. if err := a.run(context.Background(), task); err != nil {
  35. t.Fatalf("Agent run failure: %v", err)
  36. }
  37. assert.NoError(t, a.Close())
  38. }
  39. func TestHandlePeerReflexive(t *testing.T) {
  40. report := test.CheckRoutines(t)
  41. defer report()
  42. // Limit runtime in case of deadlocks
  43. lim := test.TimeOut(time.Second * 2)
  44. defer lim.Stop()
  45. t.Run("UDP prflx candidate from handleInbound()", func(t *testing.T) {
  46. var config AgentConfig
  47. runAgentTest(t, &config, func(ctx context.Context, a *Agent) {
  48. a.selector = &controllingSelector{agent: a, log: a.log}
  49. hostConfig := CandidateHostConfig{
  50. Network: "udp",
  51. Address: "192.168.0.2",
  52. Port: 777,
  53. Component: 1,
  54. }
  55. local, err := NewCandidateHost(&hostConfig)
  56. local.conn = &fakenet.MockPacketConn{}
  57. if err != nil {
  58. t.Fatalf("failed to create a new candidate: %v", err)
  59. }
  60. remote := &net.UDPAddr{IP: net.ParseIP("172.17.0.3"), Port: 999}
  61. msg, err := stun.Build(stun.BindingRequest, stun.TransactionID,
  62. stun.NewUsername(a.localUfrag+":"+a.remoteUfrag),
  63. UseCandidate(),
  64. AttrControlling(a.tieBreaker),
  65. PriorityAttr(local.Priority()),
  66. stun.NewShortTermIntegrity(a.localPwd),
  67. stun.Fingerprint,
  68. )
  69. if err != nil {
  70. t.Fatal(err)
  71. }
  72. // nolint: contextcheck
  73. a.handleInbound(msg, local, remote)
  74. // Length of remote candidate list must be one now
  75. if len(a.remoteCandidates) != 1 {
  76. t.Fatal("failed to add a network type to the remote candidate list")
  77. }
  78. // Length of remote candidate list for a network type must be 1
  79. set := a.remoteCandidates[local.NetworkType()]
  80. if len(set) != 1 {
  81. t.Fatal("failed to add prflx candidate to remote candidate list")
  82. }
  83. c := set[0]
  84. if c.Type() != CandidateTypePeerReflexive {
  85. t.Fatal("candidate type must be prflx")
  86. }
  87. if c.Address() != "172.17.0.3" {
  88. t.Fatal("IP address mismatch")
  89. }
  90. if c.Port() != 999 {
  91. t.Fatal("Port number mismatch")
  92. }
  93. })
  94. })
  95. t.Run("Bad network type with handleInbound()", func(t *testing.T) {
  96. var config AgentConfig
  97. runAgentTest(t, &config, func(ctx context.Context, a *Agent) {
  98. a.selector = &controllingSelector{agent: a, log: a.log}
  99. hostConfig := CandidateHostConfig{
  100. Network: "tcp",
  101. Address: "192.168.0.2",
  102. Port: 777,
  103. Component: 1,
  104. }
  105. local, err := NewCandidateHost(&hostConfig)
  106. if err != nil {
  107. t.Fatalf("failed to create a new candidate: %v", err)
  108. }
  109. remote := &BadAddr{}
  110. // nolint: contextcheck
  111. a.handleInbound(nil, local, remote)
  112. if len(a.remoteCandidates) != 0 {
  113. t.Fatal("bad address should not be added to the remote candidate list")
  114. }
  115. })
  116. })
  117. t.Run("Success from unknown remote, prflx candidate MUST only be created via Binding Request", func(t *testing.T) {
  118. var config AgentConfig
  119. runAgentTest(t, &config, func(ctx context.Context, a *Agent) {
  120. a.selector = &controllingSelector{agent: a, log: a.log}
  121. tID := [stun.TransactionIDSize]byte{}
  122. copy(tID[:], "ABC")
  123. a.pendingBindingRequests = []bindingRequest{
  124. {time.Now(), tID, &net.UDPAddr{}, false},
  125. }
  126. hostConfig := CandidateHostConfig{
  127. Network: "udp",
  128. Address: "192.168.0.2",
  129. Port: 777,
  130. Component: 1,
  131. }
  132. local, err := NewCandidateHost(&hostConfig)
  133. local.conn = &fakenet.MockPacketConn{}
  134. if err != nil {
  135. t.Fatalf("failed to create a new candidate: %v", err)
  136. }
  137. remote := &net.UDPAddr{IP: net.ParseIP("172.17.0.3"), Port: 999}
  138. msg, err := stun.Build(stun.BindingSuccess, stun.NewTransactionIDSetter(tID),
  139. stun.NewShortTermIntegrity(a.remotePwd),
  140. stun.Fingerprint,
  141. )
  142. if err != nil {
  143. t.Fatal(err)
  144. }
  145. // nolint: contextcheck
  146. a.handleInbound(msg, local, remote)
  147. if len(a.remoteCandidates) != 0 {
  148. t.Fatal("unknown remote was able to create a candidate")
  149. }
  150. })
  151. })
  152. }
  153. // Assert that Agent on startup sends message, and doesn't wait for connectivityTicker to fire
  154. // https://github.com/pion/ice/issues/15
  155. func TestConnectivityOnStartup(t *testing.T) {
  156. report := test.CheckRoutines(t)
  157. defer report()
  158. lim := test.TimeOut(time.Second * 30)
  159. defer lim.Stop()
  160. // Create a network with two interfaces
  161. wan, err := vnet.NewRouter(&vnet.RouterConfig{
  162. CIDR: "0.0.0.0/0",
  163. LoggerFactory: logging.NewDefaultLoggerFactory(),
  164. })
  165. assert.NoError(t, err)
  166. net0, err := vnet.NewNet(&vnet.NetConfig{
  167. StaticIPs: []string{"192.168.0.1"},
  168. })
  169. assert.NoError(t, err)
  170. assert.NoError(t, wan.AddNet(net0))
  171. net1, err := vnet.NewNet(&vnet.NetConfig{
  172. StaticIPs: []string{"192.168.0.2"},
  173. })
  174. assert.NoError(t, err)
  175. assert.NoError(t, wan.AddNet(net1))
  176. assert.NoError(t, wan.Start())
  177. aNotifier, aConnected := onConnected()
  178. bNotifier, bConnected := onConnected()
  179. KeepaliveInterval := time.Hour
  180. cfg0 := &AgentConfig{
  181. NetworkTypes: supportedNetworkTypes(),
  182. MulticastDNSMode: MulticastDNSModeDisabled,
  183. Net: net0,
  184. KeepaliveInterval: &KeepaliveInterval,
  185. CheckInterval: &KeepaliveInterval,
  186. }
  187. aAgent, err := NewAgent(cfg0)
  188. require.NoError(t, err)
  189. require.NoError(t, aAgent.OnConnectionStateChange(aNotifier))
  190. cfg1 := &AgentConfig{
  191. NetworkTypes: supportedNetworkTypes(),
  192. MulticastDNSMode: MulticastDNSModeDisabled,
  193. Net: net1,
  194. KeepaliveInterval: &KeepaliveInterval,
  195. CheckInterval: &KeepaliveInterval,
  196. }
  197. bAgent, err := NewAgent(cfg1)
  198. require.NoError(t, err)
  199. require.NoError(t, bAgent.OnConnectionStateChange(bNotifier))
  200. aConn, bConn := func(aAgent, bAgent *Agent) (*Conn, *Conn) {
  201. // Manual signaling
  202. aUfrag, aPwd, err := aAgent.GetLocalUserCredentials()
  203. assert.NoError(t, err)
  204. bUfrag, bPwd, err := bAgent.GetLocalUserCredentials()
  205. assert.NoError(t, err)
  206. gatherAndExchangeCandidates(aAgent, bAgent)
  207. accepted := make(chan struct{})
  208. accepting := make(chan struct{})
  209. var aConn *Conn
  210. origHdlr := aAgent.onConnectionStateChangeHdlr.Load()
  211. if origHdlr != nil {
  212. defer check(aAgent.OnConnectionStateChange(origHdlr.(func(ConnectionState)))) //nolint:forcetypeassert
  213. }
  214. check(aAgent.OnConnectionStateChange(func(s ConnectionState) {
  215. if s == ConnectionStateChecking {
  216. close(accepting)
  217. }
  218. if origHdlr != nil {
  219. origHdlr.(func(ConnectionState))(s) //nolint:forcetypeassert
  220. }
  221. }))
  222. go func() {
  223. var acceptErr error
  224. aConn, acceptErr = aAgent.Accept(context.TODO(), bUfrag, bPwd)
  225. check(acceptErr)
  226. close(accepted)
  227. }()
  228. <-accepting
  229. bConn, err := bAgent.Dial(context.TODO(), aUfrag, aPwd)
  230. check(err)
  231. // Ensure accepted
  232. <-accepted
  233. return aConn, bConn
  234. }(aAgent, bAgent)
  235. // Ensure pair selected
  236. // Note: this assumes ConnectionStateConnected is thrown after selecting the final pair
  237. <-aConnected
  238. <-bConnected
  239. assert.NoError(t, wan.Stop())
  240. if !closePipe(t, aConn, bConn) {
  241. return
  242. }
  243. }
  244. func TestConnectivityLite(t *testing.T) {
  245. report := test.CheckRoutines(t)
  246. defer report()
  247. lim := test.TimeOut(time.Second * 30)
  248. defer lim.Stop()
  249. stunServerURL := &stun.URI{
  250. Scheme: SchemeTypeSTUN,
  251. Host: "1.2.3.4",
  252. Port: 3478,
  253. Proto: stun.ProtoTypeUDP,
  254. }
  255. natType := &vnet.NATType{
  256. MappingBehavior: vnet.EndpointIndependent,
  257. FilteringBehavior: vnet.EndpointIndependent,
  258. }
  259. v, err := buildVNet(natType, natType)
  260. require.NoError(t, err, "should succeed")
  261. defer v.close()
  262. aNotifier, aConnected := onConnected()
  263. bNotifier, bConnected := onConnected()
  264. cfg0 := &AgentConfig{
  265. Urls: []*stun.URI{stunServerURL},
  266. NetworkTypes: supportedNetworkTypes(),
  267. MulticastDNSMode: MulticastDNSModeDisabled,
  268. Net: v.net0,
  269. }
  270. aAgent, err := NewAgent(cfg0)
  271. require.NoError(t, err)
  272. require.NoError(t, aAgent.OnConnectionStateChange(aNotifier))
  273. cfg1 := &AgentConfig{
  274. Urls: []*stun.URI{},
  275. Lite: true,
  276. CandidateTypes: []CandidateType{CandidateTypeHost},
  277. NetworkTypes: supportedNetworkTypes(),
  278. MulticastDNSMode: MulticastDNSModeDisabled,
  279. Net: v.net1,
  280. }
  281. bAgent, err := NewAgent(cfg1)
  282. require.NoError(t, err)
  283. require.NoError(t, bAgent.OnConnectionStateChange(bNotifier))
  284. aConn, bConn := connectWithVNet(aAgent, bAgent)
  285. // Ensure pair selected
  286. // Note: this assumes ConnectionStateConnected is thrown after selecting the final pair
  287. <-aConnected
  288. <-bConnected
  289. if !closePipe(t, aConn, bConn) {
  290. return
  291. }
  292. }
  293. func TestInboundValidity(t *testing.T) {
  294. report := test.CheckRoutines(t)
  295. defer report()
  296. buildMsg := func(class stun.MessageClass, username, key string) *stun.Message {
  297. msg, err := stun.Build(stun.NewType(stun.MethodBinding, class), stun.TransactionID,
  298. stun.NewUsername(username),
  299. stun.NewShortTermIntegrity(key),
  300. stun.Fingerprint,
  301. )
  302. if err != nil {
  303. t.Fatal(err)
  304. }
  305. return msg
  306. }
  307. remote := &net.UDPAddr{IP: net.ParseIP("172.17.0.3"), Port: 999}
  308. hostConfig := CandidateHostConfig{
  309. Network: "udp",
  310. Address: "192.168.0.2",
  311. Port: 777,
  312. Component: 1,
  313. }
  314. local, err := NewCandidateHost(&hostConfig)
  315. local.conn = &fakenet.MockPacketConn{}
  316. if err != nil {
  317. t.Fatalf("failed to create a new candidate: %v", err)
  318. }
  319. t.Run("Invalid Binding requests should be discarded", func(t *testing.T) {
  320. a, err := NewAgent(&AgentConfig{})
  321. if err != nil {
  322. t.Fatalf("Error constructing ice.Agent")
  323. }
  324. a.handleInbound(buildMsg(stun.ClassRequest, "invalid", a.localPwd), local, remote)
  325. if len(a.remoteCandidates) == 1 {
  326. t.Fatal("Binding with invalid Username was able to create prflx candidate")
  327. }
  328. a.handleInbound(buildMsg(stun.ClassRequest, a.localUfrag+":"+a.remoteUfrag, "Invalid"), local, remote)
  329. if len(a.remoteCandidates) == 1 {
  330. t.Fatal("Binding with invalid MessageIntegrity was able to create prflx candidate")
  331. }
  332. assert.NoError(t, a.Close())
  333. })
  334. t.Run("Invalid Binding success responses should be discarded", func(t *testing.T) {
  335. a, err := NewAgent(&AgentConfig{})
  336. if err != nil {
  337. t.Fatalf("Error constructing ice.Agent")
  338. }
  339. a.handleInbound(buildMsg(stun.ClassSuccessResponse, a.localUfrag+":"+a.remoteUfrag, "Invalid"), local, remote)
  340. if len(a.remoteCandidates) == 1 {
  341. t.Fatal("Binding with invalid MessageIntegrity was able to create prflx candidate")
  342. }
  343. assert.NoError(t, a.Close())
  344. })
  345. t.Run("Discard non-binding messages", func(t *testing.T) {
  346. a, err := NewAgent(&AgentConfig{})
  347. if err != nil {
  348. t.Fatalf("Error constructing ice.Agent")
  349. }
  350. a.handleInbound(buildMsg(stun.ClassErrorResponse, a.localUfrag+":"+a.remoteUfrag, "Invalid"), local, remote)
  351. if len(a.remoteCandidates) == 1 {
  352. t.Fatal("non-binding message was able to create prflxRemote")
  353. }
  354. assert.NoError(t, a.Close())
  355. })
  356. t.Run("Valid bind request", func(t *testing.T) {
  357. a, err := NewAgent(&AgentConfig{})
  358. if err != nil {
  359. t.Fatalf("Error constructing ice.Agent")
  360. }
  361. err = a.run(context.Background(), func(ctx context.Context, a *Agent) {
  362. a.selector = &controllingSelector{agent: a, log: a.log}
  363. // nolint: contextcheck
  364. a.handleInbound(buildMsg(stun.ClassRequest, a.localUfrag+":"+a.remoteUfrag, a.localPwd), local, remote)
  365. if len(a.remoteCandidates) != 1 {
  366. t.Fatal("Binding with valid values was unable to create prflx candidate")
  367. }
  368. })
  369. assert.NoError(t, err)
  370. assert.NoError(t, a.Close())
  371. })
  372. t.Run("Valid bind without fingerprint", func(t *testing.T) {
  373. var config AgentConfig
  374. runAgentTest(t, &config, func(ctx context.Context, a *Agent) {
  375. a.selector = &controllingSelector{agent: a, log: a.log}
  376. msg, err := stun.Build(stun.BindingRequest, stun.TransactionID,
  377. stun.NewUsername(a.localUfrag+":"+a.remoteUfrag),
  378. stun.NewShortTermIntegrity(a.localPwd),
  379. )
  380. if err != nil {
  381. t.Fatal(err)
  382. }
  383. // nolint: contextcheck
  384. a.handleInbound(msg, local, remote)
  385. if len(a.remoteCandidates) != 1 {
  386. t.Fatal("Binding with valid values (but no fingerprint) was unable to create prflx candidate")
  387. }
  388. })
  389. })
  390. t.Run("Success with invalid TransactionID", func(t *testing.T) {
  391. a, err := NewAgent(&AgentConfig{})
  392. if err != nil {
  393. t.Fatalf("Error constructing ice.Agent")
  394. }
  395. hostConfig := CandidateHostConfig{
  396. Network: "udp",
  397. Address: "192.168.0.2",
  398. Port: 777,
  399. Component: 1,
  400. }
  401. local, err := NewCandidateHost(&hostConfig)
  402. local.conn = &fakenet.MockPacketConn{}
  403. if err != nil {
  404. t.Fatalf("failed to create a new candidate: %v", err)
  405. }
  406. remote := &net.UDPAddr{IP: net.ParseIP("172.17.0.3"), Port: 999}
  407. tID := [stun.TransactionIDSize]byte{}
  408. copy(tID[:], "ABC")
  409. msg, err := stun.Build(stun.BindingSuccess, stun.NewTransactionIDSetter(tID),
  410. stun.NewShortTermIntegrity(a.remotePwd),
  411. stun.Fingerprint,
  412. )
  413. assert.NoError(t, err)
  414. a.handleInbound(msg, local, remote)
  415. if len(a.remoteCandidates) != 0 {
  416. t.Fatal("unknown remote was able to create a candidate")
  417. }
  418. assert.NoError(t, a.Close())
  419. })
  420. }
  421. func TestInvalidAgentStarts(t *testing.T) {
  422. report := test.CheckRoutines(t)
  423. defer report()
  424. a, err := NewAgent(&AgentConfig{})
  425. assert.NoError(t, err)
  426. ctx := context.Background()
  427. ctx, cancel := context.WithTimeout(ctx, 100*time.Millisecond)
  428. defer cancel()
  429. if _, err = a.Dial(ctx, "", "bar"); err != nil && !errors.Is(err, ErrRemoteUfragEmpty) {
  430. t.Fatal(err)
  431. }
  432. if _, err = a.Dial(ctx, "foo", ""); err != nil && !errors.Is(err, ErrRemotePwdEmpty) {
  433. t.Fatal(err)
  434. }
  435. if _, err = a.Dial(ctx, "foo", "bar"); err != nil && !errors.Is(err, ErrCanceledByCaller) {
  436. t.Fatal(err)
  437. }
  438. if _, err = a.Dial(context.TODO(), "foo", "bar"); err != nil && !errors.Is(err, ErrMultipleStart) {
  439. t.Fatal(err)
  440. }
  441. assert.NoError(t, a.Close())
  442. }
  443. // Assert that Agent emits Connecting/Connected/Disconnected/Failed/Closed messages
  444. func TestConnectionStateCallback(t *testing.T) {
  445. report := test.CheckRoutines(t)
  446. defer report()
  447. lim := test.TimeOut(time.Second * 5)
  448. defer lim.Stop()
  449. disconnectedDuration := time.Second
  450. failedDuration := time.Second
  451. KeepaliveInterval := time.Duration(0)
  452. cfg := &AgentConfig{
  453. Urls: []*stun.URI{},
  454. NetworkTypes: supportedNetworkTypes(),
  455. DisconnectedTimeout: &disconnectedDuration,
  456. FailedTimeout: &failedDuration,
  457. KeepaliveInterval: &KeepaliveInterval,
  458. }
  459. aAgent, err := NewAgent(cfg)
  460. if err != nil {
  461. t.Error(err)
  462. }
  463. bAgent, err := NewAgent(cfg)
  464. if err != nil {
  465. t.Error(err)
  466. }
  467. isChecking := make(chan interface{})
  468. isConnected := make(chan interface{})
  469. isDisconnected := make(chan interface{})
  470. isFailed := make(chan interface{})
  471. isClosed := make(chan interface{})
  472. err = aAgent.OnConnectionStateChange(func(c ConnectionState) {
  473. switch c {
  474. case ConnectionStateChecking:
  475. close(isChecking)
  476. case ConnectionStateConnected:
  477. close(isConnected)
  478. case ConnectionStateDisconnected:
  479. close(isDisconnected)
  480. case ConnectionStateFailed:
  481. close(isFailed)
  482. case ConnectionStateClosed:
  483. close(isClosed)
  484. default:
  485. }
  486. })
  487. if err != nil {
  488. t.Error(err)
  489. }
  490. connect(aAgent, bAgent)
  491. <-isChecking
  492. <-isConnected
  493. <-isDisconnected
  494. <-isFailed
  495. assert.NoError(t, aAgent.Close())
  496. assert.NoError(t, bAgent.Close())
  497. <-isClosed
  498. }
  499. func TestInvalidGather(t *testing.T) {
  500. t.Run("Gather with no OnCandidate should error", func(t *testing.T) {
  501. a, err := NewAgent(&AgentConfig{})
  502. if err != nil {
  503. t.Fatalf("Error constructing ice.Agent")
  504. }
  505. err = a.GatherCandidates()
  506. if !errors.Is(err, ErrNoOnCandidateHandler) {
  507. t.Fatal("trickle GatherCandidates succeeded without OnCandidate")
  508. }
  509. assert.NoError(t, a.Close())
  510. })
  511. }
  512. func TestCandidatePairStats(t *testing.T) {
  513. report := test.CheckRoutines(t)
  514. defer report()
  515. // Avoid deadlocks?
  516. defer test.TimeOut(1 * time.Second).Stop()
  517. a, err := NewAgent(&AgentConfig{})
  518. if err != nil {
  519. t.Fatalf("Failed to create agent: %s", err)
  520. }
  521. hostConfig := &CandidateHostConfig{
  522. Network: "udp",
  523. Address: "192.168.1.1",
  524. Port: 19216,
  525. Component: 1,
  526. }
  527. hostLocal, err := NewCandidateHost(hostConfig)
  528. if err != nil {
  529. t.Fatalf("Failed to construct local host candidate: %s", err)
  530. }
  531. relayConfig := &CandidateRelayConfig{
  532. Network: "udp",
  533. Address: "1.2.3.4",
  534. Port: 2340,
  535. Component: 1,
  536. RelAddr: "4.3.2.1",
  537. RelPort: 43210,
  538. }
  539. relayRemote, err := NewCandidateRelay(relayConfig)
  540. if err != nil {
  541. t.Fatalf("Failed to construct remote relay candidate: %s", err)
  542. }
  543. srflxConfig := &CandidateServerReflexiveConfig{
  544. Network: "udp",
  545. Address: "10.10.10.2",
  546. Port: 19218,
  547. Component: 1,
  548. RelAddr: "4.3.2.1",
  549. RelPort: 43212,
  550. }
  551. srflxRemote, err := NewCandidateServerReflexive(srflxConfig)
  552. if err != nil {
  553. t.Fatalf("Failed to construct remote srflx candidate: %s", err)
  554. }
  555. prflxConfig := &CandidatePeerReflexiveConfig{
  556. Network: "udp",
  557. Address: "10.10.10.2",
  558. Port: 19217,
  559. Component: 1,
  560. RelAddr: "4.3.2.1",
  561. RelPort: 43211,
  562. }
  563. prflxRemote, err := NewCandidatePeerReflexive(prflxConfig)
  564. if err != nil {
  565. t.Fatalf("Failed to construct remote prflx candidate: %s", err)
  566. }
  567. hostConfig = &CandidateHostConfig{
  568. Network: "udp",
  569. Address: "1.2.3.5",
  570. Port: 12350,
  571. Component: 1,
  572. }
  573. hostRemote, err := NewCandidateHost(hostConfig)
  574. if err != nil {
  575. t.Fatalf("Failed to construct remote host candidate: %s", err)
  576. }
  577. for _, remote := range []Candidate{relayRemote, srflxRemote, prflxRemote, hostRemote} {
  578. p := a.findPair(hostLocal, remote)
  579. if p == nil {
  580. a.addPair(hostLocal, remote)
  581. }
  582. }
  583. p := a.findPair(hostLocal, prflxRemote)
  584. p.state = CandidatePairStateFailed
  585. stats := a.GetCandidatePairsStats()
  586. if len(stats) != 4 {
  587. t.Fatal("expected 4 candidate pairs stats")
  588. }
  589. var relayPairStat, srflxPairStat, prflxPairStat, hostPairStat CandidatePairStats
  590. for _, cps := range stats {
  591. if cps.LocalCandidateID != hostLocal.ID() {
  592. t.Fatal("invalid local candidate id")
  593. }
  594. switch cps.RemoteCandidateID {
  595. case relayRemote.ID():
  596. relayPairStat = cps
  597. case srflxRemote.ID():
  598. srflxPairStat = cps
  599. case prflxRemote.ID():
  600. prflxPairStat = cps
  601. case hostRemote.ID():
  602. hostPairStat = cps
  603. default:
  604. t.Fatal("invalid remote candidate ID")
  605. }
  606. }
  607. if relayPairStat.RemoteCandidateID != relayRemote.ID() {
  608. t.Fatal("missing host-relay pair stat")
  609. }
  610. if srflxPairStat.RemoteCandidateID != srflxRemote.ID() {
  611. t.Fatal("missing host-srflx pair stat")
  612. }
  613. if prflxPairStat.RemoteCandidateID != prflxRemote.ID() {
  614. t.Fatal("missing host-prflx pair stat")
  615. }
  616. if hostPairStat.RemoteCandidateID != hostRemote.ID() {
  617. t.Fatal("missing host-host pair stat")
  618. }
  619. if prflxPairStat.State != CandidatePairStateFailed {
  620. t.Fatalf("expected host-prflx pair to have state failed, it has state %s instead",
  621. prflxPairStat.State.String())
  622. }
  623. assert.NoError(t, a.Close())
  624. }
  625. func TestLocalCandidateStats(t *testing.T) {
  626. report := test.CheckRoutines(t)
  627. defer report()
  628. // Avoid deadlocks?
  629. defer test.TimeOut(1 * time.Second).Stop()
  630. a, err := NewAgent(&AgentConfig{})
  631. if err != nil {
  632. t.Fatalf("Failed to create agent: %s", err)
  633. }
  634. hostConfig := &CandidateHostConfig{
  635. Network: "udp",
  636. Address: "192.168.1.1",
  637. Port: 19216,
  638. Component: 1,
  639. }
  640. hostLocal, err := NewCandidateHost(hostConfig)
  641. if err != nil {
  642. t.Fatalf("Failed to construct local host candidate: %s", err)
  643. }
  644. srflxConfig := &CandidateServerReflexiveConfig{
  645. Network: "udp",
  646. Address: "192.168.1.1",
  647. Port: 19217,
  648. Component: 1,
  649. RelAddr: "4.3.2.1",
  650. RelPort: 43212,
  651. }
  652. srflxLocal, err := NewCandidateServerReflexive(srflxConfig)
  653. if err != nil {
  654. t.Fatalf("Failed to construct local srflx candidate: %s", err)
  655. }
  656. a.localCandidates[NetworkTypeUDP4] = []Candidate{hostLocal, srflxLocal}
  657. localStats := a.GetLocalCandidatesStats()
  658. if len(localStats) != 2 {
  659. t.Fatalf("expected 2 local candidates stats, got %d instead", len(localStats))
  660. }
  661. var hostLocalStat, srflxLocalStat CandidateStats
  662. for _, stats := range localStats {
  663. var candidate Candidate
  664. switch stats.ID {
  665. case hostLocal.ID():
  666. hostLocalStat = stats
  667. candidate = hostLocal
  668. case srflxLocal.ID():
  669. srflxLocalStat = stats
  670. candidate = srflxLocal
  671. default:
  672. t.Fatal("invalid local candidate ID")
  673. }
  674. if stats.CandidateType != candidate.Type() {
  675. t.Fatal("invalid stats CandidateType")
  676. }
  677. if stats.Priority != candidate.Priority() {
  678. t.Fatal("invalid stats CandidateType")
  679. }
  680. if stats.IP != candidate.Address() {
  681. t.Fatal("invalid stats IP")
  682. }
  683. }
  684. if hostLocalStat.ID != hostLocal.ID() {
  685. t.Fatal("missing host local stat")
  686. }
  687. if srflxLocalStat.ID != srflxLocal.ID() {
  688. t.Fatal("missing srflx local stat")
  689. }
  690. assert.NoError(t, a.Close())
  691. }
  692. func TestRemoteCandidateStats(t *testing.T) {
  693. report := test.CheckRoutines(t)
  694. defer report()
  695. // Avoid deadlocks?
  696. defer test.TimeOut(1 * time.Second).Stop()
  697. a, err := NewAgent(&AgentConfig{})
  698. if err != nil {
  699. t.Fatalf("Failed to create agent: %s", err)
  700. }
  701. relayConfig := &CandidateRelayConfig{
  702. Network: "udp",
  703. Address: "1.2.3.4",
  704. Port: 12340,
  705. Component: 1,
  706. RelAddr: "4.3.2.1",
  707. RelPort: 43210,
  708. }
  709. relayRemote, err := NewCandidateRelay(relayConfig)
  710. if err != nil {
  711. t.Fatalf("Failed to construct remote relay candidate: %s", err)
  712. }
  713. srflxConfig := &CandidateServerReflexiveConfig{
  714. Network: "udp",
  715. Address: "10.10.10.2",
  716. Port: 19218,
  717. Component: 1,
  718. RelAddr: "4.3.2.1",
  719. RelPort: 43212,
  720. }
  721. srflxRemote, err := NewCandidateServerReflexive(srflxConfig)
  722. if err != nil {
  723. t.Fatalf("Failed to construct remote srflx candidate: %s", err)
  724. }
  725. prflxConfig := &CandidatePeerReflexiveConfig{
  726. Network: "udp",
  727. Address: "10.10.10.2",
  728. Port: 19217,
  729. Component: 1,
  730. RelAddr: "4.3.2.1",
  731. RelPort: 43211,
  732. }
  733. prflxRemote, err := NewCandidatePeerReflexive(prflxConfig)
  734. if err != nil {
  735. t.Fatalf("Failed to construct remote prflx candidate: %s", err)
  736. }
  737. hostConfig := &CandidateHostConfig{
  738. Network: "udp",
  739. Address: "1.2.3.5",
  740. Port: 12350,
  741. Component: 1,
  742. }
  743. hostRemote, err := NewCandidateHost(hostConfig)
  744. if err != nil {
  745. t.Fatalf("Failed to construct remote host candidate: %s", err)
  746. }
  747. a.remoteCandidates[NetworkTypeUDP4] = []Candidate{relayRemote, srflxRemote, prflxRemote, hostRemote}
  748. remoteStats := a.GetRemoteCandidatesStats()
  749. if len(remoteStats) != 4 {
  750. t.Fatalf("expected 4 remote candidates stats, got %d instead", len(remoteStats))
  751. }
  752. var relayRemoteStat, srflxRemoteStat, prflxRemoteStat, hostRemoteStat CandidateStats
  753. for _, stats := range remoteStats {
  754. var candidate Candidate
  755. switch stats.ID {
  756. case relayRemote.ID():
  757. relayRemoteStat = stats
  758. candidate = relayRemote
  759. case srflxRemote.ID():
  760. srflxRemoteStat = stats
  761. candidate = srflxRemote
  762. case prflxRemote.ID():
  763. prflxRemoteStat = stats
  764. candidate = prflxRemote
  765. case hostRemote.ID():
  766. hostRemoteStat = stats
  767. candidate = hostRemote
  768. default:
  769. t.Fatal("invalid remote candidate ID")
  770. }
  771. if stats.CandidateType != candidate.Type() {
  772. t.Fatal("invalid stats CandidateType")
  773. }
  774. if stats.Priority != candidate.Priority() {
  775. t.Fatal("invalid stats CandidateType")
  776. }
  777. if stats.IP != candidate.Address() {
  778. t.Fatal("invalid stats IP")
  779. }
  780. }
  781. if relayRemoteStat.ID != relayRemote.ID() {
  782. t.Fatal("missing relay remote stat")
  783. }
  784. if srflxRemoteStat.ID != srflxRemote.ID() {
  785. t.Fatal("missing srflx remote stat")
  786. }
  787. if prflxRemoteStat.ID != prflxRemote.ID() {
  788. t.Fatal("missing prflx remote stat")
  789. }
  790. if hostRemoteStat.ID != hostRemote.ID() {
  791. t.Fatal("missing host remote stat")
  792. }
  793. assert.NoError(t, a.Close())
  794. }
  795. func TestInitExtIPMapping(t *testing.T) {
  796. report := test.CheckRoutines(t)
  797. defer report()
  798. // a.extIPMapper should be nil by default
  799. a, err := NewAgent(&AgentConfig{})
  800. if err != nil {
  801. t.Fatalf("Failed to create agent: %v", err)
  802. }
  803. if a.extIPMapper != nil {
  804. t.Fatal("a.extIPMapper should be nil by default")
  805. }
  806. assert.NoError(t, a.Close())
  807. // a.extIPMapper should be nil when NAT1To1IPs is a non-nil empty array
  808. a, err = NewAgent(&AgentConfig{
  809. NAT1To1IPs: []string{},
  810. NAT1To1IPCandidateType: CandidateTypeHost,
  811. })
  812. if err != nil {
  813. t.Fatalf("Failed to create agent: %v", err)
  814. }
  815. if a.extIPMapper != nil {
  816. t.Fatal("a.extIPMapper should be nil by default")
  817. }
  818. assert.NoError(t, a.Close())
  819. // NewAgent should return an error when 1:1 NAT for host candidate is enabled
  820. // but the candidate type does not appear in the CandidateTypes.
  821. _, err = NewAgent(&AgentConfig{
  822. NAT1To1IPs: []string{"1.2.3.4"},
  823. NAT1To1IPCandidateType: CandidateTypeHost,
  824. CandidateTypes: []CandidateType{CandidateTypeRelay},
  825. })
  826. if !errors.Is(err, ErrIneffectiveNAT1To1IPMappingHost) {
  827. t.Fatalf("Unexpected error: %v", err)
  828. }
  829. // NewAgent should return an error when 1:1 NAT for srflx candidate is enabled
  830. // but the candidate type does not appear in the CandidateTypes.
  831. _, err = NewAgent(&AgentConfig{
  832. NAT1To1IPs: []string{"1.2.3.4"},
  833. NAT1To1IPCandidateType: CandidateTypeServerReflexive,
  834. CandidateTypes: []CandidateType{CandidateTypeRelay},
  835. })
  836. if !errors.Is(err, ErrIneffectiveNAT1To1IPMappingSrflx) {
  837. t.Fatalf("Unexpected error: %v", err)
  838. }
  839. // NewAgent should return an error when 1:1 NAT for host candidate is enabled
  840. // along with mDNS with MulticastDNSModeQueryAndGather
  841. _, err = NewAgent(&AgentConfig{
  842. NAT1To1IPs: []string{"1.2.3.4"},
  843. NAT1To1IPCandidateType: CandidateTypeHost,
  844. MulticastDNSMode: MulticastDNSModeQueryAndGather,
  845. })
  846. if !errors.Is(err, ErrMulticastDNSWithNAT1To1IPMapping) {
  847. t.Fatalf("Unexpected error: %v", err)
  848. }
  849. // NewAgent should return if newExternalIPMapper() returns an error.
  850. _, err = NewAgent(&AgentConfig{
  851. NAT1To1IPs: []string{"bad.2.3.4"}, // Bad IP
  852. NAT1To1IPCandidateType: CandidateTypeHost,
  853. })
  854. if !errors.Is(err, ErrInvalidNAT1To1IPMapping) {
  855. t.Fatalf("Unexpected error: %v", err)
  856. }
  857. }
  858. func TestBindingRequestTimeout(t *testing.T) {
  859. report := test.CheckRoutines(t)
  860. defer report()
  861. const expectedRemovalCount = 2
  862. a, err := NewAgent(&AgentConfig{})
  863. assert.NoError(t, err)
  864. now := time.Now()
  865. a.pendingBindingRequests = append(a.pendingBindingRequests, bindingRequest{
  866. timestamp: now, // Valid
  867. })
  868. a.pendingBindingRequests = append(a.pendingBindingRequests, bindingRequest{
  869. timestamp: now.Add(-3900 * time.Millisecond), // Valid
  870. })
  871. a.pendingBindingRequests = append(a.pendingBindingRequests, bindingRequest{
  872. timestamp: now.Add(-4100 * time.Millisecond), // Invalid
  873. })
  874. a.pendingBindingRequests = append(a.pendingBindingRequests, bindingRequest{
  875. timestamp: now.Add(-75 * time.Hour), // Invalid
  876. })
  877. a.invalidatePendingBindingRequests(now)
  878. assert.Equal(t, expectedRemovalCount, len(a.pendingBindingRequests), "Binding invalidation due to timeout did not remove the correct number of binding requests")
  879. assert.NoError(t, a.Close())
  880. }
  881. // TestAgentCredentials checks if local username fragments and passwords (if set) meet RFC standard
  882. // and ensure it's backwards compatible with previous versions of the pion/ice
  883. func TestAgentCredentials(t *testing.T) {
  884. report := test.CheckRoutines(t)
  885. defer report()
  886. // Make sure to pass Travis check by disabling the logs
  887. log := logging.NewDefaultLoggerFactory()
  888. log.DefaultLogLevel = logging.LogLevelDisabled
  889. // Agent should not require any of the usernames and password to be set
  890. // If set, they should follow the default 16/128 bits random number generator strategy
  891. agent, err := NewAgent(&AgentConfig{LoggerFactory: log})
  892. assert.NoError(t, err)
  893. assert.GreaterOrEqual(t, len([]rune(agent.localUfrag))*8, 24)
  894. assert.GreaterOrEqual(t, len([]rune(agent.localPwd))*8, 128)
  895. assert.NoError(t, agent.Close())
  896. // Should honor RFC standards
  897. // Local values MUST be unguessable, with at least 128 bits of
  898. // random number generator output used to generate the password, and
  899. // at least 24 bits of output to generate the username fragment.
  900. _, err = NewAgent(&AgentConfig{LocalUfrag: "xx", LoggerFactory: log})
  901. assert.EqualError(t, err, ErrLocalUfragInsufficientBits.Error())
  902. _, err = NewAgent(&AgentConfig{LocalPwd: "xxxxxx", LoggerFactory: log})
  903. assert.EqualError(t, err, ErrLocalPwdInsufficientBits.Error())
  904. }
  905. // Assert that Agent on Failure deletes all existing candidates
  906. // User can then do an ICE Restart to bring agent back
  907. func TestConnectionStateFailedDeleteAllCandidates(t *testing.T) {
  908. report := test.CheckRoutines(t)
  909. defer report()
  910. lim := test.TimeOut(time.Second * 5)
  911. defer lim.Stop()
  912. oneSecond := time.Second
  913. KeepaliveInterval := time.Duration(0)
  914. cfg := &AgentConfig{
  915. NetworkTypes: supportedNetworkTypes(),
  916. DisconnectedTimeout: &oneSecond,
  917. FailedTimeout: &oneSecond,
  918. KeepaliveInterval: &KeepaliveInterval,
  919. }
  920. aAgent, err := NewAgent(cfg)
  921. assert.NoError(t, err)
  922. bAgent, err := NewAgent(cfg)
  923. assert.NoError(t, err)
  924. isFailed := make(chan interface{})
  925. assert.NoError(t, aAgent.OnConnectionStateChange(func(c ConnectionState) {
  926. if c == ConnectionStateFailed {
  927. close(isFailed)
  928. }
  929. }))
  930. connect(aAgent, bAgent)
  931. <-isFailed
  932. done := make(chan struct{})
  933. assert.NoError(t, aAgent.run(context.Background(), func(ctx context.Context, agent *Agent) {
  934. assert.Equal(t, len(aAgent.remoteCandidates), 0)
  935. assert.Equal(t, len(aAgent.localCandidates), 0)
  936. close(done)
  937. }))
  938. <-done
  939. assert.NoError(t, aAgent.Close())
  940. assert.NoError(t, bAgent.Close())
  941. }
  942. // Assert that the ICE Agent can go directly from Connecting -> Failed on both sides
  943. func TestConnectionStateConnectingToFailed(t *testing.T) {
  944. report := test.CheckRoutines(t)
  945. defer report()
  946. lim := test.TimeOut(time.Second * 5)
  947. defer lim.Stop()
  948. oneSecond := time.Second
  949. KeepaliveInterval := time.Duration(0)
  950. cfg := &AgentConfig{
  951. DisconnectedTimeout: &oneSecond,
  952. FailedTimeout: &oneSecond,
  953. KeepaliveInterval: &KeepaliveInterval,
  954. }
  955. aAgent, err := NewAgent(cfg)
  956. assert.NoError(t, err)
  957. bAgent, err := NewAgent(cfg)
  958. assert.NoError(t, err)
  959. var isFailed sync.WaitGroup
  960. var isChecking sync.WaitGroup
  961. isFailed.Add(2)
  962. isChecking.Add(2)
  963. connectionStateCheck := func(c ConnectionState) {
  964. switch c {
  965. case ConnectionStateFailed:
  966. isFailed.Done()
  967. case ConnectionStateChecking:
  968. isChecking.Done()
  969. case ConnectionStateCompleted:
  970. t.Errorf("Unexpected ConnectionState: %v", c)
  971. default:
  972. }
  973. }
  974. assert.NoError(t, aAgent.OnConnectionStateChange(connectionStateCheck))
  975. assert.NoError(t, bAgent.OnConnectionStateChange(connectionStateCheck))
  976. go func() {
  977. _, err := aAgent.Accept(context.TODO(), "InvalidFrag", "InvalidPwd")
  978. assert.Error(t, err)
  979. }()
  980. go func() {
  981. _, err := bAgent.Dial(context.TODO(), "InvalidFrag", "InvalidPwd")
  982. assert.Error(t, err)
  983. }()
  984. isChecking.Wait()
  985. isFailed.Wait()
  986. assert.NoError(t, aAgent.Close())
  987. assert.NoError(t, bAgent.Close())
  988. }
  989. func TestAgentRestart(t *testing.T) {
  990. report := test.CheckRoutines(t)
  991. defer report()
  992. lim := test.TimeOut(time.Second * 30)
  993. defer lim.Stop()
  994. oneSecond := time.Second
  995. t.Run("Restart During Gather", func(t *testing.T) {
  996. connA, connB := pipe(&AgentConfig{
  997. DisconnectedTimeout: &oneSecond,
  998. FailedTimeout: &oneSecond,
  999. })
  1000. ctx, cancel := context.WithCancel(context.Background())
  1001. assert.NoError(t, connB.agent.OnConnectionStateChange(func(c ConnectionState) {
  1002. if c == ConnectionStateFailed || c == ConnectionStateDisconnected {
  1003. cancel()
  1004. }
  1005. }))
  1006. connA.agent.gatheringState = GatheringStateGathering
  1007. assert.NoError(t, connA.agent.Restart("", ""))
  1008. <-ctx.Done()
  1009. assert.NoError(t, connA.agent.Close())
  1010. assert.NoError(t, connB.agent.Close())
  1011. })
  1012. t.Run("Restart When Closed", func(t *testing.T) {
  1013. agent, err := NewAgent(&AgentConfig{})
  1014. assert.NoError(t, err)
  1015. assert.NoError(t, agent.Close())
  1016. assert.Equal(t, ErrClosed, agent.Restart("", ""))
  1017. })
  1018. t.Run("Restart One Side", func(t *testing.T) {
  1019. connA, connB := pipe(&AgentConfig{
  1020. DisconnectedTimeout: &oneSecond,
  1021. FailedTimeout: &oneSecond,
  1022. })
  1023. ctx, cancel := context.WithCancel(context.Background())
  1024. assert.NoError(t, connB.agent.OnConnectionStateChange(func(c ConnectionState) {
  1025. if c == ConnectionStateFailed || c == ConnectionStateDisconnected {
  1026. cancel()
  1027. }
  1028. }))
  1029. assert.NoError(t, connA.agent.Restart("", ""))
  1030. <-ctx.Done()
  1031. assert.NoError(t, connA.agent.Close())
  1032. assert.NoError(t, connB.agent.Close())
  1033. })
  1034. t.Run("Restart Both Sides", func(t *testing.T) {
  1035. // Get all addresses of candidates concatenated
  1036. generateCandidateAddressStrings := func(candidates []Candidate, err error) (out string) {
  1037. assert.NoError(t, err)
  1038. for _, c := range candidates {
  1039. out += c.Address() + ":"
  1040. out += strconv.Itoa(c.Port())
  1041. }
  1042. return
  1043. }
  1044. // Store the original candidates, confirm that after we reconnect we have new pairs
  1045. connA, connB := pipe(&AgentConfig{
  1046. DisconnectedTimeout: &oneSecond,
  1047. FailedTimeout: &oneSecond,
  1048. })
  1049. connAFirstCandidates := generateCandidateAddressStrings(connA.agent.GetLocalCandidates())
  1050. connBFirstCandidates := generateCandidateAddressStrings(connB.agent.GetLocalCandidates())
  1051. aNotifier, aConnected := onConnected()
  1052. assert.NoError(t, connA.agent.OnConnectionStateChange(aNotifier))
  1053. bNotifier, bConnected := onConnected()
  1054. assert.NoError(t, connB.agent.OnConnectionStateChange(bNotifier))
  1055. // Restart and Re-Signal
  1056. assert.NoError(t, connA.agent.Restart("", ""))
  1057. assert.NoError(t, connB.agent.Restart("", ""))
  1058. // Exchange Candidates and Credentials
  1059. ufrag, pwd, err := connB.agent.GetLocalUserCredentials()
  1060. assert.NoError(t, err)
  1061. assert.NoError(t, connA.agent.SetRemoteCredentials(ufrag, pwd))
  1062. ufrag, pwd, err = connA.agent.GetLocalUserCredentials()
  1063. assert.NoError(t, err)
  1064. assert.NoError(t, connB.agent.SetRemoteCredentials(ufrag, pwd))
  1065. gatherAndExchangeCandidates(connA.agent, connB.agent)
  1066. // Wait until both have gone back to connected
  1067. <-aConnected
  1068. <-bConnected
  1069. // Assert that we have new candidates each time
  1070. assert.NotEqual(t, connAFirstCandidates, generateCandidateAddressStrings(connA.agent.GetLocalCandidates()))
  1071. assert.NotEqual(t, connBFirstCandidates, generateCandidateAddressStrings(connB.agent.GetLocalCandidates()))
  1072. assert.NoError(t, connA.agent.Close())
  1073. assert.NoError(t, connB.agent.Close())
  1074. })
  1075. }
  1076. func TestGetRemoteCredentials(t *testing.T) {
  1077. var config AgentConfig
  1078. a, err := NewAgent(&config)
  1079. if err != nil {
  1080. t.Fatalf("Error constructing ice.Agent: %v", err)
  1081. }
  1082. a.remoteUfrag = "remoteUfrag"
  1083. a.remotePwd = "remotePwd"
  1084. actualUfrag, actualPwd, err := a.GetRemoteUserCredentials()
  1085. assert.NoError(t, err)
  1086. assert.Equal(t, actualUfrag, a.remoteUfrag)
  1087. assert.Equal(t, actualPwd, a.remotePwd)
  1088. assert.NoError(t, a.Close())
  1089. }
  1090. func TestGetRemoteCandidates(t *testing.T) {
  1091. var config AgentConfig
  1092. a, err := NewAgent(&config)
  1093. if err != nil {
  1094. t.Fatalf("Error constructing ice.Agent: %v", err)
  1095. }
  1096. expectedCandidates := []Candidate{}
  1097. for i := 0; i < 5; i++ {
  1098. cfg := CandidateHostConfig{
  1099. Network: "udp",
  1100. Address: "192.168.0.2",
  1101. Port: 1000 + i,
  1102. Component: 1,
  1103. }
  1104. cand, errCand := NewCandidateHost(&cfg)
  1105. assert.NoError(t, errCand)
  1106. expectedCandidates = append(expectedCandidates, cand)
  1107. a.addRemoteCandidate(cand)
  1108. }
  1109. actualCandidates, err := a.GetRemoteCandidates()
  1110. assert.NoError(t, err)
  1111. assert.ElementsMatch(t, expectedCandidates, actualCandidates)
  1112. assert.NoError(t, a.Close())
  1113. }
  1114. func TestGetLocalCandidates(t *testing.T) {
  1115. var config AgentConfig
  1116. a, err := NewAgent(&config)
  1117. if err != nil {
  1118. t.Fatalf("Error constructing ice.Agent: %v", err)
  1119. }
  1120. dummyConn := &net.UDPConn{}
  1121. expectedCandidates := []Candidate{}
  1122. for i := 0; i < 5; i++ {
  1123. cfg := CandidateHostConfig{
  1124. Network: "udp",
  1125. Address: "192.168.0.2",
  1126. Port: 1000 + i,
  1127. Component: 1,
  1128. }
  1129. cand, errCand := NewCandidateHost(&cfg)
  1130. assert.NoError(t, errCand)
  1131. expectedCandidates = append(expectedCandidates, cand)
  1132. err = a.addCandidate(context.Background(), cand, dummyConn)
  1133. assert.NoError(t, err)
  1134. }
  1135. actualCandidates, err := a.GetLocalCandidates()
  1136. assert.NoError(t, err)
  1137. assert.ElementsMatch(t, expectedCandidates, actualCandidates)
  1138. assert.NoError(t, a.Close())
  1139. }
  1140. func TestCloseInConnectionStateCallback(t *testing.T) {
  1141. report := test.CheckRoutines(t)
  1142. defer report()
  1143. lim := test.TimeOut(time.Second * 5)
  1144. defer lim.Stop()
  1145. disconnectedDuration := time.Second
  1146. failedDuration := time.Second
  1147. KeepaliveInterval := time.Duration(0)
  1148. CheckInterval := 500 * time.Millisecond
  1149. cfg := &AgentConfig{
  1150. Urls: []*stun.URI{},
  1151. NetworkTypes: supportedNetworkTypes(),
  1152. DisconnectedTimeout: &disconnectedDuration,
  1153. FailedTimeout: &failedDuration,
  1154. KeepaliveInterval: &KeepaliveInterval,
  1155. CheckInterval: &CheckInterval,
  1156. }
  1157. aAgent, err := NewAgent(cfg)
  1158. if err != nil {
  1159. t.Error(err)
  1160. }
  1161. bAgent, err := NewAgent(cfg)
  1162. if err != nil {
  1163. t.Error(err)
  1164. }
  1165. isClosed := make(chan interface{})
  1166. isConnected := make(chan interface{})
  1167. err = aAgent.OnConnectionStateChange(func(c ConnectionState) {
  1168. switch c {
  1169. case ConnectionStateConnected:
  1170. <-isConnected
  1171. assert.NoError(t, aAgent.Close())
  1172. case ConnectionStateClosed:
  1173. close(isClosed)
  1174. default:
  1175. }
  1176. })
  1177. if err != nil {
  1178. t.Error(err)
  1179. }
  1180. connect(aAgent, bAgent)
  1181. close(isConnected)
  1182. <-isClosed
  1183. assert.NoError(t, bAgent.Close())
  1184. }
  1185. func TestRunTaskInConnectionStateCallback(t *testing.T) {
  1186. report := test.CheckRoutines(t)
  1187. defer report()
  1188. lim := test.TimeOut(time.Second * 5)
  1189. defer lim.Stop()
  1190. oneSecond := time.Second
  1191. KeepaliveInterval := time.Duration(0)
  1192. CheckInterval := 50 * time.Millisecond
  1193. cfg := &AgentConfig{
  1194. Urls: []*stun.URI{},
  1195. NetworkTypes: supportedNetworkTypes(),
  1196. DisconnectedTimeout: &oneSecond,
  1197. FailedTimeout: &oneSecond,
  1198. KeepaliveInterval: &KeepaliveInterval,
  1199. CheckInterval: &CheckInterval,
  1200. }
  1201. aAgent, err := NewAgent(cfg)
  1202. check(err)
  1203. bAgent, err := NewAgent(cfg)
  1204. check(err)
  1205. isComplete := make(chan interface{})
  1206. err = aAgent.OnConnectionStateChange(func(c ConnectionState) {
  1207. if c == ConnectionStateConnected {
  1208. _, _, errCred := aAgent.GetLocalUserCredentials()
  1209. assert.NoError(t, errCred)
  1210. assert.NoError(t, aAgent.Restart("", ""))
  1211. close(isComplete)
  1212. }
  1213. })
  1214. if err != nil {
  1215. t.Error(err)
  1216. }
  1217. connect(aAgent, bAgent)
  1218. <-isComplete
  1219. assert.NoError(t, aAgent.Close())
  1220. assert.NoError(t, bAgent.Close())
  1221. }
  1222. func TestRunTaskInSelectedCandidatePairChangeCallback(t *testing.T) {
  1223. report := test.CheckRoutines(t)
  1224. defer report()
  1225. lim := test.TimeOut(time.Second * 5)
  1226. defer lim.Stop()
  1227. oneSecond := time.Second
  1228. KeepaliveInterval := time.Duration(0)
  1229. CheckInterval := 50 * time.Millisecond
  1230. cfg := &AgentConfig{
  1231. Urls: []*stun.URI{},
  1232. NetworkTypes: supportedNetworkTypes(),
  1233. DisconnectedTimeout: &oneSecond,
  1234. FailedTimeout: &oneSecond,
  1235. KeepaliveInterval: &KeepaliveInterval,
  1236. CheckInterval: &CheckInterval,
  1237. }
  1238. aAgent, err := NewAgent(cfg)
  1239. check(err)
  1240. bAgent, err := NewAgent(cfg)
  1241. check(err)
  1242. isComplete := make(chan interface{})
  1243. isTested := make(chan interface{})
  1244. if err = aAgent.OnSelectedCandidatePairChange(func(Candidate, Candidate) {
  1245. go func() {
  1246. _, _, errCred := aAgent.GetLocalUserCredentials()
  1247. assert.NoError(t, errCred)
  1248. close(isTested)
  1249. }()
  1250. }); err != nil {
  1251. t.Error(err)
  1252. }
  1253. if err = aAgent.OnConnectionStateChange(func(c ConnectionState) {
  1254. if c == ConnectionStateConnected {
  1255. close(isComplete)
  1256. }
  1257. }); err != nil {
  1258. t.Error(err)
  1259. }
  1260. connect(aAgent, bAgent)
  1261. <-isComplete
  1262. <-isTested
  1263. assert.NoError(t, aAgent.Close())
  1264. assert.NoError(t, bAgent.Close())
  1265. }
  1266. // Assert that a Lite agent goes to disconnected and failed
  1267. func TestLiteLifecycle(t *testing.T) {
  1268. report := test.CheckRoutines(t)
  1269. defer report()
  1270. lim := test.TimeOut(time.Second * 30)
  1271. defer lim.Stop()
  1272. aNotifier, aConnected := onConnected()
  1273. aAgent, err := NewAgent(&AgentConfig{
  1274. NetworkTypes: supportedNetworkTypes(),
  1275. MulticastDNSMode: MulticastDNSModeDisabled,
  1276. })
  1277. require.NoError(t, err)
  1278. require.NoError(t, aAgent.OnConnectionStateChange(aNotifier))
  1279. disconnectedDuration := time.Second
  1280. failedDuration := time.Second
  1281. KeepaliveInterval := time.Duration(0)
  1282. CheckInterval := 500 * time.Millisecond
  1283. bAgent, err := NewAgent(&AgentConfig{
  1284. Lite: true,
  1285. CandidateTypes: []CandidateType{CandidateTypeHost},
  1286. NetworkTypes: supportedNetworkTypes(),
  1287. MulticastDNSMode: MulticastDNSModeDisabled,
  1288. DisconnectedTimeout: &disconnectedDuration,
  1289. FailedTimeout: &failedDuration,
  1290. KeepaliveInterval: &KeepaliveInterval,
  1291. CheckInterval: &CheckInterval,
  1292. })
  1293. require.NoError(t, err)
  1294. bConnected := make(chan interface{})
  1295. bDisconnected := make(chan interface{})
  1296. bFailed := make(chan interface{})
  1297. require.NoError(t, bAgent.OnConnectionStateChange(func(c ConnectionState) {
  1298. switch c {
  1299. case ConnectionStateConnected:
  1300. close(bConnected)
  1301. case ConnectionStateDisconnected:
  1302. close(bDisconnected)
  1303. case ConnectionStateFailed:
  1304. close(bFailed)
  1305. default:
  1306. }
  1307. }))
  1308. connectWithVNet(bAgent, aAgent)
  1309. <-aConnected
  1310. <-bConnected
  1311. assert.NoError(t, aAgent.Close())
  1312. <-bDisconnected
  1313. <-bFailed
  1314. assert.NoError(t, bAgent.Close())
  1315. }
  1316. func TestNilCandidate(t *testing.T) {
  1317. a, err := NewAgent(&AgentConfig{})
  1318. assert.NoError(t, err)
  1319. assert.NoError(t, a.AddRemoteCandidate(nil))
  1320. assert.NoError(t, a.Close())
  1321. }
  1322. func TestNilCandidatePair(t *testing.T) {
  1323. a, err := NewAgent(&AgentConfig{})
  1324. assert.NoError(t, err)
  1325. a.setSelectedPair(nil)
  1326. assert.NoError(t, a.Close())
  1327. }
  1328. func TestGetSelectedCandidatePair(t *testing.T) {
  1329. report := test.CheckRoutines(t)
  1330. defer report()
  1331. lim := test.TimeOut(time.Second * 30)
  1332. defer lim.Stop()
  1333. wan, err := vnet.NewRouter(&vnet.RouterConfig{
  1334. CIDR: "0.0.0.0/0",
  1335. LoggerFactory: logging.NewDefaultLoggerFactory(),
  1336. })
  1337. assert.NoError(t, err)
  1338. net, err := vnet.NewNet(&vnet.NetConfig{
  1339. StaticIPs: []string{"192.168.0.1"},
  1340. })
  1341. assert.NoError(t, err)
  1342. assert.NoError(t, wan.AddNet(net))
  1343. assert.NoError(t, wan.Start())
  1344. cfg := &AgentConfig{
  1345. NetworkTypes: supportedNetworkTypes(),
  1346. Net: net,
  1347. }
  1348. aAgent, err := NewAgent(cfg)
  1349. assert.NoError(t, err)
  1350. bAgent, err := NewAgent(cfg)
  1351. assert.NoError(t, err)
  1352. aAgentPair, err := aAgent.GetSelectedCandidatePair()
  1353. assert.NoError(t, err)
  1354. assert.Nil(t, aAgentPair)
  1355. bAgentPair, err := bAgent.GetSelectedCandidatePair()
  1356. assert.NoError(t, err)
  1357. assert.Nil(t, bAgentPair)
  1358. connect(aAgent, bAgent)
  1359. aAgentPair, err = aAgent.GetSelectedCandidatePair()
  1360. assert.NoError(t, err)
  1361. assert.NotNil(t, aAgentPair)
  1362. bAgentPair, err = bAgent.GetSelectedCandidatePair()
  1363. assert.NoError(t, err)
  1364. assert.NotNil(t, bAgentPair)
  1365. assert.True(t, bAgentPair.Local.Equal(aAgentPair.Remote))
  1366. assert.True(t, bAgentPair.Remote.Equal(aAgentPair.Local))
  1367. assert.NoError(t, wan.Stop())
  1368. assert.NoError(t, aAgent.Close())
  1369. assert.NoError(t, bAgent.Close())
  1370. }
  1371. func TestAcceptAggressiveNomination(t *testing.T) {
  1372. report := test.CheckRoutines(t)
  1373. defer report()
  1374. lim := test.TimeOut(time.Second * 30)
  1375. defer lim.Stop()
  1376. // Create a network with two interfaces
  1377. wan, err := vnet.NewRouter(&vnet.RouterConfig{
  1378. CIDR: "0.0.0.0/0",
  1379. LoggerFactory: logging.NewDefaultLoggerFactory(),
  1380. })
  1381. assert.NoError(t, err)
  1382. net0, err := vnet.NewNet(&vnet.NetConfig{
  1383. StaticIPs: []string{"192.168.0.1"},
  1384. })
  1385. assert.NoError(t, err)
  1386. assert.NoError(t, wan.AddNet(net0))
  1387. net1, err := vnet.NewNet(&vnet.NetConfig{
  1388. StaticIPs: []string{"192.168.0.2", "192.168.0.3", "192.168.0.4"},
  1389. })
  1390. assert.NoError(t, err)
  1391. assert.NoError(t, wan.AddNet(net1))
  1392. assert.NoError(t, wan.Start())
  1393. aNotifier, aConnected := onConnected()
  1394. bNotifier, bConnected := onConnected()
  1395. KeepaliveInterval := time.Hour
  1396. cfg0 := &AgentConfig{
  1397. NetworkTypes: []NetworkType{NetworkTypeUDP4, NetworkTypeUDP6},
  1398. MulticastDNSMode: MulticastDNSModeDisabled,
  1399. Net: net0,
  1400. KeepaliveInterval: &KeepaliveInterval,
  1401. CheckInterval: &KeepaliveInterval,
  1402. AcceptAggressiveNomination: true,
  1403. }
  1404. var aAgent, bAgent *Agent
  1405. aAgent, err = NewAgent(cfg0)
  1406. require.NoError(t, err)
  1407. require.NoError(t, aAgent.OnConnectionStateChange(aNotifier))
  1408. cfg1 := &AgentConfig{
  1409. NetworkTypes: []NetworkType{NetworkTypeUDP4, NetworkTypeUDP6},
  1410. MulticastDNSMode: MulticastDNSModeDisabled,
  1411. Net: net1,
  1412. KeepaliveInterval: &KeepaliveInterval,
  1413. CheckInterval: &KeepaliveInterval,
  1414. }
  1415. bAgent, err = NewAgent(cfg1)
  1416. require.NoError(t, err)
  1417. require.NoError(t, bAgent.OnConnectionStateChange(bNotifier))
  1418. aConn, bConn := connect(aAgent, bAgent)
  1419. // Ensure pair selected
  1420. // Note: this assumes ConnectionStateConnected is thrown after selecting the final pair
  1421. <-aConnected
  1422. <-bConnected
  1423. // Send new USE-CANDIDATE message with higher priority to update the selected pair
  1424. buildMsg := func(class stun.MessageClass, username, key string, priority uint32) *stun.Message {
  1425. msg, err1 := stun.Build(stun.NewType(stun.MethodBinding, class), stun.TransactionID,
  1426. stun.NewUsername(username),
  1427. stun.NewShortTermIntegrity(key),
  1428. UseCandidate(),
  1429. PriorityAttr(priority),
  1430. stun.Fingerprint,
  1431. )
  1432. if err1 != nil {
  1433. t.Fatal(err1)
  1434. }
  1435. return msg
  1436. }
  1437. selectedCh := make(chan Candidate, 1)
  1438. var expectNewSelectedCandidate Candidate
  1439. err = aAgent.OnSelectedCandidatePairChange(func(_, remote Candidate) {
  1440. selectedCh <- remote
  1441. })
  1442. require.NoError(t, err)
  1443. var bcandidates []Candidate
  1444. bcandidates, err = bAgent.GetLocalCandidates()
  1445. require.NoError(t, err)
  1446. for _, c := range bcandidates {
  1447. if c != bAgent.getSelectedPair().Local {
  1448. if expectNewSelectedCandidate == nil {
  1449. incr_priority:
  1450. for _, candidates := range aAgent.remoteCandidates {
  1451. for _, candidate := range candidates {
  1452. if candidate.Equal(c) {
  1453. candidate.(*CandidateHost).priorityOverride += 1000 //nolint:forcetypeassert
  1454. break incr_priority
  1455. }
  1456. }
  1457. }
  1458. expectNewSelectedCandidate = c
  1459. }
  1460. _, err = c.writeTo(buildMsg(stun.ClassRequest, aAgent.localUfrag+":"+aAgent.remoteUfrag, aAgent.localPwd, c.Priority()).Raw, bAgent.getSelectedPair().Remote)
  1461. require.NoError(t, err)
  1462. }
  1463. }
  1464. time.Sleep(1 * time.Second)
  1465. select {
  1466. case selected := <-selectedCh:
  1467. assert.True(t, selected.Equal(expectNewSelectedCandidate))
  1468. default:
  1469. t.Fatal("No selected candidate pair")
  1470. }
  1471. assert.NoError(t, wan.Stop())
  1472. if !closePipe(t, aConn, bConn) {
  1473. return
  1474. }
  1475. }