src/net/quic/crypto/key_exchange.h

   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:
  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_