Name |
Date |
Size |
#Lines |
LOC |
||
---|---|---|---|---|---|---|
.. | - | - | ||||
build/ | 12-May-2024 | - | 18 | 16 | ||
figures/ | 12-May-2024 | - | ||||
interfaces/ | 12-May-2024 | - | 441 | 128 | ||
services/ | 12-May-2024 | - | 3,973 | 3,162 | ||
.gitattributes | D | 12-May-2024 | 631 | 16 | 15 | |
LICENSE | D | 12-May-2024 | 10.1 KiB | 177 | 150 | |
OAT.xml | D | 12-May-2024 | 4 KiB | 66 | 10 | |
README.md | D | 12-May-2024 | 24.7 KiB | 377 | 324 | |
README_zh.md | D | 12-May-2024 | 15.9 KiB | 312 | 270 | |
bundle.json | D | 12-May-2024 | 1.5 KiB | 64 | 63 |
README.md
1# security\_permission<a name="EN-US_TOPIC_0000001101239136"></a> 2 3- [Introduction](#section11660541593) 4- [Directory Structure](#section161941989596) 5- [Constraints](#section119744591305) 6- [Usage](#section137768191623) 7 - [Available APIs](#section1551164914237) 8 - [Usage Guidelines](#section129654513264) 9 10- [Repositories Involved](#section1371113476307) 11 12## Introduction<a name="section11660541593"></a> 13 14In OpenHarmony, apps and system services run in independent sandboxes. Both processes and data are isolated from each other to protect the security of app data. However, services or apps running in the sandboxes provide some APIs to implement specific functionalities. To access these APIs across processes, apps in other sandboxes need the required permissions, which are granted and managed based on a permission management mechanism. 15 16- App permission management provides a mechanism for defining permissions, allowing system services and apps to define new permissions for their sensitive APIs. To access these APIs, other apps need the required permissions. 17 18- App permission management also allows apps to request permissions that are defined by the system or other apps. Upon obtaining the permissions, apps can access the sensitive APIs provided by the system or other apps. 19- In addition, app permission management allows users to view and manage the permission granting status. 20 21**Figure 1** App permission management architecture<a name="fig4460722185514"></a> 22 23 24 25 26App permission management provides permission management for the application framework subsystem and provides APIs for apps to request permissions and query the permission granting status. Currently, app permission management is available for mini, small and standard systems. 27 28- Mini system: refers to the system running on the devices whose memory is greater than or equal to 128 KiB and that are equipped with MCU processors such as ARM Cortex-M and 32-bit RISC-V. This system provides multiple lightweight network protocols and graphics frameworks, and a wide range of read/write components for the IoT bus. Typical products include connection modules, sensors, and wearables for smart home. 29- Small system: refers to the system running on the devices whose memory is greater than or equal to 1 MiB and that are equipped with app processors such as ARM Cortex-A. This system provides higher security capabilities, standard graphics frameworks, and video encoding and decoding capabilities. Typical products include smart home IP cameras, electronic cat eyes, and routers, and event data recorders \(EDRs\) for smart travel. 30- Standard system: refers to the system running on the devices whose memory is greater than or equal to 128 MiB and that are equipped with app processors such as ARM Cortex-A. This system provides a complete application framework supporting the enhanced interaction, 3D GPU, hardware composer, diverse components, and rich animations. This system applies to high-end refrigerator displays. 31 32## Directory Structure<a name="section161941989596"></a> 33 34``` 35/base/security/permission_lite 36├── frameworks # Frameworks 37│ └── permission_standard # Permission management framework for the standard system 38├── interfaces # APIs 39│ ├── innerkits # Internal APIs 40│ │ ├── permission_lite # Internal permission management APIs for the mini and small systems 41│ │ └── permission_standard # Internal permission management APIs for the standard system 42│ └── kits # External APIs 43│ ├── permission_lite # External permission management APIs for the mini and small systems 44│ └── permission_standard # External permission management APIs for the standard system 45└── services # Services 46 ├── permission_lite # Permission management services for the mini and small systems 47 └── permission_standard # Permission management services for the standard system 48``` 49 50## Constraints<a name="section119744591305"></a> 51 52- Currently, C++ APIs are available only for local permission management in the standard system. Distributed permission management APIs are not provided yet. 53 54## Usage<a name="section137768191623"></a> 55 56### Available APIs<a name="section1551164914237"></a> 57 58**App permission management for a standard system**: provides basic permission management and verification capabilities for the application framework subsystem of a standard system and is unavailable for third-party apps. The following table describes the available APIs. 59 60<a name="table17351104911243"></a> 61<table><thead align="left"><tr id="row43512497244"><th class="cellrowborder" valign="top" width="73.41%" id="mcps1.1.3.1.1"><p id="p8351104918247"><a name="p8351104918247"></a><a name="p8351104918247"></a>API</p> 62</th> 63<th class="cellrowborder" valign="top" width="26.590000000000003%" id="mcps1.1.3.1.2"><p id="p7351174913247"><a name="p7351174913247"></a><a name="p7351174913247"></a>Description</p> 64</th> 65</tr> 66</thead> 67<tbody><tr id="row143511494244"><td class="cellrowborder" valign="top" width="73.41%" headers="mcps1.1.3.1.1 "><p id="p2504174918322"><a name="p2504174918322"></a><a name="p2504174918322"></a>int VerifyPermission(const string& bundleName, const string& permissionName, int userId)</p> 68</td> 69<td class="cellrowborder" valign="top" width="26.590000000000003%" headers="mcps1.1.3.1.2 "><p id="p14504549163217"><a name="p14504549163217"></a><a name="p14504549163217"></a>Checks whether a specified app has been granted the given permission.</p> 70</td> 71</tr> 72<tr id="row217303717326"><td class="cellrowborder" valign="top" width="73.41%" headers="mcps1.1.3.1.1 "><p id="p8504849123210"><a name="p8504849123210"></a><a name="p8504849123210"></a>bool CanRequestPermission(const string& bundleName, const string& permissionName, int userId)</p> 73</td> 74<td class="cellrowborder" valign="top" width="26.590000000000003%" headers="mcps1.1.3.1.2 "><p id="p850417499329"><a name="p850417499329"></a><a name="p850417499329"></a>Checks whether a specified app can request the given permission through a pop-up window.</p> 75</td> 76</tr> 77<tr id="row677573713220"><td class="cellrowborder" valign="top" width="73.41%" headers="mcps1.1.3.1.1 "><p id="p16504124933210"><a name="p16504124933210"></a><a name="p16504124933210"></a>int GrantUserGrantedPermission(const string& bundleName, const string& permissionName, int userId)</p> 78</td> 79<td class="cellrowborder" valign="top" width="26.590000000000003%" headers="mcps1.1.3.1.2 "><p id="p115042494327"><a name="p115042494327"></a><a name="p115042494327"></a>Grants a specified user_grant permission to the given app.</p> 80</td> 81</tr> 82<tr id="row722533813329"><td class="cellrowborder" valign="top" width="73.41%" headers="mcps1.1.3.1.1 "><p id="p9504114963210"><a name="p9504114963210"></a><a name="p9504114963210"></a>int GrantSystemGrantedPermission(const string& bundleName, const string& permissionName)</p> 83</td> 84<td class="cellrowborder" valign="top" width="26.590000000000003%" headers="mcps1.1.3.1.2 "><p id="p850412493329"><a name="p850412493329"></a><a name="p850412493329"></a>Grants a specified system_grant permission to the given app.</p> 85</td> 86</tr> 87<tr id="row1354353873216"><td class="cellrowborder" valign="top" width="73.41%" headers="mcps1.1.3.1.1 "><p id="p450414919328"><a name="p450414919328"></a><a name="p450414919328"></a>int RevokeUserGrantedPermission(const string& bundleName, const string& permissionName, int userId)</p> 88</td> 89<td class="cellrowborder" valign="top" width="26.590000000000003%" headers="mcps1.1.3.1.2 "><p id="p1050411498327"><a name="p1050411498327"></a><a name="p1050411498327"></a>Revokes a specified user_grant permission from the given app.</p> 90</td> 91</tr> 92<tr id="row1073519380323"><td class="cellrowborder" valign="top" width="73.41%" headers="mcps1.1.3.1.1 "><p id="p1850484933212"><a name="p1850484933212"></a><a name="p1850484933212"></a>int RevokeSystemGrantedPermission(const string& bundleName, const string& permissionName)</p> 93</td> 94<td class="cellrowborder" valign="top" width="26.590000000000003%" headers="mcps1.1.3.1.2 "><p id="p35048492326"><a name="p35048492326"></a><a name="p35048492326"></a>Revokes a specified system_grant permission from the given app.</p> 95</td> 96</tr> 97<tr id="row1692163820325"><td class="cellrowborder" valign="top" width="73.41%" headers="mcps1.1.3.1.1 "><p id="p9504134953215"><a name="p9504134953215"></a><a name="p9504134953215"></a>int AddUserGrantedReqPermissions(const string& bundleName, const std::vector<string>& permList, int userId)</p> 98</td> 99<td class="cellrowborder" valign="top" width="26.590000000000003%" headers="mcps1.1.3.1.2 "><p id="p250424993212"><a name="p250424993212"></a><a name="p250424993212"></a>Adds user_grant permissions requested by a specified app.</p> 100</td> 101</tr> 102<tr id="row1890399325"><td class="cellrowborder" valign="top" width="73.41%" headers="mcps1.1.3.1.1 "><p id="p1950413498329"><a name="p1950413498329"></a><a name="p1950413498329"></a>int AddSystemGrantedReqPermissions(const string& bundleName, const std::vector<string>& permList)</p> 103</td> 104<td class="cellrowborder" valign="top" width="26.590000000000003%" headers="mcps1.1.3.1.2 "><p id="p1150444943210"><a name="p1150444943210"></a><a name="p1150444943210"></a>Adds system_grant permissions requested by a specified app.</p> 105</td> 106</tr> 107<tr id="row13257153973215"><td class="cellrowborder" valign="top" width="73.41%" headers="mcps1.1.3.1.1 "><p id="p2505184917329"><a name="p2505184917329"></a><a name="p2505184917329"></a>int RemoveUserGrantedReqPermissions(const string& bundleName, int userId)</p> 108</td> 109<td class="cellrowborder" valign="top" width="26.590000000000003%" headers="mcps1.1.3.1.2 "><p id="p950514973212"><a name="p950514973212"></a><a name="p950514973212"></a>Removes all the user_grant permissions requested by a specified app.</p> 110</td> 111</tr> 112<tr id="row144437398322"><td class="cellrowborder" valign="top" width="73.41%" headers="mcps1.1.3.1.1 "><p id="p205051049103214"><a name="p205051049103214"></a><a name="p205051049103214"></a>int RemoveSystemGrantedReqPermissions(const string& bundleName)</p> 113</td> 114<td class="cellrowborder" valign="top" width="26.590000000000003%" headers="mcps1.1.3.1.2 "><p id="p125051349123213"><a name="p125051349123213"></a><a name="p125051349123213"></a>Removes all the system_grant permissions requested by a specified app.</p> 115</td> 116</tr> 117<tr id="row13617183915329"><td class="cellrowborder" valign="top" width="73.41%" headers="mcps1.1.3.1.1 "><p id="p16505049173217"><a name="p16505049173217"></a><a name="p16505049173217"></a>int AddDefPermissions(const std::vector<PermissionDef>& permList)</p> 118</td> 119<td class="cellrowborder" valign="top" width="26.590000000000003%" headers="mcps1.1.3.1.2 "><p id="p13505849103215"><a name="p13505849103215"></a><a name="p13505849103215"></a>Adds the permissions defined by the app.</p> 120</td> 121</tr> 122<tr id="row117857394324"><td class="cellrowborder" valign="top" width="73.41%" headers="mcps1.1.3.1.1 "><p id="p105059492325"><a name="p105059492325"></a><a name="p105059492325"></a>int GetDefPermission(const string& permissionName, PermissionDef& permissionDefResult)</p> 123</td> 124<td class="cellrowborder" valign="top" width="26.590000000000003%" headers="mcps1.1.3.1.2 "><p id="p11505349103220"><a name="p11505349103220"></a><a name="p11505349103220"></a>Obtains the definition of the permission with a specified name.</p> 125</td> 126</tr> 127</tbody> 128</table> 129 130**App permission management for a mini or small system**: The following table lists the available APIs, which can be called only by system apps and services. 131 132<a name="table9789027162518"></a> 133<table><thead align="left"><tr id="row9789427112518"><th class="cellrowborder" valign="top" width="55.66%" id="mcps1.1.3.1.1"><p id="p9790102717251"><a name="p9790102717251"></a><a name="p9790102717251"></a>API</p> 134</th> 135<th class="cellrowborder" valign="top" width="44.34%" id="mcps1.1.3.1.2"><p id="p779032715251"><a name="p779032715251"></a><a name="p779032715251"></a>Description</p> 136</th> 137</tr> 138</thead> 139<tbody><tr id="row187901627112516"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p138014275353"><a name="p138014275353"></a><a name="p138014275353"></a>int CheckPermission(int uid, const char *permissionName)</p> 140</td> 141<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p57901727202510"><a name="p57901727202510"></a><a name="p57901727202510"></a>Checks whether the app with a specified UID has the permission to access system service APIs.</p> 142</td> 143</tr> 144<tr id="row19341734164410"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p123453412448"><a name="p123453412448"></a><a name="p123453412448"></a>int CheckSelfPermission(const char *permissionName)</p> 145</td> 146<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p937645212447"><a name="p937645212447"></a><a name="p937645212447"></a>Checks whether the caller has the permission to access system service APIs.</p> 147</td> 148</tr> 149<tr id="row879032715258"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p13071135133514"><a name="p13071135133514"></a><a name="p13071135133514"></a>int QueryPermission(const char *identifier, PermissionSaved **permissions, int *permNum)</p> 150</td> 151<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p1379072718259"><a name="p1379072718259"></a><a name="p1379072718259"></a>Queries all permissions requested by the app and checks whether the requested permissions have been granted.</p> 152</td> 153</tr> 154<tr id="row877239193516"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p878133903516"><a name="p878133903516"></a><a name="p878133903516"></a>int GrantPermission(const char *identifier, const char *permName)</p> 155</td> 156<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p678143943515"><a name="p678143943515"></a><a name="p678143943515"></a>Grants a specified permission to the app.</p> 157</td> 158</tr> 159<tr id="row3616164223510"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p1617142163517"><a name="p1617142163517"></a><a name="p1617142163517"></a>int RevokePermission(const char *identifier, const char *permName)</p> 160</td> 161<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p06171242143517"><a name="p06171242143517"></a><a name="p06171242143517"></a>Revokes a specified permission from the app.</p> 162</td> 163</tr> 164<tr id="row13790122742516"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p23273123365"><a name="p23273123365"></a><a name="p23273123365"></a>int GrantRuntimePermission(int uid, const char *permissionName)</p> 165</td> 166<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p177908273259"><a name="p177908273259"></a><a name="p177908273259"></a>Grants a specified runtime permission to the app.</p> 167</td> 168</tr> 169<tr id="row18566191217452"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p169891916194512"><a name="p169891916194512"></a><a name="p169891916194512"></a>int RevokeRuntimePermission(int uid, const char *permissionName)</p> 170</td> 171<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p937132011440"><a name="p937132011440"></a><a name="p937132011440"></a>Revokes a specified runtime permission from the app.</p> 172</td> 173</tr> 174<tr id="row18566191217452"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p169891916194512"><a name="p169891916194512"></a><a name="p169891916194512"></a>int UpdatePermissionFlags(const char *identifier, const char *permissionName, const int flags)</p> 175</td> 176<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p937132011440"><a name="p937132011440"></a><a name="p937132011440"></a>Updates the flags for the specified permission to the app.</p> 177</td> 178</tr> 179</tbody> 180</table> 181 182 183**IPC authentication for a mini or small system** 184 185<a name="table10494122145517"></a> 186 187<table><thead align="left"><tr id="row1494152195511"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p14941221135515"><a name="p14941221135515"></a><a name="p14941221135515"></a>API</p> 188</th> 189<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p8494172116555"><a name="p8494172116555"></a><a name="p8494172116555"></a>Description</p> 190</th> 191</tr> 192</thead> 193<tbody><tr id="row1849482118555"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p1414381815720"><a name="p1414381815720"></a><a name="p1414381815720"></a>int GetCommunicationStrategy(RegParams params, PolicyTrans **policies, unsigned int *policyNum)</p> 194</td> 195<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p749582195510"><a name="p749582195510"></a><a name="p749582195510"></a>Obtains the access policies of a service API.</p> 196</td> 197</tr> 198<tr id="row8495521115517"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p966319247576"><a name="p966319247576"></a><a name="p966319247576"></a>int IsCommunicationAllowed(AuthParams params)</p> 199</td> 200<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p134951921115511"><a name="p134951921115511"></a><a name="p134951921115511"></a>Checks whether a process has the permission to access an API of another process.</p> 201</td> 202</tr> 203</tbody> 204</table> 205 206### Usage Guidelines<a name="section129654513264"></a> 207 208**App permission management for a standard system** 209 210The APIs provided are for internal use and unavailable to developers. During the authentication, you only need to call **VerifyPermission**. 211 2121. Determine the app UID and the name of the permission to verify. 2132. Obtain the app bundle name based on the app UID. 2143. Obtain the user ID of the app based on the UID. 2154. Pass the permission name, bundle name, and user ID to **VerifyPermission\(string permissionName, string bundleName, int userId\)**. 2165. Obtain the verification result. 217 218**App permission management for a mini or small system** 219 220This section uses the bundle manager as an example to describe the app permission development. Before starting development, you need to declare the required sensitive permissions in the **config.json** file. During app installation, the BMS calls APIs of the app permission management component to check whether the required permissions have been granted. If yes, the installation proceeds; if not, the installation fails. 221 2221. Declare the required permission \(**ohos.permission.INSTALL\_BUNDLE**\) in the **config.json** file. 223 224 ``` 225 { 226 ... 227 "module": { 228 "package": "ohos.demo.kitframework", 229 "deviceType": [ 230 "phone", "tv","tablet", "car","smartWatch","sportsWatch","smartCamera", "smartVision" 231 ], 232 "reqPermissions": [{ 233 // Declare the ohos.permission.INSTALL_BUNDLE permission required for installing the app. 234 "name": "ohos.permission.INSTALL_BUNDLE", 235 "reason": "install bundle", 236 "usedScene": { 237 "ability": [ 238 "KitFramework" 239 ], 240 "when": "always" 241 } 242 }, 243 { 244 "name": "ohos.permission.LISTEN_BUNDLE_CHANGE", 245 "reason": "install bundle", 246 "usedScene": { 247 "ability": [ 248 "KitFramework" 249 ], 250 "when": "always" 251 } 252 }, 253 { 254 "name": "ohos.permission.GET_BUNDLE_INFO", 255 "reason": "install bundle", 256 "usedScene": { 257 "ability": [ 258 "KitFramework" 259 ], 260 "when": "always" 261 } 262 } 263 ], 264 ... 265 } 266 ``` 267 2682. The BMS calls the corresponding API of the app permission management component \(for example, the **CheckPermission** function with **ohos.permission.INSTALL\_BUNDLE** as an input parameter\) to check whether the BMS has the permission to install the app. If yes, the installation proceeds; if not, the installation fails. 269 270 ``` 271 constexpr static char PERMISSION_INSTALL_BUNDLE[] = "ohos.permission.INSTALL_BUNDLE"; 272 273 bool Install(const char *hapPath, const InstallParam *installParam, InstallerCallback installerCallback) 274 { 275 if ((hapPath == nullptr) || (installerCallback == nullptr) || (installParam == nullptr)) { 276 HILOG_ERROR(HILOG_MODULE_APP, "BundleManager install failed due to nullptr parameters"); 277 return false; 278 } 279 // Check whether the ohos.permission.INSTALL_BUNDLE permission has been granted. 280 if (CheckPermission(0, static_cast<const char *>(PERMISSION_INSTALL_BUNDLE)) != GRANTED) { 281 HILOG_ERROR(HILOG_MODULE_APP, "BundleManager install failed due to permission denied"); 282 return false; // App installation fails. 283 } 284 // App installation process 285 ... 286 } 287 ``` 288 289 290**IPC authentication for a mini or small system** 291 292This section uses the bundle manager as an example to describe how to configure access policies for APIs provided by the IPC authentication component. In this example, the service registered by BMS with Samgr is **bundlems**, and the feature registered for open APIs is **BmsFeature**. 293 2941. <a name="li15901515152517"></a>Configure access policies in the **base/security/permission\_lite/services/ipc\_auth/include/policy\_preset.h** file. Access policies are classified into the following three types: 295 296 1. **RANGE**: Processes with a specified range of UIDs can access BMS APIs. **uidMin** and **uidMax** must be specified. 297 298 2. **FIXED**: Processes with specified UIDs can access BMS APIs. **fixedUid** must be specified, and a maximum of eight UIDs are allowed. 299 300 3. **BUNDLENAME**: An app with a specified **bundleName** can access BMS APIs. 301 302 ``` 303 FeaturePolicy bmsFeature[] = { 304 { 305 "BmsFeature", 306 { 307 { 308 .type=FIXED, // Processes with specified UIDs can access BMS APIs. 309 .fixedUid={2, 3, 8} 310 }, 311 { 312 .type=RANGE, // Processes with a specified range of UIDs can access BMS APIs. 313 .uidMin=100, 314 .uidMax=__INT_MAX__, 315 }, 316 } 317 }, 318 { 319 "BmsInnerFeature", 320 { 321 { 322 .type=FIXED, // Processes with specified UIDs can access BMS APIs. 323 .fixedUid={2, 3, 8} 324 }, 325 { 326 .type=RANGE, 327 .uidMin=100, 328 .uidMax=999, 329 }, 330 } 331 }, 332 }; 333 ``` 334 3352. Add the policies configured for the features in [Step 1](#li15901515152517) to the global policy settings. You need to set the number of features. 336 337 ``` 338 static PolicySetting g_presetPolicies[] = { 339 {"permissionms", pmsFeature, 1}, 340 {"abilityms", amsFeature, 2}, 341 {"bundlems", bmsFeature, 2}, // Add the policies configured for the two features in [Step 1](#li15901515152517) to the global policy settings. 342 {"dtbschedsrv", dmsFeature, 1}, 343 {"samgr", samgrFeature, 1}, 344 {"appspawn", appspawnFeature, 1}, 345 {"WMS", wmsFeature, 1}, 346 {"bundle_daemon", bdsFeature, 1}, 347 }; 348 ``` 349 3503. Register the **BmsFeature** defined in [Step 1](#li15901515152517) with Samgr. 351 352 ``` 353 const char BMS_SERVICE[] = "bundlems"; 354 const char BMS_FEATURE[] = "BmsFeature"; 355 static void Init() 356 { 357 SamgrLite *sm = SAMGR_GetInstance(); 358 if (sm == nullptr) { 359 return; 360 } 361 // Register the BmsFeature with Samgr. 362 sm->RegisterFeature(BMS_SERVICE, reinterpret_cast<Feature *>(BundleMsFeature::GetInstance())); 363 sm->RegisterFeatureApi(BMS_SERVICE, BMS_FEATURE, 364 GetBmsFeatureApi(reinterpret_cast<Feature *>(BundleMsFeature::GetInstance()))); 365 HILOG_DEBUG(HILOG_MODULE_APP, "BundleMS feature start success"); 366 } 367 APP_FEATURE_INIT(Init); 368 ``` 369 370 371When you register a service with Samgr, Samgr calls the **GetCommunicationStrategy** function of the IPC authentication component to obtain access policies of the service. When other services or apps access this service through IPC, Samgr calls the **IsCommunicationAllowed** function of the IPC authentication component to check whether the services or apps have the access permission. 372 373## Repositories Involved<a name="section1371113476307"></a> 374security 375security\_permission 376 377
README_zh.md
1# 应用权限管理<a name="ZH-CN_TOPIC_0000001101239136"></a> 2 3## 简介<a name="section11660541593"></a> 4 5OpenHarmony中应用和系统服务均运行在独立的沙箱中,进程空间和程序数据都是相互隔离的,以保护应用数据的安全性;但是运行在独立沙箱中的服务或应用同时需要对外提供一些API以实现所需功能,其他独立沙箱中的应用在跨进程访问这些API时,需要系统提供一种权限管理机制对这些API的访问者进行授权。 6 7- 应用权限管理提供了权限定义机制,允许系统服务和应用为自己的敏感API定义新的权限,其他应用必须申请此权限才能访问此敏感API; 8 9- 应用权限管理提供了权限申请机制,允许应用申请权限,这些权限由系统或者其他应用定义,权限申请通过后就能访问这个权限相关的系统或其他应用提供的敏感API; 10- 应用权限管理也为用户提供了一些必须的功能,方便用户查看和管理权限授予情况。 11 12**图 1** 应用权限管理架构<a name="fig4460722185514"></a> 13 14 15 16 17应用权限管理为用户程序框架子系统提供权限管理功能,并且为上层应用提供权限申请和授权状态查询接口。本次开源的应用权限管理功能适用于轻量系统、小型系统和标准系统。 18 19- 轻量系统(mini system)面向MCU类处理器例如Arm Cortex-M、RISC-V 32位的设备,硬件资源极其有限,参考内存≥128KiB,可以提供多种轻量级网络协议,轻量级的图形框架,以及丰富的IOT总线读写部件等。可支撑的产品如智能家居领域的连接类模组、传感器设备、穿戴类设备等。 20- 小型系统(small system)面向应用处理器例如Arm Cortex-A的设备,参考内存≥1MiB,可以提供更高的安全能力、标准的图形框架、视频编解码的多媒体能力。可支撑的产品如智能家居领域的IP Camera、电子猫眼、路由器以及智慧出行域的行车记录仪等。 21 22## 目录<a name="section161941989596"></a> 23 24``` 25/base/security/permission_lite 26├── interfaces # 接口层 27│ ├── innerkits # 内部接口层 28│ └── kits # 外部接口层 29└── services # 服务层 30 ├── ipc_auth # IPC通信鉴权 31 ├── js_api # JS API封装 32 ├── pms # 权限管理逻辑和服务端 33 ├── pms_base # 服务注册 34 └── pms_client # 权限管理服务的客户端 35``` 36 37## 使用<a name="section137768191623"></a> 38 39### 接口说明<a name="section1551164914237"></a> 40 41**轻量系统、小型系统应用权限管理**:当前仅供系统应用和系统服务调用,具体API接口如下: 42 43<a name="table9789027162518"></a> 44<table><thead align="left"><tr id="row9789427112518"><th class="cellrowborder" valign="top" width="55.66%" id="mcps1.1.3.1.1"><p id="p9790102717251"><a name="p9790102717251"></a><a name="p9790102717251"></a>接口名</p> 45</th> 46<th class="cellrowborder" valign="top" width="44.34%" id="mcps1.1.3.1.2"><p id="p779032715251"><a name="p779032715251"></a><a name="p779032715251"></a>描述</p> 47</th> 48</tr> 49</thead> 50<tbody><tr id="row187901627112516"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p138014275353"><a name="p138014275353"></a><a name="p138014275353"></a>int CheckPermission(int uid, const char *permissionName)</p> 51</td> 52<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p57901727202510"><a name="p57901727202510"></a><a name="p57901727202510"></a>检查指定UID的应用进程是否具有访问系统服务API的权限</p> 53</td> 54</tr> 55<tr id="row19341734164410"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p123453412448"><a name="p123453412448"></a><a name="p123453412448"></a>int CheckSelfPermission(const char *permissionName)</p> 56</td> 57<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p937645212447"><a name="p937645212447"></a><a name="p937645212447"></a>检查调用者是否具有访问系统服务API的权限</p> 58</td> 59</tr> 60<tr id="row879032715258"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p13071135133514"><a name="p13071135133514"></a><a name="p13071135133514"></a>int QueryPermission(const char *identifier, PermissionSaved **permissions, int *permNum)</p> 61</td> 62<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p1379072718259"><a name="p1379072718259"></a><a name="p1379072718259"></a>查询应用申请的所有权限,并检查权限是否被授予</p> 63</td> 64</tr> 65<tr id="row877239193516"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p878133903516"><a name="p878133903516"></a><a name="p878133903516"></a>int GrantPermission(const char *identifier, const char *permName)</p> 66</td> 67<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p678143943515"><a name="p678143943515"></a><a name="p678143943515"></a>将指定权限授予应用程序</p> 68</td> 69</tr> 70<tr id="row3616164223510"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p1617142163517"><a name="p1617142163517"></a><a name="p1617142163517"></a>int RevokePermission(const char *identifier, const char *permName)</p> 71</td> 72<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p06171242143517"><a name="p06171242143517"></a><a name="p06171242143517"></a>收回应用程序的指定权限</p> 73</td> 74</tr> 75<tr id="row13790122742516"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p23273123365"><a name="p23273123365"></a><a name="p23273123365"></a>int GrantRuntimePermission(int uid, const char *permissionName)</p> 76</td> 77<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p177908273259"><a name="p177908273259"></a><a name="p177908273259"></a>应用运行时动态授予指定权限</p> 78</td> 79</tr> 80<tr id="row18566191217452"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p169891916194512"><a name="p169891916194512"></a><a name="p169891916194512"></a>int RevokeRuntimePermission(int uid, const char *permissionName)</p> 81</td> 82<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p937132011440"><a name="p937132011440"></a><a name="p937132011440"></a>应用运行时动态撤销指定权限</p> 83</td> 84</tr> 85<tr id="row18566191217452"><td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.1.3.1.1 "><p id="p169891916194512"><a name="p169891916194512"></a><a name="p169891916194512"></a>int UpdatePermissionFlags(const char *identifier, const char *permissionName, const int flags)</p> 86</td> 87<td class="cellrowborder" valign="top" width="44.34%" headers="mcps1.1.3.1.2 "><p id="p937132011440"><a name="p937132011440"></a><a name="p937132011440"></a>更新应用程序指定的应用权限的标记</p> 88</td> 89</tr> 90</tbody> 91</table> 92 93 94**轻量系统、小型系统IPC通信鉴权**: 95 96<a name="table10494122145517"></a> 97 98<table><thead align="left"><tr id="row1494152195511"><th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.1"><p id="p14941221135515"><a name="p14941221135515"></a><a name="p14941221135515"></a>接口名</p> 99</th> 100<th class="cellrowborder" valign="top" width="50%" id="mcps1.1.3.1.2"><p id="p8494172116555"><a name="p8494172116555"></a><a name="p8494172116555"></a>描述</p> 101</th> 102</tr> 103</thead> 104<tbody><tr id="row1849482118555"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p1414381815720"><a name="p1414381815720"></a><a name="p1414381815720"></a>int GetCommunicationStrategy(RegParams params, PolicyTrans **policies, unsigned int *policyNum)</p> 105</td> 106<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p749582195510"><a name="p749582195510"></a><a name="p749582195510"></a>服务注册过程中查询调用接口对应的访问策略,仅供Samgr调用</p> 107</td> 108</tr> 109<tr id="row8495521115517"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.1 "><p id="p966319247576"><a name="p966319247576"></a><a name="p966319247576"></a>int IsCommunicationAllowed(AuthParams params)</p> 110</td> 111<td class="cellrowborder" valign="top" width="50%" headers="mcps1.1.3.1.2 "><p id="p134951921115511"><a name="p134951921115511"></a><a name="p134951921115511"></a>检查访问主体进程是否有权限调用受访客体进程的接口,仅供Samgr调用</p> 112</td> 113</tr> 114</tbody> 115</table> 116 117### 使用说明<a name="section129654513264"></a> 118 119**轻量系统、小型系统应用权限管理**: 120 121使用说明:以包管理器的应用权限开发为例进行讲解。开发过程中,首先需要明确涉及的敏感权限,并在config.json中声明该权限,在安装应用程序时,包管理器会调用应用权限管理组件的接口检查该权限是否被授予,若授予,安装流程正常进行,否则安装失败。 122 1231. 在开发过程中,包管理器明确需要安装应用的权限(ohos.permission.INSTALL\_BUNDLE),并声明该权限; 124 FA模型:需要在config.json中声明权限,示例: 125 ```json 126 { 127 "module": { 128 "package": "ohos.demo.kitframework", 129 "deviceType": [ 130 "phone", "tv","tablet", "car","smartWatch","sportsWatch","smartCamera", "smartVision" 131 ], 132 "reqPermissions": [{ 133 "name": "ohos.permission.INSTALL_BUNDLE", 134 "reason": "install bundle", 135 "usedScene": { 136 "ability": [ 137 "KitFramework" 138 ], 139 "when": "always" 140 } 141 }, 142 { 143 "name": "ohos.permission.LISTEN_BUNDLE_CHANGE", 144 "reason": "install bundle", 145 "usedScene": { 146 "ability": [ 147 "KitFramework" 148 ], 149 "when": "always" 150 } 151 }, 152 { 153 "name": "ohos.permission.GET_BUNDLE_INFO", 154 "reason": "install bundle", 155 "usedScene": { 156 "ability": [ 157 "KitFramework" 158 ], 159 "when": "always" 160 } 161 } 162 ] 163 } 164 } 165 ``` 166 Stage模型:需要在module.json5中声明权限,示例: 167 ```json 168 { 169 "module": { 170 "requestPermissions": [{ 171 "name": "ohos.permission.INSTALL_BUNDLE", 172 "reason": "install bundle", 173 "usedScene": { 174 "ability": [ 175 "KitFramework" 176 ], 177 "when": "always" 178 } 179 }, 180 { 181 "name": "ohos.permission.LISTEN_BUNDLE_CHANGE", 182 "reason": "install bundle", 183 "usedScene": { 184 "ability": [ 185 "KitFramework" 186 ], 187 "when": "always" 188 } 189 }, 190 { 191 "name": "ohos.permission.GET_BUNDLE_INFO", 192 "reason": "install bundle", 193 "usedScene": { 194 "ability": [ 195 "KitFramework" 196 ], 197 "when": "always" 198 } 199 }] 200 } 201 } 202 ``` 203 2042. 当包管理器开发应用安装功能接口时,会调用权限管理相关接口检查自身是否具有安装应用程序的权限,例如:以安装应用的权限名"ohos.permission.INSTALL\_BUNDLE"作为入参,调用CheckPermission接口检查包管理器是否具有安装应用的权限,如果有权限,安装流程继续执行,否则返回安装失败; 205 206 ```c++ 207 constexpr static char PERMISSION_INSTALL_BUNDLE[] = "ohos.permission.INSTALL_BUNDLE"; 208 209 bool Install(const char *hapPath, const InstallParam *installParam, InstallerCallback installerCallback) 210 { 211 if ((hapPath == nullptr) || (installerCallback == nullptr) || (installParam == nullptr)) { 212 HILOG_ERROR(HILOG_MODULE_APP, "BundleManager install failed due to nullptr parameters"); 213 return false; 214 } 215 // 检查ohos.permission.INSTALL_BUNDLE权限是否被授予 216 if (CheckPermission(0, static_cast<const char *>(PERMISSION_INSTALL_BUNDLE)) != GRANTED) { 217 HILOG_ERROR(HILOG_MODULE_APP, "BundleManager install failed due to permission denied"); 218 return false; // 返回安装失败 219 } 220 // 安装流程 221 ... 222 } 223 ``` 224 225 226**轻量系统、小型系统IPC通信鉴权**: 227 228使用说明:以BMS服务通过IPC通信方式对外开放接口为例,讲解如何通过IPC通信鉴权组件配置对应接口的访问策略。这里BMS在Samgr中注册的service为bundlems,为开放的接口注册的Feature为BmsFeature。 229 2301. 在源码路径下的头文件base/security/permission\_lite/services/ipc\_auth/include/policy\_preset.h中配置相应的访问策略,访问策略主要有三种类型: 231 232 (1)type为RANGE类型:允许某个特定范围UID的进程访问,需要指定uidMin和uidMax; 233 234 (2)type为FIXED类型:允许指定的几个UID的进程访问,需要指定fixedUid,最多配置8个; 235 236 (3)type为BUNDLENAME类型:只允许特定的应用访问,需要指定bundleName(包名); 237 238 ```c++ 239 FeaturePolicy bmsFeature[] = { 240 { 241 "BmsFeature", 242 { 243 { 244 .type=FIXED, // 允许指定UID的进程访问的方式 245 .fixedUid={2, 3, 8} 246 }, 247 { 248 .type=RANGE, // 允许特定范围内的UID的进程访问的方式 249 .uidMin=100, 250 .uidMax=__INT_MAX__, 251 }, 252 } 253 }, 254 { 255 "BmsInnerFeature", 256 { 257 { 258 .type=FIXED, // 允许指定UID的进程访问的方式 259 .fixedUid={2, 3, 8} 260 }, 261 { 262 .type=RANGE, 263 .uidMin=100, 264 .uidMax=999, 265 }, 266 } 267 }, 268 }; 269 ``` 270 2712. 将步骤1中定义的Feature的策略加配到全局策略中,需要配置feature数量; 272 273 ```c++ 274 static PolicySetting g_presetPolicies[] = { 275 {"permissionms", pmsFeature, 1}, 276 {"abilityms", amsFeature, 2}, 277 {"bundlems", bmsFeature, 2}, // 步骤1定义的BMS的feature,数量为2 278 {"dtbschedsrv", dmsFeature, 1}, 279 {"samgr", samgrFeature, 1}, 280 {"appspawn", appspawnFeature, 1}, 281 {"WMS", wmsFeature, 1}, 282 {"bundle_daemon", bdsFeature, 1}, 283 }; 284 ``` 285 2863. 将步骤1中定义的BmsFeature注册到Samgr; 287 288 ```c++ 289 const char BMS_SERVICE[] = "bundlems"; 290 const char BMS_FEATURE[] = "BmsFeature"; 291 static void Init() 292 { 293 SamgrLite *sm = SAMGR_GetInstance(); 294 if (sm == nullptr) { 295 return; 296 } 297 // 注册服务到Samgr 298 sm->RegisterFeature(BMS_SERVICE, reinterpret_cast<Feature *>(BundleMsFeature::GetInstance())); 299 sm->RegisterFeatureApi(BMS_SERVICE, BMS_FEATURE, 300 GetBmsFeatureApi(reinterpret_cast<Feature *>(BundleMsFeature::GetInstance()))); 301 HILOG_DEBUG(HILOG_MODULE_APP, "BundleMS feature start success"); 302 } 303 APP_FEATURE_INIT(Init); 304 ``` 305 306 307完成以上开发步骤后,开发者在Samgr注册服务时,Samgr会调用IPC通信鉴权组件的GetCommunicationStrategy接口获取服务的访问策略;当其他服务或应用通过IPC方式访问这些服务时,Samgr会调用IPC通信鉴权组件的IsCommunicationAllowed接口检查调用者服务的权限,如果满足访问策略,则可以访问开发者接口,否则拒绝访问。 308 309## 相关仓<a name="section1371113476307"></a> 310安全子系统 311**[security\_permission\_lite](https://gitee.com/openharmony/security_permission_lite/blob/master/README_zh.md)** 312