• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 应用特权配置指南
2
3应用特权是指应用所具备的一些高等级的特殊能力，比如限制应用不可被卸载、应用内数据不可被删除等。
4
5OpenHarmony提供通用的应用特权和可由设备厂商针对不同设备单独配置的应用特权。
6
7注：应当注意不要滥用应用特权，避免造成用户反感甚至对用户造成侵权。
8
9## 通用应用特权
10
11### 简介
12
13通用的应用特权是指应用在不同设备类型上都可以获得的特权，可分为以下几种：
14
15| 权限 | 描述                                                       |
16| ---------------- | ------------------------------------------------------------ |
17| AllowAppDataNotCleared | 是否允许应用数据被删除 |
18| AllowAppMultiProcess | 是否允许应用多进程 |
19| AllowAppDesktopIconHide | 是否允许隐藏桌面图标 |
20| AllowAbilityPriorityQueried | 是否允许Ability配置查询优先级     |
21| AllowAbilityExcludeFromMissions | 是否允许Ability不在任务栈中显示 |
22| AllowAppUsePrivilegeExtension | 是否允许应用使用ServiceExtension、DataExtension |
23| AllowFormVisibleNotify | 是否允许桌面卡片可见 |
24
25### 配置方式
26
271. 在[HarmonyAppProvision文件](../../application-dev/security/app-provision-structure.md)中添加字段”app-privilege-capabilities“，按需配置通用权限能力。
282. 使用签名工具对HarmonyAppProvision文件重新签名，生成p7b文件
293. 使用p7b文件签名hap
30
31参考：[应用签名](https://gitee.com/openharmony/developtools_hapsigner#hap%E5%8C%85%E7%AD%BE%E5%90%8D%E5%B7%A5%E5%85%B7 )
32
33### 示例
34
35```
36{
37    "version-name": "1.0.0",
38    ...
39    "bundle-info": {
40        "developer-id": "OpenHarmony",
41        ...
42    },
43    "issuer": "pki_internal",
44    "app-privilege-capabilities": ["AllowAppDataNotCleared", "AllowAppDesktopIconHide"] // 应用的数据不允许被删除且允许隐藏桌面图标
45}
46```
47
48
49
50## 可由设备厂商配置的特权
51
52### 简介
53
54除了通用应用特权外，设备厂商还可以为各类设备额外定义允许配置的特权项，包括：
55
56| 权限                  | 类型     | 默认值 | 描述                                              |
57| --------------------- | -------- | ------ | ------------------------------------------------- |
58| removable             | bool     | true   | 是否允许应用被卸载，仅预置应用生效                |
59| keepAlive             | bool     | false  | 是否允许应用常驻                                  |
60| singleton             | bool     | false  | 是否允许应用安装到单用户下(U0)                    |
61| allowCommonEvent      | string[] | -      | 是否允许静态广播拉起                              |
62| associatedWakeUp      | bool     | false  | 是否允许FA模型应用被关联唤醒                      |
63| runningResourcesApply | bool     | false  | 是否允许应用运行资源申请（CPU、事件通知、蓝牙等） |
64
65### 配置方式
66
67按需在[产品配置文件](https://gitee.com/openharmony/vendor_hihope/tree/master/rk3568/preinstall-config)中配置。
68
69### 示例
70
71#### install_list_capability.json中配置
72
73```
74{
75    "install_list": [
76        {
77            "bundleName": “com.example.kikakeyboard”,
78            "singleton": true, // 应用安装到单用户下
79            "keepAlive": true, // 应用常驻
80            "runningResourcesApply": true, // 运行资源申请（CPU、事件通知、蓝牙等）
81            "associatedWakeUp": true, // FA模型应用被关联唤醒
82            "app_signature" : [“8E93863FC32EE238060BF69A9B37E2608FFFB21F93C862DD511CBAC”], // 当配置的证书指纹和hap的证书指纹一致才生效
83            "allowCommonEvent": [“usual.event.SCREEN_ON”, “usual.event.THERMAL_LEVEL_CHANGED”]
84        },
85}
86```
87
88**证书指纹获取**
89
90**步骤一、证书存放在HarmonyAppProvision文件的distribution-certificate字段下，新建profile.cer文件，将证书的内容拷贝到profile.cer文件中**
91
92示例
93
94```
95{
96    ...
97    "bundle-info": {
98        "distribution-certificate": "-----BEGIN CERTIFICATE----\nMIICMzCCAbegAwIBAgIEaOC/zDAMBggqhkjOPQQDAwUAMk..." /证书的内容
99        ...
100    }
101    ...
102}
103```
104
105**步骤二、将profile.cer内容换行和去掉换行符**
106
107示例
108
109```
110-----BEGIN CERTIFICATE-----
111MIICMzCCAbegAwIBAgIEaOC/zDAMBggqhkjOPQQDAwUAMGMxCzAJBgNVBAYTAkNO
112MRQwEgYDVQQKEwtPcGVuSGFybW9ueTEZMBcGA1UECxMQT3Blbkhhcm1vbnkgVGVh
113bTEjMCEGA1UEAxMaT3Blbkhhcm1vbnkgQXBwbGljYXRpb24gQ0EwHhcNMjEwMjAy
114MTIxOTMxWhcNNDkxMjMxMTIxOTMxWjBoMQswCQYDVQQGEwJDTjEUMBIGA1UEChML
115T3Blbkhhcm1vbnkxGTAXBgNVBAsTEE9wZW5IYXJtb255IFRlYW0xKDAmBgNVBAMT
116H09wZW5IYXJtb255IEFwcGxpY2F0aW9uIFJlbGVhc2UwWTATBgcqhkjOPQIBBggq
117hkjOPQMBBwNCAATbYOCQQpW5fdkYHN45v0X3AHax12jPBdEDosFRIZ1eXmxOYzSG
118JwMfsHhUU90E8lI0TXYZnNmgM1sovubeQqATo1IwUDAfBgNVHSMEGDAWgBTbhrci
119FtULoUu33SV7ufEFfaItRzAOBgNVHQ8BAf8EBAMCB4AwHQYDVR0OBBYEFPtxruhl
120cRBQsJdwcZqLu9oNUVgaMAwGCCqGSM49BAMDBQADaAAwZQIxAJta0PQ2p4DIu/ps
121LMdLCDgQ5UH1l0B4PGhBlMgdi2zf8nk9spazEQI/0XNwpft8QAIwHSuA2WelVi/o
122zAlF08DnbJrOOtOnQq5wHOPlDYB4OtUzOYJk9scotrEnJxJzGsh/
123-----END CERTIFICATE-----
124```
125
126**步骤三、使用keytool工具打印对应的证书指纹**
127
128示例
129
130```
131keytool -printcert -file profile.cer
132result:
133所有者: CN=OpenHarmony Application Release, OU=OpenHarmony Team, O=OpenHarmony, C=CN
134发布者: CN=OpenHarmony Application CA, OU=OpenHarmony Team, O=OpenHarmony, C=CN
135序列号: 68e0bfcc
136生效时间: Tue Feb 02 20:19:31 CST 2021, 失效时间: Fri Dec 31 20:19:31 CST 2049
137证书指纹:
138         SHA1: E3:E8:7C:65:B8:1D:02:52:24:6A:06:A4:3C:4A:02:39:19:92:D1:F5
139         SHA256: 8E:93:86:3F:C3:2E:E2:38:06:0B:F6:9A:9B:37:E2:60:8F:FF:B2:1F:93:C8:62:DD:51:1C:BA:C9:F3:00:24:B5 // 证书指纹，去掉冒号，最终结果为8E93863FC32EE238060BF69A9B37E2608FFFB21F93C862DD511CBAC9F30024B5
140...
141```
142
143
144
145#### install_list.json中配置
146
147```
148{
149     "install_list" : [
150        {
151            "app_dir" : "/system/app/com.ohos.launcher",
152            "removable" : true // 应用是否可卸载
153        }
154     ]
155}
156```
157
158
159
160