1 // Copyright (c) 2013 The Chromium Authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style license that can be 3 // found in the LICENSE file. 4 5 #ifndef NET_QUIC_CRYPTO_KEY_EXCHANGE_H_ 6 #define NET_QUIC_CRYPTO_KEY_EXCHANGE_H_ 7 8 #include <string> 9 10 #include "base/strings/string_piece.h" 11 #include "net/base/net_export.h" 12 #include "net/quic/crypto/crypto_protocol.h" 13 14 namespace net { 15 16 class QuicRandom; 17 18 // KeyExchange is an abstract class that provides an interface to a 19 // key-exchange primitive. 20 class NET_EXPORT_PRIVATE KeyExchange { 21 public: ~KeyExchange()22 virtual ~KeyExchange() {} 23 24 // NewKeyPair generates a new public, private key pair. The caller takes 25 // ownership of the return value. (This is intended for servers that need to 26 // generate forward-secure keys.) 27 virtual KeyExchange* NewKeyPair(QuicRandom* rand) const = 0; 28 29 // CalculateSharedKey computes the shared key between the local private key 30 // (which is implicitly known by a KeyExchange object) and a public value 31 // from the peer. 32 virtual bool CalculateSharedKey(const base::StringPiece& peer_public_value, 33 std::string* shared_key) const = 0; 34 35 // public_value returns the local public key which can be sent to a peer in 36 // order to complete a key exchange. The returned StringPiece is a reference 37 // to a member of the KeyExchange and is only valid for as long as the 38 // KeyExchange exists. 39 virtual base::StringPiece public_value() const = 0; 40 41 // tag returns the tag value that identifies this key exchange function. 42 virtual QuicTag tag() const = 0; 43 }; 44 45 } // namespace net 46 47 #endif // NET_QUIC_CRYPTO_KEY_EXCHANGE_H_ 48