Multi-step authentication support in JingleSession.

remoting/protocol/authenticator.h

 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef REMOTING_PROTOCOL_AUTHENTICATOR_H_
 #define REMOTING_PROTOCOL_AUTHENTICATOR_H_
 
 #include <string>
 
 namespace buzz {
@@ skipping 35 matching lines @@
     // Next message is ready to be sent to the peer.
     MESSAGE_READY,
 
     // Session is authenticated successufully.
     ACCEPTED,
 
     // Session is rejected.
     REJECTED,
   };
 
+  // Returns true if |message| is an authenticator message.

[Wez, 2011/12/03 00:21:05]

nit: Authenticator?

[Sergey Ulanov, 2011/12/06 19:37:07]

Done.

+  static bool IsAuthenticatorMessage(const buzz::XmlElement* message);
+
+  // Creates an empty authenticator message. Passes ownership of the

[Wez, 2011/12/03 00:21:05]

nit: Creates an empty authenticator message, owned by the caller.

[Sergey Ulanov, 2011/12/06 19:37:07]

Done.

+  // result to the caller.
+  static buzz::XmlElement* CreateEmptyAuthenticatorMessage();
+
+  // Finds authenticator message among child elements of |message|.

[Wez, 2011/12/03 00:21:05]

And if there isn't one?

[Sergey Ulanov, 2011/12/06 19:37:07]

Done.

+  static const buzz::XmlElement* FindAuthenticatorMessage(
+      const buzz::XmlElement* message);
+
   Authenticator() {}
   virtual ~Authenticator() {}
 
   // Returns current state of the authenticator.
   virtual State state() const = 0;
 
   // Called in response to incoming message received from the peer.
   // Should only be called when in WAITING_MESSAGE state. Caller
   // retains ownership of |message|.
   virtual void ProcessMessage(const buzz::XmlElement* message) = 0;
@@ skipping 24 matching lines @@
   // for the result of this method.
   virtual Authenticator* CreateAuthenticator(
       const std::string& remote_jid,
       const buzz::XmlElement* first_message) = 0;
 };
 
 }  // namespace protocol
 }  // namespace remoting
 
 #endif  // REMOTING_PROTOCOL_AUTHENTICATOR_H_