Home | History | Annotate | Download | only in permissions 
      1 // Copyright (c) 2012 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 #ifndef CHROME_COMMON_EXTENSIONS_PERMISSIONS_SOCKET_PERMISSION_DATA_H_
      5 #define CHROME_COMMON_EXTENSIONS_PERMISSIONS_SOCKET_PERMISSION_DATA_H_
      6 
      7 #include <string>
      8 
      9 #include "chrome/common/extensions/permissions/socket_permission_entry.h"
     10 #include "extensions/common/permissions/api_permission.h"
     11 #include "ipc/ipc_param_traits.h"
     12 
     13 template <class T> struct FuzzTraits;
     14 
     15 namespace extensions {
     16 
     17 // A pattern that can be used to match socket permission.
     18 //   <socket-permission-pattern>
     19 //          := <op> |
     20 //             <op> ':' <host> |
     21 //             <op> ':' ':' <port> |
     22 //             <op> ':' <host> ':' <port> |
     23 //             'udp-multicast-membership'
     24 //   <op>   := 'tcp-connect' |
     25 //             'tcp-listen' |
     26 //             'udp-bind' |
     27 //             'udp-send-to' |
     28 //             'udp-multicast-membership' |
     29 //             'resolve-host' |
     30 //             'resolve-proxy' |
     31 //             'network-state'
     32 //   <host> := '*' |
     33 //             '*.' <anychar except '/' and '*'>+ |
     34 //             <anychar except '/' and '*'>+
     35 //   <port> := '*' |
     36 //             <port number between 0 and 65535>)
     37 // The multicast membership permission implies a permission to any address.
     38 class SocketPermissionData {
     39  public:
     40   SocketPermissionData();
     41   ~SocketPermissionData();
     42 
     43   // operators <, == are needed by container std::set and algorithms
     44   // std::set_includes and std::set_differences.
     45   bool operator<(const SocketPermissionData& rhs) const;
     46   bool operator==(const SocketPermissionData& rhs) const;
     47 
     48   // Check if |param| (which must be a SocketPermissionData::CheckParam)
     49   // matches the spec of |this|.
     50   bool Check(const APIPermission::CheckParam* param) const;
     51 
     52   // Convert |this| into a base::Value.
     53   scoped_ptr<base::Value> ToValue() const;
     54 
     55   // Populate |this| from a base::Value.
     56   bool FromValue(const base::Value* value);
     57 
     58   // TODO(bryeung): SocketPermissionData should be encoded as a base::Value
     59   // instead of a string.  Until that is done, expose these methods for
     60   // testing.
     61   bool ParseForTest(const std::string& permission) { return Parse(permission); }
     62   const std::string& GetAsStringForTest() const { return GetAsString(); }
     63 
     64   const SocketPermissionEntry& entry() const { return entry_; }
     65 
     66  private:
     67   // Friend so ParamTraits can serialize us.
     68   friend struct IPC::ParamTraits<SocketPermissionData>;
     69   friend struct FuzzTraits<SocketPermissionData>;
     70 
     71   SocketPermissionEntry& entry();
     72 
     73   bool Parse(const std::string& permission);
     74   const std::string& GetAsString() const;
     75   void Reset();
     76 
     77   SocketPermissionEntry entry_;
     78   mutable std::string spec_;
     79 };
     80 
     81 }  // namespace extensions
     82 
     83 #endif  // CHROME_COMMON_EXTENSIONS_PERMISSIONS_SOCKET_PERMISSION_DATA_H_
     84