components/proximity_auth/secure_context.h

   1 // Copyright 2014 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 COMPONENTS_PROXIMITY_AUTH_SECURE_CONTEXT_H
   6 #define COMPONENTS_PROXIMITY_AUTH_SECURE_CONTEXT_H
   7
   8 namespace proximity_auth {
   9
  10 // An interface used to decode and encode messages.
  11 class SecureContext {
  12  public:
  13   // The protocol version used during authentication.
  14   enum ProtocolVersion {
  15     PROTOCOL_VERSION_THREE_ZERO,  // 3.0
  16     PROTOCOL_VERSION_THREE_ONE,   // 3.1
  17   };
  18
  19   virtual ~SecureContext() {}
  20
  21   // Decodes the |encoded_message| and returns the result.
  22   virtual std::string Decode(const std::string& encoded_message) = 0;
  23
  24   // Encodes the |message| and returns the result.
  25   virtual std::string Encode(const std::string& message) = 0;
  26
  27   // Returns the message received from the remote device that authenticates it.
  28   // This message should have been received during the handshake that
  29   // establishes the secure channel.
  30   virtual std::string GetReceivedAuthMessage() const = 0;
  31
  32   // Returns the protocol version that was used during authentication.
  33   virtual ProtocolVersion GetProtocolVersion() const = 0;
  34 };
  35
  36 }  // namespace proximity_auth
  37
  38 #endif  // COMPONENTS_PROXIMITY_AUTH_SECURE_CONTEXT_H