Enable passing cast channel certificate authority keys.

extensions/browser/api/cast_channel/cast_auth_util.h

 // Copyright 2014 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 EXTENSIONS_BROWSER_API_CAST_CHANNEL_CAST_AUTH_UTIL_H_
 #define EXTENSIONS_BROWSER_API_CAST_CHANNEL_CAST_AUTH_UTIL_H_
 
+#include <map>
 #include <string>
 
+#include "base/memory/scoped_ptr.h"
+#include "base/strings/string_piece.h"
+#include "net/base/hash_value.h"
+
 namespace extensions {
 namespace core_api {
 namespace cast_channel {
 
 class CastMessage;
 
 struct AuthResult {
  public:
   enum ErrorType {
     ERROR_NONE,
@@ skipping 25 matching lines @@
   std::string error_message;
   ErrorType error_type;
   int nss_error_code;
 
  private:
   AuthResult(const std::string& error_message,
              ErrorType error_type,
              int nss_error_code);
 };
 
+typedef std::map<net::SHA256HashValue,
+                 base::StringPiece,
+                 net::SHA256HashValueLessThan> AuthorityKeysMap;
+
+namespace proto {
+
+// Forward declaration to avoid including generated protobuf header.
+class AuthorityKeys;
+
+}  // namespace proto

[Ryan Sleevi, 2014/10/22 22:07:10]

Realized this isn't right anymore.

This should move to line 14/15 (eg: outside of
extensions::core_api::cast_channel)

[vadimgo, 2014/10/23 18:03:25]

This is right, because the protobuf is also namespaced to
extensions::core_api::cast_channel.

+
+// AuthorityKeysStore is a helper class that is used to store and manipulate
+// intermediate CAs (ICAs) information used to authenticate cast devices.
+// A static list of ICAs is hardcoded and may optionally be replaced during
+// runtime by an extension supplying a protobuf of ICAs information signed with
+// known key.
+class AuthorityKeysStore {

[Ryan Sleevi, 2014/10/22 22:07:10]

naming wise, does this make sense singular? AuthorityKeyStore?

[vadimgo, 2014/10/23 18:03:25]

Done.

+ public:
+  AuthorityKeysStore();
+  ~AuthorityKeysStore();
+
+  // Returns the public key of the ICA whose fingerprint matches |fingerprint|.
+  // Returns an empty StringPiece if no such ICA is found.
+  base::StringPiece GetICAPublicKeyFromFingerprint(
+      const net::SHA256HashValue& fingerprint);
+
+  // Returns the public key of the default / original cast ICA.
+  // Returns an empty StringPiece if the default cast ICA is not found.
+  base::StringPiece GetDefaultICAPublicKey();
+
+  // Loads authority keys from a serialized protobuf.

[Ryan Sleevi, 2014/10/22 22:07:10]

Documentation: This invalidates all previously returned Public Keys, right?
Worth documenting.

[vadimgo, 2014/10/23 18:03:25]

Done.

[Ryan Sleevi, 2014/10/24 19:42:14]

Not really. It doesn't document the 'surprising' part of the API that I
mentioned.

// Loads authority keys from a serialized protobuf, returning true if the keys
were successfully loaded.
// Regardless of success or failure, this will invalidate
// any keys previously returned (e.g. via GetICAPublicKeyFromFingerprint()
// or GetDefaultICAPublicKey())


Alternatively, you would document for the Get functions (e.g.
GetDefaultICAPublicKey())

// Returns the public key of the default / original
// Cast ICA. Returns an empty StringPiece if the default
// Cast ICA is not found.
// Note: The returned StringPiece is invalidated if
// Load() is called.

+  bool Load(const std::string& keys);
+
+ private:
+  // The map of trusted certificate authorities - fingerprints to public keys.
+  AuthorityKeysMap certificate_authorities_;
+
+  // Trusted certificate authorities data passed from the extension.
+  scoped_ptr<proto::AuthorityKeys> authority_keys_;
+
+  DISALLOW_COPY_AND_ASSIGN(AuthorityKeysStore);
+};
+
 // Authenticates the given |challenge_reply|:
 // 1. Signature contained in the reply is valid.
 // 2. Certficate used to sign is rooted to a trusted CA.
 AuthResult AuthenticateChallengeReply(const CastMessage& challenge_reply,
                                       const std::string& peer_cert);
 
+// Sets trusted certificate authorities.
+bool SetTrustedCertificateAuthorities(const std::string& keys,
+                                      const std::string& signature);
+
 }  // namespace cast_channel
 }  // namespace core_api
 }  // namespace extensions
 
 #endif  // EXTENSIONS_BROWSER_API_CAST_CHANNEL_CAST_AUTH_UTIL_H_