You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

CapabilitiesHandlerTest.kt 14KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349
  1. package com.dmdirc.ktirc.events.handlers
  2. import com.dmdirc.ktirc.IrcClient
  3. import com.dmdirc.ktirc.TestConstants
  4. import com.dmdirc.ktirc.events.*
  5. import com.dmdirc.ktirc.model.CapabilitiesNegotiationState
  6. import com.dmdirc.ktirc.model.Capability
  7. import com.dmdirc.ktirc.model.ServerState
  8. import com.dmdirc.ktirc.sasl.SaslMechanism
  9. import com.dmdirc.ktirc.sasl.fromBase64
  10. import com.dmdirc.ktirc.sasl.toBase64
  11. import io.mockk.*
  12. import org.junit.jupiter.api.Assertions.*
  13. import org.junit.jupiter.api.Test
  14. internal class CapabilitiesHandlerTest {
  15. private val saslMech1 = mockk<SaslMechanism> {
  16. every { priority } returns 1
  17. every { ircName } returns "mech1"
  18. }
  19. private val saslMech2 = mockk<SaslMechanism> {
  20. every { priority } returns 2
  21. every { ircName } returns "mech2"
  22. }
  23. private val saslMech3 = mockk<SaslMechanism> {
  24. every { priority } returns 3
  25. every { ircName } returns "mech3"
  26. }
  27. private val handler = CapabilitiesHandler()
  28. private val fakeServerState = ServerState("", "", null)
  29. private val ircClient = mockk<IrcClient> {
  30. every { serverState } returns fakeServerState
  31. }
  32. @Test
  33. fun `adds new capabilities to the state`() {
  34. handler.processEvent(ircClient, ServerCapabilitiesReceived(EventMetadata(TestConstants.time), hashMapOf(
  35. Capability.EchoMessages.names[0] to "",
  36. Capability.HostsInNamesReply.names[0] to "123"
  37. )))
  38. assertEquals(2, fakeServerState.capabilities.advertisedCapabilities.size)
  39. assertEquals("", fakeServerState.capabilities.advertisedCapabilities[Capability.EchoMessages.names[0]])
  40. assertEquals("123", fakeServerState.capabilities.advertisedCapabilities[Capability.HostsInNamesReply.names[0]])
  41. }
  42. @Test
  43. fun `updates negotiation state when capabilities finished`() {
  44. fakeServerState.capabilities.advertisedCapabilities[Capability.EchoMessages.names[0]] = ""
  45. handler.processEvent(ircClient, ServerCapabilitiesFinished(EventMetadata(TestConstants.time)))
  46. assertEquals(CapabilitiesNegotiationState.AWAITING_ACK, fakeServerState.capabilities.negotiationState)
  47. }
  48. @Test
  49. fun `sends REQ when capabilities received`() {
  50. fakeServerState.capabilities.advertisedCapabilities[Capability.EchoMessages.names[0]] = ""
  51. fakeServerState.capabilities.advertisedCapabilities[Capability.AccountChangeMessages.names[0]] = ""
  52. handler.processEvent(ircClient, ServerCapabilitiesFinished(EventMetadata(TestConstants.time)))
  53. verify {
  54. ircClient.send(eq("CAP"), eq("REQ"), or(eq("echo-message account-notify"), eq("account-notify echo-message")))
  55. }
  56. }
  57. @Test
  58. fun `sends END when blank capabilities received`() {
  59. handler.processEvent(ircClient, ServerCapabilitiesFinished(EventMetadata(TestConstants.time)))
  60. verify {
  61. ircClient.send("CAP", "END")
  62. }
  63. }
  64. @Test
  65. fun `updates negotiation when blank capabilities received`() {
  66. handler.processEvent(ircClient, ServerCapabilitiesFinished(EventMetadata(TestConstants.time)))
  67. assertEquals(CapabilitiesNegotiationState.FINISHED, fakeServerState.capabilities.negotiationState)
  68. }
  69. @Test
  70. fun `sends END when capabilities acknowledged and no enabled mechanisms`() {
  71. handler.processEvent(ircClient, ServerCapabilitiesAcknowledged(EventMetadata(TestConstants.time), hashMapOf(
  72. Capability.EchoMessages.names[0] to "",
  73. Capability.HostsInNamesReply.names[0] to ""
  74. )))
  75. verify {
  76. ircClient.send("CAP", "END")
  77. }
  78. }
  79. @Test
  80. fun `sends END when capabilities acknowledged and no sasl state`() {
  81. fakeServerState.sasl.mechanisms.addAll(listOf(saslMech1, saslMech2, saslMech3))
  82. handler.processEvent(ircClient, ServerCapabilitiesAcknowledged(EventMetadata(TestConstants.time), hashMapOf(
  83. Capability.EchoMessages.names[0] to "",
  84. Capability.HostsInNamesReply.names[0] to ""
  85. )))
  86. verify {
  87. ircClient.send("CAP", "END")
  88. }
  89. }
  90. @Test
  91. fun `sends END when capabilities acknowledged and no shared mechanism`() {
  92. fakeServerState.sasl.mechanisms.addAll(listOf(saslMech1, saslMech2, saslMech3))
  93. fakeServerState.capabilities.advertisedCapabilities[Capability.SaslAuthentication.names[0]] = "fake1,fake2"
  94. handler.processEvent(ircClient, ServerCapabilitiesAcknowledged(EventMetadata(TestConstants.time), hashMapOf(
  95. Capability.SaslAuthentication.names[0] to "",
  96. Capability.HostsInNamesReply.names[0] to ""
  97. )))
  98. verify {
  99. ircClient.send("CAP", "END")
  100. }
  101. }
  102. @Test
  103. fun `sets current SASL mechanism when capabilities acknowledged with shared mechanism`() {
  104. fakeServerState.sasl.mechanisms.addAll(listOf(saslMech1, saslMech2, saslMech3))
  105. fakeServerState.capabilities.advertisedCapabilities[Capability.SaslAuthentication.names[0]] = "mech1,fake2"
  106. handler.processEvent(ircClient, ServerCapabilitiesAcknowledged(EventMetadata(TestConstants.time), hashMapOf(
  107. Capability.SaslAuthentication.names[0] to "",
  108. Capability.HostsInNamesReply.names[0] to ""
  109. )))
  110. assertSame(saslMech1, fakeServerState.sasl.currentMechanism)
  111. }
  112. @Test
  113. fun `sets current SASL mechanism when capabilities acknowledged with no declared mechanisms`() {
  114. fakeServerState.sasl.mechanisms.addAll(listOf(saslMech1, saslMech2, saslMech3))
  115. fakeServerState.capabilities.advertisedCapabilities[Capability.SaslAuthentication.names[0]] = ""
  116. handler.processEvent(ircClient, ServerCapabilitiesAcknowledged(EventMetadata(TestConstants.time), hashMapOf(
  117. Capability.SaslAuthentication.names[0] to "",
  118. Capability.HostsInNamesReply.names[0] to ""
  119. )))
  120. assertSame(saslMech3, fakeServerState.sasl.currentMechanism)
  121. }
  122. @Test
  123. fun `sends authenticate when capabilities acknowledged with shared mechanism`() {
  124. fakeServerState.sasl.mechanisms.addAll(listOf(saslMech1, saslMech2, saslMech3))
  125. fakeServerState.capabilities.advertisedCapabilities[Capability.SaslAuthentication.names[0]] = "mech1,fake2"
  126. handler.processEvent(ircClient, ServerCapabilitiesAcknowledged(EventMetadata(TestConstants.time), hashMapOf(
  127. Capability.SaslAuthentication.names[0] to "",
  128. Capability.HostsInNamesReply.names[0] to ""
  129. )))
  130. verify {
  131. ircClient.send("AUTHENTICATE", "mech1")
  132. }
  133. }
  134. @Test
  135. fun `sends authenticate when capabilities acknowledged with no declared mechanisms`() {
  136. fakeServerState.sasl.mechanisms.addAll(listOf(saslMech1, saslMech2, saslMech3))
  137. fakeServerState.capabilities.advertisedCapabilities[Capability.SaslAuthentication.names[0]] = ""
  138. handler.processEvent(ircClient, ServerCapabilitiesAcknowledged(EventMetadata(TestConstants.time), hashMapOf(
  139. Capability.SaslAuthentication.names[0] to "",
  140. Capability.HostsInNamesReply.names[0] to ""
  141. )))
  142. verify {
  143. ircClient.send("AUTHENTICATE", "mech3")
  144. }
  145. }
  146. @Test
  147. fun `updates negotiation state when capabilities acknowledged with shared mechanism`() {
  148. fakeServerState.sasl.mechanisms.addAll(listOf(saslMech1, saslMech2, saslMech3))
  149. fakeServerState.capabilities.advertisedCapabilities[Capability.SaslAuthentication.names[0]] = "mech1,fake2"
  150. handler.processEvent(ircClient, ServerCapabilitiesAcknowledged(EventMetadata(TestConstants.time), hashMapOf(
  151. Capability.SaslAuthentication.names[0] to "",
  152. Capability.HostsInNamesReply.names[0] to ""
  153. )))
  154. assertEquals(CapabilitiesNegotiationState.AUTHENTICATING, fakeServerState.capabilities.negotiationState)
  155. }
  156. @Test
  157. fun `updates negotiation state when capabilities acknowledged`() {
  158. handler.processEvent(ircClient, ServerCapabilitiesAcknowledged(EventMetadata(TestConstants.time), hashMapOf(
  159. Capability.EchoMessages.names[0] to "",
  160. Capability.HostsInNamesReply.names[0] to "123"
  161. )))
  162. assertEquals(CapabilitiesNegotiationState.FINISHED, fakeServerState.capabilities.negotiationState)
  163. }
  164. @Test
  165. fun `stores enabled caps when capabilities acknowledged`() {
  166. handler.processEvent(ircClient, ServerCapabilitiesAcknowledged(EventMetadata(TestConstants.time), hashMapOf(
  167. Capability.EchoMessages.names[0] to "",
  168. Capability.HostsInNamesReply.names[0] to "123"
  169. )))
  170. assertEquals(2, fakeServerState.capabilities.enabledCapabilities.size)
  171. assertEquals("", fakeServerState.capabilities.enabledCapabilities[Capability.EchoMessages])
  172. assertEquals("123", fakeServerState.capabilities.enabledCapabilities[Capability.HostsInNamesReply])
  173. }
  174. @Test
  175. fun `aborts authentication attempt if not expecting one`() {
  176. fakeServerState.sasl.currentMechanism = null
  177. handler.processEvent(ircClient, AuthenticationMessage(EventMetadata(TestConstants.time), "+"))
  178. verify {
  179. ircClient.send("AUTHENTICATE", "*")
  180. }
  181. }
  182. @Test
  183. fun `passes authentication message to mechanism if in auth process`() {
  184. fakeServerState.sasl.currentMechanism = saslMech1
  185. val argument = "ABC"
  186. handler.processEvent(ircClient, AuthenticationMessage(EventMetadata(TestConstants.time), argument))
  187. verify {
  188. saslMech1.handleAuthenticationEvent(ircClient, argument.fromBase64())
  189. }
  190. }
  191. @Test
  192. fun `stores partial authentication message if it's 400 bytes long`() {
  193. fakeServerState.sasl.currentMechanism = saslMech1
  194. val argument = "A".repeat(400)
  195. handler.processEvent(ircClient, AuthenticationMessage(EventMetadata(TestConstants.time), argument))
  196. assertEquals(argument, fakeServerState.sasl.saslBuffer)
  197. verify(inverse = true) {
  198. saslMech1.handleAuthenticationEvent(any(), any())
  199. }
  200. }
  201. @Test
  202. fun `appends authentication messages if it's 400 bytes long and data already exists`() {
  203. fakeServerState.sasl.currentMechanism = saslMech1
  204. fakeServerState.sasl.saslBuffer = "A".repeat(400)
  205. handler.processEvent(ircClient, AuthenticationMessage(EventMetadata(TestConstants.time), "B".repeat(400)))
  206. assertEquals("A".repeat(400) + "B".repeat(400), fakeServerState.sasl.saslBuffer)
  207. verify(inverse = true) {
  208. saslMech1.handleAuthenticationEvent(any(), any())
  209. }
  210. }
  211. @Test
  212. fun `reconstructs partial authentication message to mechanism if data stored and partial received`() {
  213. fakeServerState.sasl.currentMechanism = saslMech1
  214. fakeServerState.sasl.saslBuffer = "A".repeat(400)
  215. val slot = slot<ByteArray>()
  216. every { saslMech1.handleAuthenticationEvent(eq(ircClient), capture(slot)) } just Runs
  217. val argument = "ABCD"
  218. handler.processEvent(ircClient, AuthenticationMessage(EventMetadata(TestConstants.time), argument))
  219. assertEquals("A".repeat(400) + "ABCD", slot.captured.toBase64())
  220. }
  221. @Test
  222. fun `reconstructs partial authentication message to mechanism if data stored and null received`() {
  223. fakeServerState.sasl.currentMechanism = saslMech1
  224. fakeServerState.sasl.saslBuffer = "A".repeat(400)
  225. val slot = slot<ByteArray>()
  226. every { saslMech1.handleAuthenticationEvent(eq(ircClient), capture(slot)) } just Runs
  227. handler.processEvent(ircClient, AuthenticationMessage(EventMetadata(TestConstants.time), null))
  228. assertEquals("A".repeat(400), slot.captured.toBase64())
  229. }
  230. @Test
  231. fun `sends END when SASL auth finished`() {
  232. handler.processEvent(ircClient, SaslFinished(EventMetadata(TestConstants.time), true))
  233. verify {
  234. ircClient.send("CAP", "END")
  235. }
  236. }
  237. @Test
  238. fun `sets negotiation state when SASL auth finished`() {
  239. handler.processEvent(ircClient, SaslFinished(EventMetadata(TestConstants.time), true))
  240. assertEquals(CapabilitiesNegotiationState.FINISHED, fakeServerState.capabilities.negotiationState)
  241. }
  242. @Test
  243. fun `resets SASL state when SASL auth finished`() {
  244. with (fakeServerState.sasl) {
  245. currentMechanism = saslMech1
  246. saslBuffer = "HackThePlanet"
  247. mechanismState = "root@thegibson"
  248. }
  249. handler.processEvent(ircClient, SaslFinished(EventMetadata(TestConstants.time), true))
  250. with (fakeServerState.sasl) {
  251. assertNull(currentMechanism)
  252. assertEquals("", saslBuffer)
  253. assertNull(mechanismState)
  254. }
  255. }
  256. @Test
  257. fun `sends a new authenticate request when sasl mechanism rejected and new one is acceptable`() {
  258. fakeServerState.sasl.mechanisms.addAll(listOf(saslMech1, saslMech2, saslMech3))
  259. handler.processEvent(ircClient, SaslMechanismNotAvailableError(EventMetadata(TestConstants.time), listOf("mech1", "fake2")))
  260. verify {
  261. ircClient.send("AUTHENTICATE", "mech1")
  262. }
  263. }
  264. @Test
  265. fun `sends cap end when sasl mechanism rejected and no new one is acceptable`() {
  266. fakeServerState.sasl.mechanisms.addAll(listOf(saslMech1, saslMech2, saslMech3))
  267. handler.processEvent(ircClient, SaslMechanismNotAvailableError(EventMetadata(TestConstants.time), listOf("fake1", "fake2")))
  268. verify {
  269. ircClient.send("CAP", "END")
  270. }
  271. }
  272. @Test
  273. fun `sets negotiation state when sasl mechanism rejected and no new one is acceptable`() {
  274. fakeServerState.sasl.mechanisms.addAll(listOf(saslMech1, saslMech2, saslMech3))
  275. handler.processEvent(ircClient, SaslMechanismNotAvailableError(EventMetadata(TestConstants.time), listOf("fake1", "fake2")))
  276. assertEquals(CapabilitiesNegotiationState.FINISHED, fakeServerState.capabilities.negotiationState)
  277. }
  278. }