github.com/MerlinKodo/quic-go@v0.39.2/internal/handshake/updatable_aead_test.go (about) 1 package handshake 2 3 import ( 4 "crypto/rand" 5 "crypto/tls" 6 "fmt" 7 "testing" 8 "time" 9 10 mocklogging "github.com/MerlinKodo/quic-go/internal/mocks/logging" 11 "github.com/MerlinKodo/quic-go/internal/protocol" 12 "github.com/MerlinKodo/quic-go/internal/qerr" 13 "github.com/MerlinKodo/quic-go/internal/utils" 14 "github.com/MerlinKodo/quic-go/logging" 15 16 . "github.com/onsi/ginkgo/v2" 17 . "github.com/onsi/gomega" 18 "go.uber.org/mock/gomock" 19 ) 20 21 var _ = Describe("Updatable AEAD", func() { 22 DescribeTable("ChaCha test vector", 23 func(v protocol.VersionNumber, expectedPayload, expectedPacket []byte) { 24 secret := splitHexString("9ac312a7f877468ebe69422748ad00a1 5443f18203a07d6060f688f30f21632b") 25 aead := newUpdatableAEAD(&utils.RTTStats{}, nil, nil, v) 26 chacha := cipherSuites[2] 27 Expect(chacha.ID).To(Equal(tls.TLS_CHACHA20_POLY1305_SHA256)) 28 aead.SetWriteKey(chacha, secret) 29 const pnOffset = 1 30 header := splitHexString("4200bff4") 31 payloadOffset := len(header) 32 plaintext := splitHexString("01") 33 payload := aead.Seal(nil, plaintext, 654360564, header) 34 Expect(payload).To(Equal(expectedPayload)) 35 packet := append(header, payload...) 36 aead.EncryptHeader(packet[pnOffset+4:pnOffset+4+16], &packet[0], packet[pnOffset:payloadOffset]) 37 Expect(packet).To(Equal(expectedPacket)) 38 }, 39 Entry("QUIC v1", 40 protocol.Version1, 41 splitHexString("655e5cd55c41f69080575d7999c25a5bfb"), 42 splitHexString("4cfe4189655e5cd55c41f69080575d7999c25a5bfb"), 43 ), 44 Entry("QUIC v2", 45 protocol.Version2, 46 splitHexString("0ae7b6b932bc27d786f4bc2bb20f2162ba"), 47 splitHexString("5558b1c60ae7b6b932bc27d786f4bc2bb20f2162ba"), 48 ), 49 ) 50 51 for _, ver := range []protocol.VersionNumber{protocol.Version1, protocol.Version2} { 52 v := ver 53 54 Context(fmt.Sprintf("using version %s", v), func() { 55 for i := range cipherSuites { 56 cs := cipherSuites[i] 57 58 Context(fmt.Sprintf("using %s", tls.CipherSuiteName(cs.ID)), func() { 59 var ( 60 client, server *updatableAEAD 61 serverTracer *mocklogging.MockConnectionTracer 62 rttStats *utils.RTTStats 63 ) 64 65 BeforeEach(func() { 66 var tr *logging.ConnectionTracer 67 tr, serverTracer = mocklogging.NewMockConnectionTracer(mockCtrl) 68 trafficSecret1 := make([]byte, 16) 69 trafficSecret2 := make([]byte, 16) 70 rand.Read(trafficSecret1) 71 rand.Read(trafficSecret2) 72 73 rttStats = utils.NewRTTStats() 74 client = newUpdatableAEAD(rttStats, nil, utils.DefaultLogger, v) 75 server = newUpdatableAEAD(rttStats, tr, utils.DefaultLogger, v) 76 client.SetReadKey(cs, trafficSecret2) 77 client.SetWriteKey(cs, trafficSecret1) 78 server.SetReadKey(cs, trafficSecret1) 79 server.SetWriteKey(cs, trafficSecret2) 80 }) 81 82 Context("header protection", func() { 83 It("encrypts and decrypts the header", func() { 84 var lastFiveBitsDifferent int 85 for i := 0; i < 100; i++ { 86 sample := make([]byte, 16) 87 rand.Read(sample) 88 header := []byte{0xb5, 1, 2, 3, 4, 5, 6, 7, 8, 0xde, 0xad, 0xbe, 0xef} 89 client.EncryptHeader(sample, &header[0], header[9:13]) 90 if header[0]&0x1f != 0xb5&0x1f { 91 lastFiveBitsDifferent++ 92 } 93 Expect(header[0] & 0xe0).To(Equal(byte(0xb5 & 0xe0))) 94 Expect(header[1:9]).To(Equal([]byte{1, 2, 3, 4, 5, 6, 7, 8})) 95 Expect(header[9:13]).ToNot(Equal([]byte{0xde, 0xad, 0xbe, 0xef})) 96 server.DecryptHeader(sample, &header[0], header[9:13]) 97 Expect(header).To(Equal([]byte{0xb5, 1, 2, 3, 4, 5, 6, 7, 8, 0xde, 0xad, 0xbe, 0xef})) 98 } 99 Expect(lastFiveBitsDifferent).To(BeNumerically(">", 75)) 100 }) 101 }) 102 103 Context("message encryption", func() { 104 var msg, ad []byte 105 106 BeforeEach(func() { 107 msg = []byte("Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.") 108 ad = []byte("Donec in velit neque.") 109 }) 110 111 It("encrypts and decrypts a message", func() { 112 encrypted := server.Seal(nil, msg, 0x1337, ad) 113 opened, err := client.Open(nil, encrypted, time.Now(), 0x1337, protocol.KeyPhaseZero, ad) 114 Expect(err).ToNot(HaveOccurred()) 115 Expect(opened).To(Equal(msg)) 116 }) 117 118 It("saves the first packet number", func() { 119 client.Seal(nil, msg, 0x1337, ad) 120 Expect(client.FirstPacketNumber()).To(Equal(protocol.PacketNumber(0x1337))) 121 client.Seal(nil, msg, 0x1338, ad) 122 Expect(client.FirstPacketNumber()).To(Equal(protocol.PacketNumber(0x1337))) 123 }) 124 125 It("fails to open a message if the associated data is not the same", func() { 126 encrypted := client.Seal(nil, msg, 0x1337, ad) 127 _, err := server.Open(nil, encrypted, time.Now(), 0x1337, protocol.KeyPhaseZero, []byte("wrong ad")) 128 Expect(err).To(MatchError(ErrDecryptionFailed)) 129 }) 130 131 It("fails to open a message if the packet number is not the same", func() { 132 encrypted := server.Seal(nil, msg, 0x1337, ad) 133 _, err := client.Open(nil, encrypted, time.Now(), 0x42, protocol.KeyPhaseZero, ad) 134 Expect(err).To(MatchError(ErrDecryptionFailed)) 135 }) 136 137 It("decodes the packet number", func() { 138 encrypted := server.Seal(nil, msg, 0x1337, ad) 139 _, err := client.Open(nil, encrypted, time.Now(), 0x1337, protocol.KeyPhaseZero, ad) 140 Expect(err).ToNot(HaveOccurred()) 141 Expect(client.DecodePacketNumber(0x38, protocol.PacketNumberLen1)).To(BeEquivalentTo(0x1338)) 142 }) 143 144 It("ignores packets it can't decrypt for packet number derivation", func() { 145 encrypted := server.Seal(nil, msg, 0x1337, ad) 146 _, err := client.Open(nil, encrypted[:len(encrypted)-1], time.Now(), 0x1337, protocol.KeyPhaseZero, ad) 147 Expect(err).To(HaveOccurred()) 148 Expect(client.DecodePacketNumber(0x38, protocol.PacketNumberLen1)).To(BeEquivalentTo(0x38)) 149 }) 150 151 It("returns an AEAD_LIMIT_REACHED error when reaching the AEAD limit", func() { 152 client.invalidPacketLimit = 10 153 for i := 0; i < 9; i++ { 154 _, err := client.Open(nil, []byte("foobar"), time.Now(), protocol.PacketNumber(i), protocol.KeyPhaseZero, []byte("ad")) 155 Expect(err).To(MatchError(ErrDecryptionFailed)) 156 } 157 _, err := client.Open(nil, []byte("foobar"), time.Now(), 10, protocol.KeyPhaseZero, []byte("ad")) 158 Expect(err).To(HaveOccurred()) 159 Expect(err).To(BeAssignableToTypeOf(&qerr.TransportError{})) 160 Expect(err.(*qerr.TransportError).ErrorCode).To(Equal(qerr.AEADLimitReached)) 161 }) 162 163 Context("key updates", func() { 164 Context("receiving key updates", func() { 165 It("updates keys", func() { 166 now := time.Now() 167 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 168 encrypted0 := server.Seal(nil, msg, 0x1337, ad) 169 server.rollKeys() 170 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 171 encrypted1 := server.Seal(nil, msg, 0x1337, ad) 172 Expect(encrypted0).ToNot(Equal(encrypted1)) 173 // expect opening to fail. The client didn't roll keys yet 174 _, err := client.Open(nil, encrypted1, now, 0x1337, protocol.KeyPhaseZero, ad) 175 Expect(err).To(MatchError(ErrDecryptionFailed)) 176 client.rollKeys() 177 decrypted, err := client.Open(nil, encrypted1, now, 0x1337, protocol.KeyPhaseOne, ad) 178 Expect(err).ToNot(HaveOccurred()) 179 Expect(decrypted).To(Equal(msg)) 180 }) 181 182 It("updates the keys when receiving a packet with the next key phase", func() { 183 now := time.Now() 184 // receive the first packet at key phase zero 185 encrypted0 := client.Seal(nil, msg, 0x42, ad) 186 decrypted, err := server.Open(nil, encrypted0, now, 0x42, protocol.KeyPhaseZero, ad) 187 Expect(err).ToNot(HaveOccurred()) 188 Expect(decrypted).To(Equal(msg)) 189 // send one packet at key phase zero 190 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 191 _ = server.Seal(nil, msg, 0x1, ad) 192 // now received a message at key phase one 193 client.rollKeys() 194 encrypted1 := client.Seal(nil, msg, 0x43, ad) 195 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(1), true) 196 decrypted, err = server.Open(nil, encrypted1, now, 0x43, protocol.KeyPhaseOne, ad) 197 Expect(err).ToNot(HaveOccurred()) 198 Expect(decrypted).To(Equal(msg)) 199 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 200 }) 201 202 It("opens a reordered packet with the old keys after an update", func() { 203 now := time.Now() 204 encrypted01 := client.Seal(nil, msg, 0x42, ad) 205 encrypted02 := client.Seal(nil, msg, 0x43, ad) 206 // receive the first packet with key phase 0 207 _, err := server.Open(nil, encrypted01, now, 0x42, protocol.KeyPhaseZero, ad) 208 Expect(err).ToNot(HaveOccurred()) 209 // send one packet at key phase zero 210 _ = server.Seal(nil, msg, 0x1, ad) 211 // now receive a packet with key phase 1 212 client.rollKeys() 213 encrypted1 := client.Seal(nil, msg, 0x44, ad) 214 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 215 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(1), true) 216 _, err = server.Open(nil, encrypted1, now, 0x44, protocol.KeyPhaseOne, ad) 217 Expect(err).ToNot(HaveOccurred()) 218 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 219 // now receive a reordered packet with key phase 0 220 decrypted, err := server.Open(nil, encrypted02, now, 0x43, protocol.KeyPhaseZero, ad) 221 Expect(err).ToNot(HaveOccurred()) 222 Expect(decrypted).To(Equal(msg)) 223 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 224 }) 225 226 It("drops keys 3 PTOs after a key update", func() { 227 now := time.Now() 228 rttStats.UpdateRTT(10*time.Millisecond, 0, now) 229 pto := rttStats.PTO(true) 230 encrypted01 := client.Seal(nil, msg, 0x42, ad) 231 encrypted02 := client.Seal(nil, msg, 0x43, ad) 232 // receive the first packet with key phase 0 233 _, err := server.Open(nil, encrypted01, now, 0x42, protocol.KeyPhaseZero, ad) 234 Expect(err).ToNot(HaveOccurred()) 235 // send one packet at key phase zero 236 _ = server.Seal(nil, msg, 0x1, ad) 237 // now receive a packet with key phase 1 238 client.rollKeys() 239 encrypted1 := client.Seal(nil, msg, 0x44, ad) 240 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 241 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(1), true) 242 serverTracer.EXPECT().DroppedKey(protocol.KeyPhase(0)) 243 _, err = server.Open(nil, encrypted1, now, 0x44, protocol.KeyPhaseOne, ad) 244 Expect(err).ToNot(HaveOccurred()) 245 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 246 // now receive a reordered packet with key phase 0 247 _, err = server.Open(nil, encrypted02, now.Add(3*pto).Add(time.Nanosecond), 0x43, protocol.KeyPhaseZero, ad) 248 Expect(err).To(MatchError(ErrKeysDropped)) 249 }) 250 251 It("allows the first key update immediately", func() { 252 // receive a packet at key phase one, before having sent or received any packets at key phase 0 253 client.rollKeys() 254 encrypted1 := client.Seal(nil, msg, 0x1337, ad) 255 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(1), true) 256 _, err := server.Open(nil, encrypted1, time.Now(), 0x1337, protocol.KeyPhaseOne, ad) 257 Expect(err).ToNot(HaveOccurred()) 258 }) 259 260 It("only errors when the peer starts with key phase 1 if decrypting the packet succeeds", func() { 261 client.rollKeys() 262 encrypted := client.Seal(nil, msg, 0x1337, ad) 263 encrypted = encrypted[:len(encrypted)-1] 264 _, err := server.Open(nil, encrypted, time.Now(), 0x1337, protocol.KeyPhaseOne, ad) 265 Expect(err).To(MatchError(ErrDecryptionFailed)) 266 }) 267 268 It("errors when the peer updates keys too frequently", func() { 269 server.rollKeys() 270 client.rollKeys() 271 // receive the first packet at key phase one 272 encrypted0 := client.Seal(nil, msg, 0x42, ad) 273 _, err := server.Open(nil, encrypted0, time.Now(), 0x42, protocol.KeyPhaseOne, ad) 274 Expect(err).ToNot(HaveOccurred()) 275 // now receive a packet at key phase two, before having sent any packets 276 client.rollKeys() 277 encrypted1 := client.Seal(nil, msg, 0x42, ad) 278 _, err = server.Open(nil, encrypted1, time.Now(), 0x42, protocol.KeyPhaseZero, ad) 279 Expect(err).To(MatchError(&qerr.TransportError{ 280 ErrorCode: qerr.KeyUpdateError, 281 ErrorMessage: "keys updated too quickly", 282 })) 283 }) 284 }) 285 286 Context("initiating key updates", func() { 287 const firstKeyUpdateInterval = 5 288 const keyUpdateInterval = 20 289 var origKeyUpdateInterval, origFirstKeyUpdateInterval uint64 290 291 BeforeEach(func() { 292 origKeyUpdateInterval = KeyUpdateInterval 293 origFirstKeyUpdateInterval = FirstKeyUpdateInterval 294 KeyUpdateInterval = keyUpdateInterval 295 FirstKeyUpdateInterval = firstKeyUpdateInterval 296 server.SetHandshakeConfirmed() 297 }) 298 299 AfterEach(func() { 300 KeyUpdateInterval = origKeyUpdateInterval 301 FirstKeyUpdateInterval = origFirstKeyUpdateInterval 302 }) 303 304 It("initiates a key update after sealing the maximum number of packets, for the first update", func() { 305 for i := 0; i < firstKeyUpdateInterval; i++ { 306 pn := protocol.PacketNumber(i) 307 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 308 server.Seal(nil, msg, pn, ad) 309 } 310 // the first update is allowed without receiving an acknowledgement 311 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(1), false) 312 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 313 }) 314 315 It("initiates a key update after sealing the maximum number of packets, for subsequent updates", func() { 316 server.rollKeys() 317 client.rollKeys() 318 for i := 0; i < keyUpdateInterval; i++ { 319 pn := protocol.PacketNumber(i) 320 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 321 server.Seal(nil, msg, pn, ad) 322 } 323 // no update allowed before receiving an acknowledgement for the current key phase 324 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 325 // receive an ACK for a packet sent in key phase 0 326 b := client.Seal(nil, []byte("foobar"), 1, []byte("ad")) 327 _, err := server.Open(nil, b, time.Now(), 1, protocol.KeyPhaseOne, []byte("ad")) 328 Expect(err).ToNot(HaveOccurred()) 329 ExpectWithOffset(1, server.SetLargestAcked(0)).To(Succeed()) 330 serverTracer.EXPECT().DroppedKey(protocol.KeyPhase(0)) 331 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(2), false) 332 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 333 }) 334 335 It("errors if the peer acknowledges a packet sent in the next key phase using the old key phase", func() { 336 // First make sure that we update our keys. 337 for i := 0; i < firstKeyUpdateInterval; i++ { 338 pn := protocol.PacketNumber(i) 339 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 340 server.Seal(nil, msg, pn, ad) 341 } 342 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(1), false) 343 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 344 // Now that our keys are updated, send a packet using the new keys. 345 const nextPN = firstKeyUpdateInterval + 1 346 server.Seal(nil, msg, nextPN, ad) 347 // We haven't decrypted any packet in the new key phase yet. 348 // This means that the ACK must have been sent in the old key phase. 349 Expect(server.SetLargestAcked(nextPN)).To(MatchError(&qerr.TransportError{ 350 ErrorCode: qerr.KeyUpdateError, 351 ErrorMessage: "received ACK for key phase 1, but peer didn't update keys", 352 })) 353 }) 354 355 It("doesn't error before actually sending a packet in the new key phase", func() { 356 // First make sure that we update our keys. 357 for i := 0; i < firstKeyUpdateInterval; i++ { 358 pn := protocol.PacketNumber(i) 359 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 360 server.Seal(nil, msg, pn, ad) 361 } 362 b := client.Seal(nil, []byte("foobar"), 1, []byte("ad")) 363 _, err := server.Open(nil, b, time.Now(), 1, protocol.KeyPhaseZero, []byte("ad")) 364 Expect(err).ToNot(HaveOccurred()) 365 ExpectWithOffset(1, server.SetLargestAcked(0)).To(Succeed()) 366 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(1), false) 367 // Now that our keys are updated, send a packet using the new keys. 368 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 369 // We haven't decrypted any packet in the new key phase yet. 370 // This means that the ACK must have been sent in the old key phase. 371 Expect(server.SetLargestAcked(1)).ToNot(HaveOccurred()) 372 }) 373 374 It("initiates a key update after opening the maximum number of packets, for the first update", func() { 375 for i := 0; i < firstKeyUpdateInterval; i++ { 376 pn := protocol.PacketNumber(i) 377 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 378 encrypted := client.Seal(nil, msg, pn, ad) 379 _, err := server.Open(nil, encrypted, time.Now(), pn, protocol.KeyPhaseZero, ad) 380 Expect(err).ToNot(HaveOccurred()) 381 } 382 // the first update is allowed without receiving an acknowledgement 383 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(1), false) 384 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 385 }) 386 387 It("initiates a key update after opening the maximum number of packets, for subsequent updates", func() { 388 server.rollKeys() 389 client.rollKeys() 390 for i := 0; i < keyUpdateInterval; i++ { 391 pn := protocol.PacketNumber(i) 392 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 393 encrypted := client.Seal(nil, msg, pn, ad) 394 _, err := server.Open(nil, encrypted, time.Now(), pn, protocol.KeyPhaseOne, ad) 395 Expect(err).ToNot(HaveOccurred()) 396 } 397 // no update allowed before receiving an acknowledgement for the current key phase 398 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 399 server.Seal(nil, msg, 1, ad) 400 Expect(server.SetLargestAcked(1)).To(Succeed()) 401 serverTracer.EXPECT().DroppedKey(protocol.KeyPhase(0)) 402 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(2), false) 403 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 404 }) 405 406 It("drops keys 3 PTOs after a key update", func() { 407 now := time.Now() 408 for i := 0; i < firstKeyUpdateInterval; i++ { 409 pn := protocol.PacketNumber(i) 410 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 411 server.Seal(nil, msg, pn, ad) 412 } 413 b := client.Seal(nil, []byte("foobar"), 1, []byte("ad")) 414 _, err := server.Open(nil, b, now, 1, protocol.KeyPhaseZero, []byte("ad")) 415 Expect(err).ToNot(HaveOccurred()) 416 Expect(server.SetLargestAcked(0)).To(Succeed()) 417 // Now we've initiated the first key update. 418 // Decrypt a message sent from the client more than 3 PTO later to make sure the key is still there 419 threePTO := 3 * rttStats.PTO(false) 420 dataKeyPhaseZero := client.Seal(nil, msg, 1, ad) 421 _, err = server.Open(nil, dataKeyPhaseZero, now.Add(threePTO).Add(time.Second), 1, protocol.KeyPhaseZero, ad) 422 Expect(err).ToNot(HaveOccurred()) 423 // Now receive a packet with key phase 1. 424 // This should start the timer to drop the keys after 3 PTOs. 425 client.rollKeys() 426 dataKeyPhaseOne := client.Seal(nil, msg, 10, ad) 427 t := now.Add(threePTO).Add(time.Second) 428 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(1), true) 429 _, err = server.Open(nil, dataKeyPhaseOne, t, 10, protocol.KeyPhaseOne, ad) 430 Expect(err).ToNot(HaveOccurred()) 431 // Make sure the keys are still here. 432 _, err = server.Open(nil, dataKeyPhaseZero, t.Add(threePTO*9/10), 1, protocol.KeyPhaseZero, ad) 433 Expect(err).ToNot(HaveOccurred()) 434 serverTracer.EXPECT().DroppedKey(protocol.KeyPhase(0)) 435 _, err = server.Open(nil, dataKeyPhaseZero, t.Add(threePTO).Add(time.Nanosecond), 1, protocol.KeyPhaseZero, ad) 436 Expect(err).To(MatchError(ErrKeysDropped)) 437 }) 438 439 It("doesn't drop the first key generation too early", func() { 440 now := time.Now() 441 data1 := client.Seal(nil, msg, 1, ad) 442 _, err := server.Open(nil, data1, now, 1, protocol.KeyPhaseZero, ad) 443 Expect(err).ToNot(HaveOccurred()) 444 for i := 0; i < firstKeyUpdateInterval; i++ { 445 pn := protocol.PacketNumber(i) 446 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 447 server.Seal(nil, msg, pn, ad) 448 Expect(server.SetLargestAcked(pn)).To(Succeed()) 449 } 450 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(1), false) 451 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 452 // The server never received a packet at key phase 1. 453 // Make sure the key phase 0 is still there at a much later point. 454 data2 := client.Seal(nil, msg, 1, ad) 455 _, err = server.Open(nil, data2, now.Add(10*rttStats.PTO(true)), 1, protocol.KeyPhaseZero, ad) 456 Expect(err).ToNot(HaveOccurred()) 457 }) 458 459 It("drops keys early when the peer forces initiates a key update within the 3 PTO period", func() { 460 for i := 0; i < firstKeyUpdateInterval; i++ { 461 pn := protocol.PacketNumber(i) 462 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 463 server.Seal(nil, msg, pn, ad) 464 } 465 b := client.Seal(nil, []byte("foobar"), 1, []byte("ad")) 466 _, err := server.Open(nil, b, time.Now(), 1, protocol.KeyPhaseZero, []byte("ad")) 467 Expect(err).ToNot(HaveOccurred()) 468 ExpectWithOffset(1, server.SetLargestAcked(0)).To(Succeed()) 469 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(1), false) 470 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 471 const nextPN = keyUpdateInterval + 1 472 // Send and receive an acknowledgement for a packet in key phase 1. 473 // We are now running a timer to drop the keys with 3 PTO. 474 server.Seal(nil, msg, nextPN, ad) 475 client.rollKeys() 476 dataKeyPhaseOne := client.Seal(nil, msg, 2, ad) 477 now := time.Now() 478 _, err = server.Open(nil, dataKeyPhaseOne, now, 2, protocol.KeyPhaseOne, ad) 479 Expect(err).ToNot(HaveOccurred()) 480 Expect(server.SetLargestAcked(nextPN)) 481 // Now the client sends us a packet in key phase 2, forcing us to update keys before the 3 PTO period is over. 482 // This mean that we need to drop the keys for key phase 0 immediately. 483 client.rollKeys() 484 dataKeyPhaseTwo := client.Seal(nil, msg, 3, ad) 485 gomock.InOrder( 486 serverTracer.EXPECT().DroppedKey(protocol.KeyPhase(0)), 487 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(2), true), 488 ) 489 _, err = server.Open(nil, dataKeyPhaseTwo, now, 3, protocol.KeyPhaseZero, ad) 490 Expect(err).ToNot(HaveOccurred()) 491 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 492 }) 493 494 It("drops keys early when we initiate another key update within the 3 PTO period", func() { 495 server.SetHandshakeConfirmed() 496 // send so many packets that we initiate the first key update 497 for i := 0; i < firstKeyUpdateInterval; i++ { 498 pn := protocol.PacketNumber(i) 499 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 500 server.Seal(nil, msg, pn, ad) 501 } 502 b := client.Seal(nil, []byte("foobar"), 1, []byte("ad")) 503 _, err := server.Open(nil, b, time.Now(), 1, protocol.KeyPhaseZero, []byte("ad")) 504 Expect(err).ToNot(HaveOccurred()) 505 ExpectWithOffset(1, server.SetLargestAcked(0)).To(Succeed()) 506 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(1), false) 507 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 508 // send so many packets that we initiate the next key update 509 for i := keyUpdateInterval; i < 2*keyUpdateInterval; i++ { 510 pn := protocol.PacketNumber(i) 511 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseOne)) 512 server.Seal(nil, msg, pn, ad) 513 } 514 client.rollKeys() 515 b = client.Seal(nil, []byte("foobar"), 2, []byte("ad")) 516 now := time.Now() 517 _, err = server.Open(nil, b, now, 2, protocol.KeyPhaseOne, []byte("ad")) 518 Expect(err).ToNot(HaveOccurred()) 519 ExpectWithOffset(1, server.SetLargestAcked(keyUpdateInterval)).To(Succeed()) 520 gomock.InOrder( 521 serverTracer.EXPECT().DroppedKey(protocol.KeyPhase(0)), 522 serverTracer.EXPECT().UpdatedKey(protocol.KeyPhase(2), false), 523 ) 524 Expect(server.KeyPhase()).To(Equal(protocol.KeyPhaseZero)) 525 // We haven't received an ACK for a packet sent in key phase 2 yet. 526 // Make sure we canceled the timer to drop the previous key phase. 527 b = client.Seal(nil, []byte("foobar"), 3, []byte("ad")) 528 _, err = server.Open(nil, b, now.Add(10*rttStats.PTO(true)), 3, protocol.KeyPhaseOne, []byte("ad")) 529 Expect(err).ToNot(HaveOccurred()) 530 }) 531 }) 532 }) 533 }) 534 }) 535 } 536 }) 537 } 538 }) 539 540 func getClientAndServer() (client, server *updatableAEAD) { 541 trafficSecret1 := make([]byte, 16) 542 trafficSecret2 := make([]byte, 16) 543 rand.Read(trafficSecret1) 544 rand.Read(trafficSecret2) 545 546 cs := cipherSuites[0] 547 rttStats := utils.NewRTTStats() 548 client = newUpdatableAEAD(rttStats, nil, utils.DefaultLogger, protocol.Version1) 549 server = newUpdatableAEAD(rttStats, nil, utils.DefaultLogger, protocol.Version1) 550 client.SetReadKey(cs, trafficSecret2) 551 client.SetWriteKey(cs, trafficSecret1) 552 server.SetReadKey(cs, trafficSecret1) 553 server.SetWriteKey(cs, trafficSecret2) 554 return 555 } 556 557 func BenchmarkPacketEncryption(b *testing.B) { 558 client, _ := getClientAndServer() 559 const l = 1200 560 src := make([]byte, l) 561 rand.Read(src) 562 ad := make([]byte, 32) 563 rand.Read(ad) 564 565 for i := 0; i < b.N; i++ { 566 src = client.Seal(src[:0], src[:l], protocol.PacketNumber(i), ad) 567 } 568 } 569 570 func BenchmarkPacketDecryption(b *testing.B) { 571 client, server := getClientAndServer() 572 const l = 1200 573 src := make([]byte, l) 574 dst := make([]byte, l) 575 rand.Read(src) 576 ad := make([]byte, 32) 577 rand.Read(ad) 578 src = client.Seal(src[:0], src[:l], 1337, ad) 579 580 for i := 0; i < b.N; i++ { 581 if _, err := server.Open(dst[:0], src, time.Time{}, 1337, protocol.KeyPhaseZero, ad); err != nil { 582 b.Fatalf("opening failed: %v", err) 583 } 584 } 585 } 586 587 func BenchmarkRollKeys(b *testing.B) { 588 client, _ := getClientAndServer() 589 for i := 0; i < b.N; i++ { 590 client.rollKeys() 591 } 592 if int(client.keyPhase) != b.N { 593 b.Fatal("didn't roll keys often enough") 594 } 595 }