| OLD | NEW |
| (Empty) |
| 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 | |
| 5 #ifndef CONTENT_BROWSER_CHILD_PROCESS_SECURITY_POLICY_IMPL_H_ | |
| 6 #define CONTENT_BROWSER_CHILD_PROCESS_SECURITY_POLICY_IMPL_H_ | |
| 7 | |
| 8 #include <map> | |
| 9 #include <set> | |
| 10 #include <string> | |
| 11 #include <vector> | |
| 12 | |
| 13 #include "base/compiler_specific.h" | |
| 14 #include "base/gtest_prod_util.h" | |
| 15 #include "base/macros.h" | |
| 16 #include "base/memory/singleton.h" | |
| 17 #include "base/synchronization/lock.h" | |
| 18 #include "content/public/browser/child_process_security_policy.h" | |
| 19 #include "content/public/common/resource_type.h" | |
| 20 #include "storage/common/fileapi/file_system_types.h" | |
| 21 | |
| 22 class GURL; | |
| 23 | |
| 24 namespace base { | |
| 25 class FilePath; | |
| 26 } | |
| 27 | |
| 28 namespace storage { | |
| 29 class FileSystemURL; | |
| 30 } | |
| 31 | |
| 32 namespace content { | |
| 33 | |
| 34 class CONTENT_EXPORT ChildProcessSecurityPolicyImpl | |
| 35 : NON_EXPORTED_BASE(public ChildProcessSecurityPolicy) { | |
| 36 public: | |
| 37 // Object can only be created through GetInstance() so the constructor is | |
| 38 // private. | |
| 39 ~ChildProcessSecurityPolicyImpl() override; | |
| 40 | |
| 41 static ChildProcessSecurityPolicyImpl* GetInstance(); | |
| 42 | |
| 43 // ChildProcessSecurityPolicy implementation. | |
| 44 void RegisterWebSafeScheme(const std::string& scheme) override; | |
| 45 bool IsWebSafeScheme(const std::string& scheme) override; | |
| 46 void GrantReadFile(int child_id, const base::FilePath& file) override; | |
| 47 void GrantCreateReadWriteFile(int child_id, | |
| 48 const base::FilePath& file) override; | |
| 49 void GrantCopyInto(int child_id, const base::FilePath& dir) override; | |
| 50 void GrantDeleteFrom(int child_id, const base::FilePath& dir) override; | |
| 51 void GrantReadFileSystem(int child_id, | |
| 52 const std::string& filesystem_id) override; | |
| 53 void GrantWriteFileSystem(int child_id, | |
| 54 const std::string& filesystem_id) override; | |
| 55 void GrantCreateFileForFileSystem(int child_id, | |
| 56 const std::string& filesystem_id) override; | |
| 57 void GrantCreateReadWriteFileSystem( | |
| 58 int child_id, | |
| 59 const std::string& filesystem_id) override; | |
| 60 void GrantCopyIntoFileSystem(int child_id, | |
| 61 const std::string& filesystem_id) override; | |
| 62 void GrantDeleteFromFileSystem(int child_id, | |
| 63 const std::string& filesystem_id) override; | |
| 64 void GrantOrigin(int child_id, const url::Origin& origin) override; | |
| 65 void GrantScheme(int child_id, const std::string& scheme) override; | |
| 66 bool CanReadFile(int child_id, const base::FilePath& file) override; | |
| 67 bool CanCreateReadWriteFile(int child_id, | |
| 68 const base::FilePath& file) override; | |
| 69 bool CanReadFileSystem(int child_id, | |
| 70 const std::string& filesystem_id) override; | |
| 71 bool CanReadWriteFileSystem(int child_id, | |
| 72 const std::string& filesystem_id) override; | |
| 73 bool CanCopyIntoFileSystem(int child_id, | |
| 74 const std::string& filesystem_id) override; | |
| 75 bool CanDeleteFromFileSystem(int child_id, | |
| 76 const std::string& filesystem_id) override; | |
| 77 bool HasWebUIBindings(int child_id) override; | |
| 78 void GrantSendMidiSysExMessage(int child_id) override; | |
| 79 bool CanAccessDataForOrigin(int child_id, const GURL& url) override; | |
| 80 | |
| 81 // Returns if |child_id| can read all of the |files|. | |
| 82 bool CanReadAllFiles(int child_id, const std::vector<base::FilePath>& files); | |
| 83 | |
| 84 // Pseudo schemes are treated differently than other schemes because they | |
| 85 // cannot be requested like normal URLs. There is no mechanism for revoking | |
| 86 // pseudo schemes. | |
| 87 void RegisterPseudoScheme(const std::string& scheme); | |
| 88 | |
| 89 // Returns true iff |scheme| has been registered as pseudo scheme. | |
| 90 bool IsPseudoScheme(const std::string& scheme); | |
| 91 | |
| 92 // Upon creation, child processes should register themselves by calling this | |
| 93 // this method exactly once. | |
| 94 void Add(int child_id); | |
| 95 | |
| 96 // Upon creation, worker thread child processes should register themselves by | |
| 97 // calling this this method exactly once. Workers that are not shared will | |
| 98 // inherit permissions from their parent renderer process identified with | |
| 99 // |main_render_process_id|. | |
| 100 void AddWorker(int worker_child_id, int main_render_process_id); | |
| 101 | |
| 102 // Upon destruction, child processess should unregister themselves by caling | |
| 103 // this method exactly once. | |
| 104 void Remove(int child_id); | |
| 105 | |
| 106 // Whenever the browser processes commands the child process to request a URL, | |
| 107 // it should call this method to grant the child process the capability to | |
| 108 // request the URL, along with permission to request all URLs of the same | |
| 109 // scheme. | |
| 110 void GrantRequestURL(int child_id, const GURL& url); | |
| 111 | |
| 112 // Whenever the browser process drops a file icon on a tab, it should call | |
| 113 // this method to grant the child process the capability to request this one | |
| 114 // file:// URL, but not all urls of the file:// scheme. | |
| 115 void GrantRequestSpecificFileURL(int child_id, const GURL& url); | |
| 116 | |
| 117 // Revokes all permissions granted to the given file. | |
| 118 void RevokeAllPermissionsForFile(int child_id, const base::FilePath& file); | |
| 119 | |
| 120 // Grant the child process the ability to use Web UI Bindings. | |
| 121 void GrantWebUIBindings(int child_id); | |
| 122 | |
| 123 // Grant the child process the ability to read raw cookies. | |
| 124 void GrantReadRawCookies(int child_id); | |
| 125 | |
| 126 // Revoke read raw cookies permission. | |
| 127 void RevokeReadRawCookies(int child_id); | |
| 128 | |
| 129 // Before servicing a child process's request for a URL, the browser should | |
| 130 // call this method to determine whether the process has the capability to | |
| 131 // request the URL. | |
| 132 bool CanRequestURL(int child_id, const GURL& url); | |
| 133 | |
| 134 // Whether the process is allowed to commit a document from the given URL. | |
| 135 // This is more restrictive than CanRequestURL, since CanRequestURL allows | |
| 136 // requests that might lead to cross-process navigations or external protocol | |
| 137 // handlers. | |
| 138 bool CanCommitURL(int child_id, const GURL& url); | |
| 139 | |
| 140 // Explicit permissions checks for FileSystemURL specified files. | |
| 141 bool CanReadFileSystemFile(int child_id, const storage::FileSystemURL& url); | |
| 142 bool CanWriteFileSystemFile(int child_id, const storage::FileSystemURL& url); | |
| 143 bool CanCreateFileSystemFile(int child_id, const storage::FileSystemURL& url); | |
| 144 bool CanCreateReadWriteFileSystemFile(int child_id, | |
| 145 const storage::FileSystemURL& url); | |
| 146 bool CanCopyIntoFileSystemFile(int child_id, | |
| 147 const storage::FileSystemURL& url); | |
| 148 bool CanDeleteFileSystemFile(int child_id, const storage::FileSystemURL& url); | |
| 149 | |
| 150 // Returns true if the specified child_id has been granted ReadRawCookies. | |
| 151 bool CanReadRawCookies(int child_id); | |
| 152 | |
| 153 // Sets the process as only permitted to use and see the cookies for the | |
| 154 // given origin. | |
| 155 // Origin lock is applied only if the --site-per-process flag is used. | |
| 156 void LockToOrigin(int child_id, const GURL& gurl); | |
| 157 | |
| 158 // Register FileSystem type and permission policy which should be used | |
| 159 // for the type. The |policy| must be a bitwise-or'd value of | |
| 160 // storage::FilePermissionPolicy. | |
| 161 void RegisterFileSystemPermissionPolicy(storage::FileSystemType type, | |
| 162 int policy); | |
| 163 | |
| 164 // Returns true if sending system exclusive messages is allowed. | |
| 165 bool CanSendMidiSysExMessage(int child_id); | |
| 166 | |
| 167 private: | |
| 168 friend class ChildProcessSecurityPolicyInProcessBrowserTest; | |
| 169 friend class ChildProcessSecurityPolicyTest; | |
| 170 FRIEND_TEST_ALL_PREFIXES(ChildProcessSecurityPolicyInProcessBrowserTest, | |
| 171 NoLeak); | |
| 172 FRIEND_TEST_ALL_PREFIXES(ChildProcessSecurityPolicyTest, FilePermissions); | |
| 173 | |
| 174 class SecurityState; | |
| 175 | |
| 176 typedef std::set<std::string> SchemeSet; | |
| 177 typedef std::map<int, SecurityState*> SecurityStateMap; | |
| 178 typedef std::map<int, int> WorkerToMainProcessMap; | |
| 179 typedef std::map<storage::FileSystemType, int> FileSystemPermissionPolicyMap; | |
| 180 | |
| 181 // Obtain an instance of ChildProcessSecurityPolicyImpl via GetInstance(). | |
| 182 ChildProcessSecurityPolicyImpl(); | |
| 183 friend struct base::DefaultSingletonTraits<ChildProcessSecurityPolicyImpl>; | |
| 184 | |
| 185 // Adds child process during registration. | |
| 186 void AddChild(int child_id); | |
| 187 | |
| 188 // Determines if certain permissions were granted for a file to given child | |
| 189 // process. |permissions| is an internally defined bit-set. | |
| 190 bool ChildProcessHasPermissionsForFile(int child_id, | |
| 191 const base::FilePath& file, | |
| 192 int permissions); | |
| 193 | |
| 194 // Grant a particular permission set for a file. |permissions| is an | |
| 195 // internally defined bit-set. | |
| 196 void GrantPermissionsForFile(int child_id, | |
| 197 const base::FilePath& file, | |
| 198 int permissions); | |
| 199 | |
| 200 // Grants access permission to the given isolated file system | |
| 201 // identified by |filesystem_id|. See comments for | |
| 202 // ChildProcessSecurityPolicy::GrantReadFileSystem() for more details. | |
| 203 void GrantPermissionsForFileSystem( | |
| 204 int child_id, | |
| 205 const std::string& filesystem_id, | |
| 206 int permission); | |
| 207 | |
| 208 // Determines if certain permissions were granted for a file. |permissions| | |
| 209 // is an internally defined bit-set. If |child_id| is a worker process, | |
| 210 // this returns true if either the worker process or its parent renderer | |
| 211 // has permissions for the file. | |
| 212 bool HasPermissionsForFile(int child_id, | |
| 213 const base::FilePath& file, | |
| 214 int permissions); | |
| 215 | |
| 216 // Determines if certain permissions were granted for a file in FileSystem | |
| 217 // API. |permissions| is an internally defined bit-set. | |
| 218 bool HasPermissionsForFileSystemFile(int child_id, | |
| 219 const storage::FileSystemURL& url, | |
| 220 int permissions); | |
| 221 | |
| 222 // Determines if certain permissions were granted for a file system. | |
| 223 // |permissions| is an internally defined bit-set. | |
| 224 bool HasPermissionsForFileSystem( | |
| 225 int child_id, | |
| 226 const std::string& filesystem_id, | |
| 227 int permission); | |
| 228 | |
| 229 // You must acquire this lock before reading or writing any members of this | |
| 230 // class. You must not block while holding this lock. | |
| 231 base::Lock lock_; | |
| 232 | |
| 233 // These schemes are white-listed for all child processes. This set is | |
| 234 // protected by |lock_|. | |
| 235 SchemeSet web_safe_schemes_; | |
| 236 | |
| 237 // These schemes do not actually represent retrievable URLs. For example, | |
| 238 // the the URLs in the "about" scheme are aliases to other URLs. This set is | |
| 239 // protected by |lock_|. | |
| 240 SchemeSet pseudo_schemes_; | |
| 241 | |
| 242 // This map holds a SecurityState for each child process. The key for the | |
| 243 // map is the ID of the ChildProcessHost. The SecurityState objects are | |
| 244 // owned by this object and are protected by |lock_|. References to them must | |
| 245 // not escape this class. | |
| 246 SecurityStateMap security_state_; | |
| 247 | |
| 248 // This maps keeps the record of which js worker thread child process | |
| 249 // corresponds to which main js thread child process. | |
| 250 WorkerToMainProcessMap worker_map_; | |
| 251 | |
| 252 FileSystemPermissionPolicyMap file_system_policy_map_; | |
| 253 | |
| 254 DISALLOW_COPY_AND_ASSIGN(ChildProcessSecurityPolicyImpl); | |
| 255 }; | |
| 256 | |
| 257 } // namespace content | |
| 258 | |
| 259 #endif // CONTENT_BROWSER_CHILD_PROCESS_SECURITY_POLICY_IMPL_H_ | |
| OLD | NEW |