/* * Copyright (c) 2021 The WebRTC project authors. All Rights Reserved. * * Use of this source code is governed by a BSD-style license * that can be found in the LICENSE file in the root of the source * tree. An additional intellectual property rights grant can be found * in the file PATENTS. All contributing project authors may * be found in the AUTHORS file in the root of the source tree. */ #ifndef NET_DCSCTP_SOCKET_STATE_COOKIE_H_ #define NET_DCSCTP_SOCKET_STATE_COOKIE_H_ #include #include #include "absl/types/optional.h" #include "api/array_view.h" #include "net/dcsctp/common/internal_types.h" #include "net/dcsctp/socket/capabilities.h" namespace dcsctp { // This is serialized as a state cookie and put in INIT_ACK. The client then // responds with this in COOKIE_ECHO. // // NOTE: Expect that the client will modify it to try to exploit the library. // Do not trust anything in it; no pointers or anything like that. class StateCookie { public: static constexpr size_t kCookieSize = 45; StateCookie(VerificationTag peer_tag, VerificationTag my_tag, TSN peer_initial_tsn, TSN my_initial_tsn, uint32_t a_rwnd, TieTag tie_tag, Capabilities capabilities) : peer_tag_(peer_tag), my_tag_(my_tag), peer_initial_tsn_(peer_initial_tsn), my_initial_tsn_(my_initial_tsn), a_rwnd_(a_rwnd), tie_tag_(tie_tag), capabilities_(capabilities) {} // Returns a serialized version of this cookie. std::vector Serialize(); // Deserializes the cookie, and returns absl::nullopt if that failed. static absl::optional Deserialize( rtc::ArrayView cookie); VerificationTag peer_tag() const { return peer_tag_; } VerificationTag my_tag() const { return my_tag_; } TSN peer_initial_tsn() const { return peer_initial_tsn_; } TSN my_initial_tsn() const { return my_initial_tsn_; } uint32_t a_rwnd() const { return a_rwnd_; } TieTag tie_tag() const { return tie_tag_; } const Capabilities& capabilities() const { return capabilities_; } private: // Also called "Tag_A" in RFC4960. const VerificationTag peer_tag_; // Also called "Tag_Z" in RFC4960. const VerificationTag my_tag_; const TSN peer_initial_tsn_; const TSN my_initial_tsn_; const uint32_t a_rwnd_; const TieTag tie_tag_; const Capabilities capabilities_; }; } // namespace dcsctp #endif // NET_DCSCTP_SOCKET_STATE_COOKIE_H_