mirror of
https://github.com/facebookincubator/mvfst.git
synced 2025-04-18 17:24:03 +03:00
2660a288b3
Summary: - as title Reviewed By: lnicco Differential Revision: D33513410 fbshipit-source-id: 282b6f512cf83b9abb7990402661135b658f7bd1
97 lines
2.6 KiB
C++
97 lines
2.6 KiB
C++
/*
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <folly/Optional.h>
|
|
#include <folly/io/Cursor.h>
|
|
#include <quic/common/BufUtil.h>
|
|
|
|
namespace quic {
|
|
|
|
using HeaderProtectionMask = std::array<uint8_t, 16>;
|
|
using Sample = std::array<uint8_t, 16>;
|
|
|
|
class PacketNumberCipher {
|
|
public:
|
|
virtual ~PacketNumberCipher() = default;
|
|
|
|
virtual void setKey(folly::ByteRange key) = 0;
|
|
|
|
virtual HeaderProtectionMask mask(folly::ByteRange sample) const = 0;
|
|
|
|
/**
|
|
* Decrypts a long header from a sample.
|
|
* sample should be 16 bytes long.
|
|
* initialByte is the initial byte.
|
|
* packetNumberBytes should be supplied with at least 4 bytes.
|
|
*/
|
|
virtual void decryptLongHeader(
|
|
folly::ByteRange sample,
|
|
folly::MutableByteRange initialByte,
|
|
folly::MutableByteRange packetNumberBytes) const;
|
|
|
|
/**
|
|
* Decrypts a short header from a sample.
|
|
* sample should be 16 bytes long.
|
|
* initialByte is the initial byte.
|
|
* packetNumberBytes should be supplied with at least 4 bytes.
|
|
*/
|
|
virtual void decryptShortHeader(
|
|
folly::ByteRange sample,
|
|
folly::MutableByteRange initialByte,
|
|
folly::MutableByteRange packetNumberBytes) const;
|
|
|
|
/**
|
|
* Encrypts a long header from a sample.
|
|
* sample should be 16 bytes long.
|
|
* initialByte is the initial byte.
|
|
*/
|
|
virtual void encryptLongHeader(
|
|
folly::ByteRange sample,
|
|
folly::MutableByteRange initialByte,
|
|
folly::MutableByteRange packetNumberBytes) const;
|
|
|
|
/**
|
|
* Encrypts a short header from a sample.
|
|
* sample should be 16 bytes long.
|
|
* initialByte is the initial byte.
|
|
*/
|
|
virtual void encryptShortHeader(
|
|
folly::ByteRange sample,
|
|
folly::MutableByteRange initialByte,
|
|
folly::MutableByteRange packetNumberBytes) const;
|
|
|
|
/**
|
|
* Returns the length of key needed for the pn cipher.
|
|
*/
|
|
virtual size_t keyLength() const = 0;
|
|
|
|
/**
|
|
* Get the packet protection key
|
|
*/
|
|
virtual const Buf& getKey() const = 0;
|
|
|
|
protected:
|
|
virtual void cipherHeader(
|
|
folly::ByteRange sample,
|
|
folly::MutableByteRange initialByte,
|
|
folly::MutableByteRange packetNumberBytes,
|
|
uint8_t initialByteMask,
|
|
uint8_t packetNumLengthMask) const;
|
|
|
|
virtual void decipherHeader(
|
|
folly::ByteRange sample,
|
|
folly::MutableByteRange initialByte,
|
|
folly::MutableByteRange packetNumberBytes,
|
|
uint8_t initialByteMask,
|
|
uint8_t packetNumLengthMask) const;
|
|
};
|
|
|
|
} // namespace quic
|