本文聚焦应用原生组件与业务编码层面的安全风险治理,为HarmonyOS应用通用安全编码提供指导。HarmonyOS应用基于Ability组件、跨组件Want通信、公共事件广播、WebView容器、本地数据存储、工程配置及应用签名等系统核心能力进行开发,在提供业务灵活性的同时,也面临组件暴露越权、隐式启动数据泄露、公共事件无权限被滥用、Web容器恶意注入、SQL注入与路径遍历、敏感数据剪贴板泄露、调试配置外泄、签名不合规等多重安全威胁,易导致隐私泄露、恶意调用、中间人攻击、应用被逆向破解及上架合规不通过等问题。
本文基于HarmonyOS应用典型漏洞与合规要求,从通用组件安全、公共事件安全、WebView安全、数据传递安全、数据存储安全、配置安全、应用签名安全七大维度,系统梳理安全编码规范。通过风险说明、错误示例、规范代码示例及业务例外说明,明确各类开发场景的禁止行为与合规实现方案,同时兼顾开发调试与正式发布的差异化配置要求。帮助开发者建立全链路安全编码意识,规避常见高危漏洞,规范应用权限管控、数据处理、组件交互与打包签名行为,提升应用整体安全防护能力,满足个人信息保护、隐私合规及应用市场上架安全审核要求。
应用程序内部使用的组件必须设置为不可见,以防止其他应用程序调用。
不对外交互的应用组件应显式设置exported属性为false,防止遗漏和错误配置。这可避免内部接口被恶意应用利用,导致信息泄露、功能异常或应用拒绝服务等问题。
当应用组件的exported属性设置为false时,使用DevEco Studio启动调试或运行应用/服务,或通过命令行拉起时,会出现安装HAP错误,提示“error: failed to start ability. error: ability visible false deny request”。系统安全权限不允许拉起exported属性设置为false的应用/服务。建议在调试阶段将exported属性设置为true,正式上架发布时再设置为false。
错误示例:
"name": "PrivacyErrorAbility", "srcEntry": "./ets/privacyerrorability/PrivacyErrorAbility.ets", "description": "$string:PrivacyErrorAbility_desc", "exported": true,
PrivacyAbility 是一个不对外交互的组件,但设置exported属性为true后,任何应用都能访问该组件。
正确示例:
"name": "PrivacyAbility", "srcEntry": "./ets/privacyability/PrivacyAbility.ets", "description": "$string:PrivacyAbility_desc", "exported": false,
应用程序组件不仅在内部使用,还需要与外部进行交互。以下情况表明组件是对外交互的:
程序内应用组件如果允许对外交互,数据会跨越信任边界,若被恶意应用程序利用,可能导致信息泄露、功能异常或应用拒绝服务等问题。因此,应使用“permissions”属性为对外交互的应用组件设置访问权限。
敏感功能和对外提供的Ability存在利用风险,建议相关组件设置权限进行保护。
1)未经用户操作确认,系统即可执行关键操作,例如发送短信、拨打电话、拍照、录音、录屏、截屏和定位等。
2)导致个人数据和敏感数据泄露的关键操作,例如:读取短信、读取联系人和读取设备标识符等。
3)导致权限提升,例如:可以执行原本需要system权限的操作。
例外情况:必须对外提供且无利用风险的应用组件,可以不设置权限。
错误示例:
// module.json5
"abilities": [
{
"name": "ContactDataAbility",
"srcEntry": "./ets/DataAbility/DataAbility.ts",
"description": "$string: DataAbility_desc",
"exported": true
}
] 任意外部应用都可以访问此ContactDataAbility,恶意应用可能利用该组件获取联系人数据。
正确示例:
// module.json5
"abilities": [
{
"name": "ContactDataAbility",
"srcEntry": "./ets/DataAbility/DataAbility.ts",
"description": "$string: DataAbility_desc",
"exported": true,
"permissions": ["ohos.permission.READ_CONTACTS"]
}
] 隐式want是通过action条件匹配的方式来筛选组件,凡是满足条件的应用组件都有被启动的可能。如果携带个人数据,则恶意应用有可能劫持携带的个人数据。应用程序如果要携带个人数据,需要显式指定目标应用组件(bundle名、ability名)或者将个人数据匿名化。示例中的context的获取方式请参见获取UIAbility的上下文信息。
错误示例:
import { Want } from '@kit.AbilityKit';
// ...
let wantInfo:Want = {
deviceId: '',
action: 'ability.want.test',
parameters: {
'password': 'xxxxxxxx'
}
};
try{
let data = this.context.startAbility(wantInfo);
hilog.info(0x0000, 'privacy', 'startAbility success ' + JSON.stringify(data));
} catch (err) {
hilog.error(0x0000, 'privacy', 'startAbility with error message: ' + err.message + ', error code: ' + err.code);
} 通过示例代码中的action:"ability.want.test" 可以隐式启动组件。如果恶意应用也声明了相同的action,隐式调用时将显示一个列表供用户选择。如果用户选择了恶意应用,该应用可能会获取传递的敏感信息。
正确示例:
import { Want } from '@kit.AbilityKit';
// ...
let wantInfo:Want = {
deviceId: '',
action: 'ability.want.test',
bundleName:'com.example.myapplication10',
abilityName:'MainAbility1',
parameters: {
'password': 'xxxxxxxx'
}
}
try{
let data = this.context.startAbility(wantInfo);
hilog.info(0x0000, 'privacy', 'startAbility success ' + JSON.stringify(data));
} catch (err) {
hilog.error(0x0000, 'privacy', 'startAbility with error message: ' + err.message + ', error code: ' + err.code);
} 这里显式指定了需要拉起的应用组件的bundleName和abilityName,只会拉起指定的目标组件。
口令输入界面包含账号密码输入框和输入法弹出框。在用户输入口令时,应禁止截屏或录屏操作。如果恶意软件获得授权,窃取用户账号和密码,便可能在其他设备上登录,导致用户隐私泄露。
实施指导:
在需要保护的Page页面调用setWindowPrivacyMode()方法,禁止截屏和录屏。
注意:使用此接口前,需申请ohos.permission.PRIVACY_WINDOW权限。
正确示例:
在口令输入、转账支付页面中设置隐私属性,防止截屏/录屏:
import { window } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
@Entry
@Component
struct Index {
@State message: string = 'Hello World';
onPageShow(): void {
window.getLastWindow(this.getUIContext().getHostContext()).then((windowStage: window.Window) => {
windowStage.setWindowPrivacyMode(true);
}).catch((error: BusinessError) => {
hilog.error(0x0000, 'PrivacyMode', `getLastWindow error code ${error.code}`)
});
}
onPageHide(): void {
window.getLastWindow(this.getUIContext().getHostContext()).then((windowStage: window.Window) => {
windowStage.setWindowPrivacyMode(false);
}).catch((error: BusinessError) => {
hilog.error(0x0000, 'PrivacyMode', `getLastWindow error code ${error.code}`)
});
}
build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
Button('click to start Succ Page')
.onClick(async () => {
this.getUIContext().getRouter().pushUrl({ url: 'pages/loginSuccPage' });
})
}
.width('100%')
}
.height('100%')
}
} 不同应用程序可以通过公共事件进行进程间通信。如果公共事件的发送权限设置不当,并且携带个人数据,任何应用都可能读取这些个人数据,导致用户数据泄露。
对于携带个人数据的公共事件,需设置发送权限或加密个人数据。
错误示例:
import { commonEventManager } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
function publishEventWithData() {
let options: commonEventManager.CommonEventPublishData = {
code: 1,
data: 'ContactData', // Sending sensitive data
}
commonEventManager.publish('MyCommonEvent', options, (err) => {
if (err.code) {
hilog.error(0x0000, 'privacy', `publish event error: ${err.code} ${err.message} ${err.name} ${err.stack}`);
} else {
hilog.info(0x0000, 'privacy', 'publish event with data Succeeded');
}
})
} 发送了一个包含联系人数据的公共事件,但未设置接收方所需的权限。
import { commonEventManager } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
function publishEventWithData() {
let options: commonEventManager.CommonEventPublishData = {
code: 1,
data: 'ContactData', // Sending sensitive data
subscriberPermissions: ['ohos.permission.READ_CONTACTS'], // Set the permission
}
commonEventManager.publish('MyCommonEvent', options, (err) => {
if (err.code) {
hilog.error(0x0000, 'privacy', `publish event error: ${err.code} ${err.message} ${err.name} ${err.stack}`);
} else {
hilog.info(0x0000, 'privacy', 'publish event with data Succeeded');
}
})
} 通过subscriberPermissions字段设置接收权限,发布者要求订阅者具有“ohos.permission.READ_CONTACTS”权限,才能接收携带联系人数据的公共事件。
应用支持订阅自定义公共事件,并在接收到事件后执行相应功能。订阅公共事件时,需通过publisherPermission设置接收权限。若未设置权限,任意应用可发送同名自定义公共事件,可能导致接收应用拒绝服务或敏感功能泄露。
对于涉及敏感数据或操作的公共事件,订阅方必须设置足够高的权限。
错误示例:
import { commonEventManager } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
let subscriber: commonEventManager.CommonEventSubscriber;
//Subscriber information
let subscribeInfo: commonEventManager.CommonEventSubscribeInfo = {
events: ['event']
};
// Create a subscriber
try {
commonEventManager.createSubscriber(subscribeInfo, (err, commonEventSubscriber) => {
if (!err) {
hilog.info(0x0000, 'privacy', 'createSubscriber Succeed');
subscriber = commonEventSubscriber;
//Subscribe to public events
try {
commonEventManager.subscribe(subscriber, (err, data) => {
if (err) {
hilog.error(0x0000, 'privacy', `subscribe failed, code is ${err.code}, message is ${err.message}`);
} else {
//Event processing after receiving public events
// doSomeDangerousThing(data)
}
});
} catch (err) {
hilog.error(0x0000, 'privacy', `subscribe failed, code is ${err.code}, message is ${err.message}`);
}
} else {
hilog.error(0x0000, 'privacy', `createSubscriber failed, code is ${err.code}, message is ${err.message}`);
}
});
} catch (err) {
hilog.error(0x0000, 'privacy', `createSubscriber failed, code is ${err.code}, message is ${err.message}`);
} import { commonEventManager } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
let subscriber: commonEventManager.CommonEventSubscriber;
//Subscriber information
let subscribeInfo: commonEventManager.CommonEventSubscribeInfo = {
events: ['event'],
publisherPermission: 'ohos.permission.publisherPermission1', // Set the subscription permission
};
// Create a subscriber
try {
commonEventManager.createSubscriber(subscribeInfo, (err, commonEventSubscriber) => {
if (!err) {
hilog.info(0x0000, 'privacy', 'createSubscriber');
subscriber = commonEventSubscriber;
//Subscribe to public events
try {
commonEventManager.subscribe(subscriber, (err, data) => {
if (err) {
hilog.error(0x0000, 'privacy', `subscribe failed, code is ${err.code}, message is ${err.message}`);
} else {
//Event processing after receiving public events
// doSomeDangerousThing(data)
}
});
} catch (err) {
hilog.error(0x0000, 'privacy', `subscribe failed, code is ${err.code}, message is ${err.message}`);
}
} else {
hilog.error(0x0000, 'privacy', `createSubscriber failed, code is ${err.code}, message is ${err.message}`);
}
});
} catch (err) {
hilog.error(0x0000, 'privacy', `createSubscriber failed, code is ${err.code}, message is ${err.message}`);
} 常见敏感功能和对外提供的公共事件存在利用风险。建议对涉及这些情况的公共事件设置权限保护。
1)未经用户确认,系统可执行关键操作,如发送短信、拨打电话、拍照、录音、录屏、截屏、定位等。
2)导致个人数据和敏感数据泄露的关键操作包括:读取短信、读取联系人、读取设备标识符等。
3)导致权限提升,例如:进行原本需要system权限的操作。
例外情况:必须对外提供且无利用风险的应用公共事件,可以不设置权限。
Web组件或WebController均可以加载URL或页面。如果加载的URL或页面被攻击者控制,可能会加载恶意JS代码,从而调用ArkTS开放的敏感JS接口,获取用户个人数据或对应用进行攻击。
需要在加载URL之前,通过Web组件的onLoadIntercept()方法拦截URL,获取并校验其字段值是否在业务预置的白名单内。
正确示例:
import { uri } from '@kit.ArkTS';
import { webview } from '@kit.ArkWeb';
import { hilog } from '@kit.PerformanceAnalysisKit';
// Check function
function checkUrl(str: string): boolean {
let tmpUri = new uri.URI(str);
let res =
tmpUri.normalize(); // Note that you need to normalize tmpUri first. Otherwise, security verification will be bypassed
hilog.info(0x0000, 'privacy', 'res.scheme:' + res.scheme); // Protocol
hilog.info(0x0000, 'privacy', 'res.host:' + res.host); // domain name
hilog.info(0x0000, 'privacy', 'res.port:' + res.port); // Ports
hilog.info(0x0000, 'privacy', 'res.path:' + res.path); // Path
hilog.info(0x0000, 'privacy', 'res.ssp:' + res.ssp);
// After obtaining the values of scheme, host, port, and path, perform security verification based on the actual service
// Omit the part here. Perform the verification based on service requirements
if ('校验成功') {
return true;
}
return false;
}
@Entry
@Component
struct WebComponent {
controller: webview.WebviewController = new webview.WebviewController();
build() {
Column() {
Button('loadUrl')
.onClick(() => {
this.controller.loadUrl('www.huawei.com');
})
.margin({ top: 50 })
Web({ src: 'www.huawei.com', controller: this.controller })
.onLoadIntercept((event) => {
hilog.info(0x0000, 'privacy', 'onLoadIntercept:' + event.data.toString());
let tempUrl = event.data.toString();
return checkUrl(tempUrl); // Return true to block the load, otherwise allow the load
})
}
}
} 例外:如果应用本身是提供URL加载能力的,譬如浏览器等,可以例外。但是要注意,如果应用也提供了敏感的JS接口,要注意防范可能的被恶意调用的风险。
WebController提供了runJavaScript()和runJavaScriptExt()函数用于异步执行JavaScript脚本,并通过回调方式返回脚本执行的结果。以runJavaScript为例:
import { webview } from '@kit.ArkWeb';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
@Entry
@Component
struct WebComponent {
controller: webview.WebviewController = new webview.WebviewController();
build() {
Column() {
Web({ src: $rawfile('index.html'), controller: this.controller })
.javaScriptAccess(true)
.onPageEnd(e => {
this.controller.runJavaScript('test()')
.then((result) => {
hilog.info(0x0000, 'privacy', 'result: ' + result);
})
.catch((error: BusinessError) => {
hilog.error(0x0000, 'privacy', `ErrorCode: ${error.code}, Message: ${error.message}`);
})
if (e) {
hilog.info(0x0000, 'privacy', 'url: ', e.url);
}
})
}
}
} 加载的index.html文件内容如下:
<!DOCTYPE html>
<html>
<meta charset="utf-8">
<body>
Hello world!
</body>
<script type="text/javascript">
function test() {
console.log('Ark WebComponent')
return "This value is from index.html"
}
</script>
</html> 如果加载的脚本内容不可信,可能会导致恶意JavaScript代码的加载,引发XSS攻击。若Web组件注册了敏感的JavaScript接口,恶意代码还可能调用这些接口,进一步影响应用的安全性。
若待加载的JavaScript脚本外部可控,加载前需进行白名单校验。
正确示例:
import { webview } from '@kit.ArkWeb';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
@Entry
@Component
struct WebComponent {
controller: webview.WebviewController = new webview.WebviewController();
build() {
Column() {
Web({ src: $rawfile('index.html'), controller: this.controller })
.javaScriptAccess(true)
.onPageEnd(e => {
let whiteMethods = ['test()', 'test1()'];
let jsMethod: string = 'alert(`xss`)'; // Externally controllable fields
// Check the trustlist
if (whiteMethods.indexOf(jsMethod) === -1) {
hilog.error(0x0000, 'privacy', 'input method not in whiteList');
return;
}
this.controller.runJavaScript(jsMethod)
.then((result) => {
hilog.info(0x0000, 'privacy', 'result: ' + result);
})
.catch((error: BusinessError) => {
hilog.error(0x0000, 'privacy', `ErrorCode: ${error.code}, Message: ${error.message}`);
})
if (e) {
hilog.info(0x0000, 'privacy', 'url: ', e.url);
}
})
}
}
} 错误示例:
import { webview } from '@kit.ArkWeb';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
@Entry
@Component
struct WebComponent {
controller: webview.WebviewController = new webview.WebviewController();
build() {
Column() {
Web({ src: $rawfile('index.html'), controller: this.controller })
.javaScriptAccess(true)
.onPageEnd(e => {
let jsMethod: string = 'alert(`xss`)' // Externally controllable fields
this.controller.runJavaScript(jsMethod)
.then((result) => {
hilog.info(0x0000, 'privacy', 'result: ' + result);
})
.catch((error: BusinessError) => {
hilog.error(0x0000, 'privacy', `ErrorCode: ${error.code}, Message: ${error.message}`);
})
if (e) {
hilog.info(0x0000, 'privacy', 'url: ', e.url);
}
})
}
}
} mixedMode设置是否允许加载超文本传输协议(HTTP)和超文本传输安全协议(HTTPS)混合内容,默认不允许加载HTTP和HTTPS混合内容。支持三种模式,其中All是允许混合内容加载,存在中间人攻击的风险,默认不允许配置成All。
错误示例:
import { webview } from '@kit.ArkWeb';
@Entry
@Component
struct WebComponent {
controller: webview.WebviewController = new webview.WebviewController();
build() {
Column() {
Web({ src:'www.huawei.com', controller: this.controller })
.mixedMode(MixedMode.All)
}
}
} 应该去掉此配置项,或者选择MixedMode.None模式。
例外:对于提供特定业务的应用可以例外,例如浏览器。
onSslErrorEventReceive()回调函数用于通知用户加载资源时发生SSL错误。
当Web组件通过SSL协议进行网络请求时,默认情况下,如果底层Web组件校验服务端返回的证书或协议出错,则应取消请求,以避免中间人攻击风险。
import { webview } from '@kit.ArkWeb';
import { hilog } from '@kit.PerformanceAnalysisKit';
@Entry
@Component
struct WebComponent {
controller: webview.WebviewController = new webview.WebviewController();
build() {
Column() {
Web({ src: 'www.example.com', controller: this.controller })
.onSslErrorEventReceive((event) => {
hilog.info(0x0000, 'privacy', 'ssl check failed,error is : ' + event.error.toString());
event.handler.handleCancel();
})
}
}
} 错误示例:
import { webview } from '@kit.ArkWeb';
@Entry
@Component
struct WebComponent {
controller: webview.WebviewController = new webview.WebviewController();
build() {
Column() {
Web({ src: 'www.example.com', controller: this.controller })
.onSslErrorEventReceive((event) => {
event.handler.handleConfirm();
})
}
}
} 如果在SSL校验出错时直接调用handleConfirm()函数,页面将忽略SSL错误并继续加载,从而导致中间人攻击等风险。
例外:对于浏览器等用于加载URL的应用可以例外,但需要在页面显式告知用户待加载页面存在安全风险。
geolocationAccess开关用于配置是否开启地理位置权限,默认开启。onGeolocationShow()回调函数用于通知用户收到地理位置信息获取请求。H5页面请求获取地理位置信息时,Web组件通过上述两个API进行配置。
无使用场景时,显式禁用geolocationAccess()。存在使用场景时,需在onGeolocationShow()回调内先弹框提示用户,经用户确认和同意后才能返回位置信息,否则存在隐私泄露风险。
import { webview } from '@kit.ArkWeb';
@Entry
@Component
struct WebComponent {
controller: webview.WebviewController = new webview.WebviewController();
build() {
Column() {
Web({ src: 'www.example.com', controller: this.controller })
.geolocationAccess(true)
.onGeolocationShow((event) => {
if (event === undefined) {
return;
}
this.getUIContext().showAlertDialog({
title: 'title',
message: 'text',
confirm: {
value: 'onConfirm',
action: () => {
event.geolocation.invoke(event.origin, true, true);
}
},
cancel: () => {
event.geolocation.invoke(event.origin, false, true);
}
});
})
}
}
} 错误示例:
import { webview } from '@kit.ArkWeb';
@Entry
@Component
struct WebComponent {
controller: webview.WebviewController = new webview.WebviewController();
build() {
Column() {
Web({ src: 'www.example.com', controller: this.controller })
.geolocationAccess(true)
.onGeolocationShow((event) => {
if (event === undefined) {
return;
}
event.geolocation.invoke(event.origin, true, true);
})
}
}
} 在使用位置权限的场景中,不能直接返回位置信息。必须先明确告知用户并获得其同意后,才能返回位置信息。
在HarmonyOS中,可以使用Web组件加载H5等页面。同时Web组件可以通过JavaScriptProxy()方法或者通过WebController的registerJavaScriptProxy()方法向H5提供JS接口,供H5访问。
如果提供的JS接口返回敏感信息或涉及敏感操作,被恶意调用,则存在安全风险。特别是当JS接口返回用于认证用户身份的全局认证凭据ServiceToken(简称ST)或AccessToken(简称AT)时,攻击者获取这些凭据后,可以冒充用户恶意调用应用在云端的所有接口,扩大攻击影响。因此,禁止Web组件提供获取全局认证凭据ST或AT的JavaScriptProxy。
错误示例:
import { webview } from '@kit.ArkWeb';
@Entry
@Component
struct Index {
controller: webview.WebviewController = new webview.WebviewController();
build() {
Column() {
Row() {
Button('registerJavaScriptProxy').onClick(() => {
this.controller.registerJavaScriptProxy(
{
getServiceToken: () => {
return 'DLFJSLDFJALGJLDFJSDDFISLDF323LSDJFLS212DLSFJOEV';
}
},
'objName',
['getServiceToken'],
);
this.controller.refresh();
})
}
Web({ src: $rawfile('H5CallETS.html'), controller: this.controller })
.javaScriptAccess(true)
.javaScriptProxy({
object: {
getServiceToken: () => {
return 'DLFJSLDFJALGJLDFJSDDFISLDF323LSDJFLS212DLSFJOEV';
}
},
name: 'objName',
methodList: ['getServiceToken'],
controller: this.controller
})
}
}
} H5攻击界面:
<!DOCTYPE html>
<html>
<meta charset="utf-8">
<body>
Hello js call ets interface!
<br>
<script type="text/javascript">
function callJSInt() {
let ST = objName.getServiceToken();
console.log('wzz:ST = '+ ST);
alert(ST);
}
</script>
<button onclick="callJSInt()">get ST</button>
</body>
</html> 提供了一个ST接口,用于H5调用以获取全局认证凭据。如果H5存在漏洞,攻击者可能获取此ST并冒充用户访问云服务上的个人数据,进行恶意操作。
为了降低全局认证凭据ST或AT丢失带来的安全风险,推荐以下两种方法:
第一种方法:在加载URL页面前,校验当前页面的URL是否在白名单内,仅允许白名单内的URL调用。要同时校验协议、域名、PATH等,白名单范围控制的越小越安全。
校验方法可使用如下API格式化相关URL,跟预置的数据进行比较。
1. 使用URI库进行URL格式化,准确获取URL各字段值,并校验这些值是否在业务预置的白名单内。
// Index.ets
import { uri } from '@kit.ArkTS';
import { webview } from '@kit.ArkWeb';
import { hilog } from '@kit.PerformanceAnalysisKit';
// Check function
function checkUrl(surl: string): boolean {
let tmpUri: uri.URI = new uri.URI(surl);
let res = tmpUri.normalize(); // Note that you need to normalize tmpUri first. Otherwise, security verification will be bypassed
hilog.info(0x0000, 'privacy', 'res.scheme:' + res.scheme); // scheme
hilog.info(0x0000, 'privacy', 'res.host:' + res.host); // host
hilog.info(0x0000, 'privacy', 'res.port:' + res.port); // port
hilog.info(0x0000, 'privacy', 'res.path:' + res.path); // path
hilog.info(0x0000, 'privacy', 'res.ssp:' + res.ssp);
// After obtaining the values of the scheme, host, port, and path parameters, perform security verification based on the service requirements
// The part is omitted here. The verification is performed based on the service requirements
if ('校验成功') {
return true;
}
return false;
}
@Entry
@Component
struct Index {
controller: webview.WebviewController = new webview.WebviewController();
build() {
Column() {
Row() {
Button('registerJavaScriptProxy').onClick(() => {
this.controller.registerJavaScriptProxy(
{
getServiceToken: () => {
return 'DLFJSLDFJALGJLDFJSDDFISLDF323LSDJFLS212DLSFJOEV';
}
},
'objName',
['getServiceToken'],
);
this.controller.refresh();
})
}
Web({ src: $rawfile('H5CallETS.html'), controller: this.controller })
.javaScriptProxy({
object: {
getServiceToken: () => {
return 'DLFJSLDFJALGJLDFJSDDFISLDF323LSDJFLS212DLSFJOEV';
}
},
name: 'objName',
methodList: ['getServiceToken'],
controller: this.controller
})
.onLoadIntercept((event) => {
hilog.info(0x0000, 'privacy', 'onLoadIntercept:' + event.data.toString());
let tempUrl = event.data.toString();
return checkUrl(tempUrl); // Returns true to block the load, otherwise allow the load
})
}
}
} // Index.ets
import { url } from '@kit.ArkTS';
import { webview } from '@kit.ArkWeb';
import { hilog } from '@kit.PerformanceAnalysisKit';
// Check Function
function checkUrl(surl: string): boolean {
let tmpUrl = url.URL.parseURL(surl);
hilog.info(0x0000, 'privacy', 'res.scheme:' + tmpUrl.protocol); // scheme
hilog.info(0x0000, 'privacy', 'res.host:' + tmpUrl.host); // host
hilog.info(0x0000, 'privacy', 'res.port:' + tmpUrl.port); // port
hilog.info(0x0000, 'privacy', 'res.path:' + tmpUrl.pathname); // path
hilog.info(0x0000, 'privacy', 'res.ssp:' + tmpUrl.hostname); // ssp
// After obtaining the values of the scheme, host, port, and path parameters, perform security verification based on the service requirements
// The part is omitted here. The verification is performed based on the service requirements
if ('校验成功') {
return true;
}
return false;
}
@Entry
@Component
struct Index {
controller: webview.WebviewController = new webview.WebviewController();
build() {
Column() {
Row() {
Button('registerJavaScriptProxy').onClick(() => {
this.controller.registerJavaScriptProxy(
{
getServiceToken: () => {
return 'DLFJSLDFJALGJLDFJSDDFISLDF323LSDJFLS212DLSFJOEV';
}
},
'objName',
['getServiceToken']
);
this.controller.refresh();
})
}
Web({ src: $rawfile('H5CallETS.html'), controller: this.controller })
.javaScriptAccess(true)
.javaScriptProxy({
object: {
getServiceToken: () => {
return 'DLFJSLDFJALGJLDFJSDDFISLDF323LSDJFLS212DLSFJOEV';
}
},
name: 'objName',
methodList: ['getServiceToken'],
controller: this.controller
})
.onLoadIntercept((event) => {
hilog.info(0x0000, 'privacy', 'wzz:onLoadIntercept:' + event.data.toString());
let tempUrl = event.data.toString();
return checkUrl(tempUrl); // Returns true to block the load, otherwise allow the load
})
}
}
} 第二种方法:针对H5页面申请一个新的H5Token,并严格限定此H5Token可以调用的云服务业务接口在最小范围内。
攻击者可能向指定应用Ability发送空的Want或携带恶意数据。如果应用接收这些Want,却没有进行合法性判断,可能会导致应用业务逻辑被篡改、数据泄露或财产损失。因此,应对外部传入的Want内容进行合法性判断。
常见的对Want的判断:
1. 在使用Want的数据属性之前,先判断其是否为null或undefined,确保访问的对象属性存在。
import { hilog } from '@kit.PerformanceAnalysisKit';
import { UIAbility, Want, AbilityConstant } from '@kit.AbilityKit';
// Check function
function checkWant(want: Want): boolean {
if (want === null || want === undefined) {
return false;
}
if (want.parameters === null || want.parameters === undefined) {
return false;
}
return true;
}
export default class EntryAbility extends UIAbility {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
if (checkWant(want)) {
hilog.info(0x0000, 'privacy', 'correct want');
} else {
hilog.info(0x0000, 'privacy', 'invalid want');
}
}
} 2. 使用Want的数据前,进行try...catch异常捕获,以防止应用崩溃,并且可以定位问题。
import { hilog } from '@kit.PerformanceAnalysisKit';
import { UIAbility, Want, AbilityConstant } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
// Check function
function checkWant(want: Want): boolean {
try {
if (want.parameters && want.parameters['test']) {
let testParam = want.parameters['test'] as Record<string, Object>;
if (testParam && typeof testParam === 'object') {
let uri = testParam['uri'] as string;
if (uri) {
hilog.info(0x0000, 'privacy', 'get uri string: ' + uri);
} else {
hilog.error(0x0000, 'privacy', 'uri parameter is missing');
return false;
}
} else {
hilog.error(0x0000, 'privacy', 'test parameter is not an object');
return false;
}
} else {
hilog.error(0x0000, 'privacy', 'parameters or test key is missing');
return false;
}
} catch (err) {
let error = err as BusinessError;
hilog.error(0x0000, 'privacy', `checkWant failed: code is ${err.code}, message is ${err.message}`);
return false;
}
return true;
}
export default class EntryAbility extends UIAbility {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
if (checkWant(want)) {
hilog.info(0x0000, 'privacy', 'correct want');
} else {
hilog.info(0x0000, 'privacy', 'invalid want');
}
}
} 应用获取外部不可信Want的方式有很多种,例如:
在不同场景下,获取Want的方式如下:
// Application life cycle:
// @ohos.application.AbilityStage.d.ts
onAcceptWant(want: Want): string;
// ability life cycle:
// @ohos.application.Ability.d.ts
onCreate(want: Want, param: AbilityConstant.LaunchParam): void;
onContinue(wantParam: {}): AbilityConstant.OnContinueResult;
onNewWant(want: Want, launchParams: AbilityConstant.LaunchParam): void;
// ServiceExtensionAbility life cycle:
// @ohos.application.ServiceExtensionAbility.d.ts
onCreate(want: Want): void;
onRequest(want: Want, startId: number): void;
onConnect(want: Want): rpc.RemoteObject;
onDisconnect(want: Want): void;
onReconnect(want: Want): void; SQL注入是指对用户输入数据的合法性没有判断或过滤不严。攻击者可以传入特定内容,将应用事先定义好的语句变成含义完全不同的SQL语句,导致信息泄露或数据篡改。
任何外部的输入,包括用户的输入,都是不安全的,需要对外部输入的数据进行过滤处理。
HarmonyOS系统提供的关系型数据库基于SQLite组件,可以直接运行用户输入的SQL语句。如果不可信的数据用于拼接SQL语句,就存在SQL注入的风险。应使用参数化查询的方式或对不可信内容进行过滤。
HarmonyOS上querySql和executeSql会被用于拼接SQL语句的执行。
示例中的context的获取方式请参见获取UIAbility的上下文信息。
import { BusinessError } from '@kit.BasicServicesKit';
import { relationalStore } from '@kit.ArkData'
import { hilog } from '@kit.PerformanceAnalysisKit';
// ...
// The sql parameters are from external input
function exesql(sql: string) {
const STORE_CONFIG: relationalStore.StoreConfig = {
name: 'RdbTest.db',
securityLevel: relationalStore.SecurityLevel.S1
};
let store: relationalStore.RdbStore | undefined = undefined;
relationalStore.getRdbStore(context, STORE_CONFIG, (err: BusinessError, rdbStore: relationalStore.RdbStore) => {
store = rdbStore;
if (err) {
hilog.error(0x0000, 'privacy', `Get RdbStore failed, code is ${err.code},message is ${err.message}`);
return;
}
hilog.info(0x0000, 'privacy', 'Get RdbStore successfully.');
})
// The external input is used to directly concatenate the SQL statement, and the verification is not performed
let SQL_DELETE_TABLE = 'DELETE FROM test WHERE name = ' + sql;
if (store != undefined) {
(store as relationalStore.RdbStore).executeSql(SQL_DELETE_TABLE, (err) => {
if (err) {
hilog.error(0x0000, 'privacy', `ExecuteSql failed, code is ${err.code},message is ${err.message}`);
return;
}
hilog.info(0x0000, 'privacy', 'Delete table done.');
})
}
} 如果直接使用用户输入作为查询参数,恶意用户可以输入类似“1' OR 'a' = 'a”的字符串,导致 SQL 语句变为select * from book where name='1' OR 'a' = 'a',从而引发 SQL 注入攻击。因此,禁止直接使用外部输入作为查询字符串的一部分,或者在拼接 SQL 语句之前,对外部输入进行字符校验。
剪贴板是指操作系统提供的一个暂存数据并提供共享的模块,也称为数据中转站。剪贴板在后台起作用,存放在内存里。
如果将个人数据放入剪贴板中是不安全的,因为任意程序都可以访问剪贴板中的内容。
将内容存放入剪贴板的方法有SystemPasteboard类中的setPasteData()方法。
例外:如果是用户自己主动以剪切板作为中转,拷贝数据,则不受此规则约束。
HarmonyOS系统对文件存储进行了沙箱隔离。内部存储的文件仅应用程序有权限读取,且仅限于本应用的内部存储目录。若需读取外部共享存储,则必须添加读取权限。
在对文件进行读、写、下载、删除等操作时,如果使用外部输入拼接文件路径,攻击者可能注入恶意字符(如../)进行跨目录攻击,导致数据泄露或应用拒绝服务等安全问题。因此,拼接路径前需校验外部输入,确保其不包含恶意字符。
// The fileName is from external
function readFile(fileName: string) {
let filePath = '/data/storage/';
if (fileName.indexOf('..') === -1) { // Anti-splicing verification
let fileAllPath: string = filePath + fileName;
// Service processing
} else {
hilog.info(0x0000, 'privacy', 'be attacked');
return;
}
} “debug”属性是为了方便开发人员对应用进行调试,但对于正式发布版本,如果应用设置为可调试模式,方便了攻击者对应用进行更深入的分析调试,不利于对应用的保护,因此要求正式版本须设置为不可调试模式。
对“debug”的设置需要在app.json5文件中进行配置。其中“debug”属性缺省值为false。
错误示例:
// app.json5
{
"app": {
"bundleName": "com.application.music",
"vendor": "application",
"versionCode": 1,
"versionName": "1.0",
"minCompatibleVersionCode": 1,
"minAPIVersion": 7,
"targetAPIVersion": 8,
"apiReleaseType": "Release",
"debug": false,
"icon": "$media:app_icon",
"label": "$string:app_name",
"description": "$string:description_application",
"distributedNotificationEnabled": true,
"entityType": "game",
"car": {
"apiCompatibleVersion": 8
}
}
} 正确示例:
// app.json5
{
"app": {
"bundleName": "com.application.music",
"vendor": "application",
"versionCode": 1,
"versionName": "1.0",
"minCompatibleVersionCode": 1,
"minAPIVersion": 7,
"targetAPIVersion": 8,
"apiReleaseType": "Release",
"debug": true, // debug字段设置
"icon": "$media:app_icon",
"label": "$string:app_name",
"description": "$string:description_application",
"distributedNotificationEnabled": true,
"entityType": "game",
"car": {
"apiCompatibleVersion": 8
}
}
} 鸿蒙应用软件包(HAP、HAR、HSP)可以被反编译。配置代码混淆,增加攻击者分析代码的难度。
正确示例,开启属性混淆例子:
# Define project specific obfuscation rules here. # You can include the obfuscation configuration files in the current module's build-profile.json5. # # For more details, see # https://gitee.com/openharmony/arkcompiler_ets_frontend/blob/master/arkguard/README.md # Obfuscation options: # -disable-obfuscation: disable all obfuscations # 开启对象属性混淆 -enable-property-obfuscation: obfuscate the property names # -enable-toplevel-obfuscation: obfuscate the names in the global scope # -compact: remove unnecessary blank spaces and all line feeds # -remove-log: remove all console.* statements # -print-namecache: print the name cache that contains the mapping from the old names to new names # -apply-namecache: reuse the given cache file # Keep options: # -keep-property-name: specifies property names that you want to keep # -keep-global-name: specifies names that you want to keep in the global scope
在应用源码工程obfuscation-rules.txt文件中,按照应用业务的需求配置和开启混淆规则。
应用通常依赖外部第三方库和系统SDK来完成特定任务。及时更新这些依赖项,可增强应用的安全性。
在发布应用前,请确保所有库、SDK 和其他依赖项均为最新版本。
在HarmonyOS应用打包时,可以选择debug和release两种模式。debug模式的应用便于开发者进行调试。然而,在正式发布版本中,若应用设置为可调试模式,将增加攻击者分析调试应用的风险,不利于应用的安全保护。因此,正式发布的应用必须使用release模式并禁止使用debug签名。
注意:DevEco Studio默认编译的hap应用为debug模式,不可直接用于商用版本。
应用签名必须申请签名证书。申请证书时需要输入开发者信息和公司信息。该证书是应用的身份标识和认证凭据。签名时,证书会嵌入到应用包,成为应用包数据结构的一部分。开发者可以通过公开的API或读取应用包数据结构获取应用证书信息。
如果在证书信息中填写了姓名、工号等个人信息,将导致信息泄露,并可能引发质疑。证书信息应填写公司或团队名称,而不是个人信息。
预置应用软件必须包含真实有效的签名信息。对于非开源鸿蒙官方应用,不得使用开源鸿蒙公开证书,也不得使用与产品无关的签名信息,例如Demo等。应用开发者、公司和部门信息必须真实有效,不得为网址、乱码等无效信息。签名证书应正确标识开发者身份,包括企业名称、组织、省市和国家等信息,不得包含与主体无关的信息。
错误示例:
10-11 17:51:53 WARN - Missing parameter: outproof 10-11 17:51:53 INFO - Find Hap Signing Block success, version: 3, block count: 2 10-11 17:51:54 INFO - +++++++++++++++++++++++++++certificate #0 +++++++++++++++++++++++++++++++ 10-11 17:51:54 INFO - Subject: C=CN, O=Organization, OU=Unit, CN=ide_demo_app // CN字段无法标识开发组织 10-11 17:51:54 INFO - Issuer: CN=OpenHarmony Application CA, OU=OpenHarmony Team, O=OpenHarmony, C=CN
正确示例:
10-11 17:51:54 INFO - Issuer: CN=OpenHarmony Application CA, OU=OpenHarmony Team, O=OpenHarmony, C=CN 10-11 17:52:21 WARN - Missing parameter: outproof 10-11 17:52:21 INFO - Find Hap Signing Block success, version: 3, block count: 2 10-11 17:52:21 INFO - +++++++++++++++++++++++++++certificate #0 +++++++++++++++++++++++++++++++ 10-11 17:52:21 INFO - Subject: CN=应用名称, OU=开发者组织/公司/部门, O=开发者组织/公司/部门, C=CN // CN字段标识开发组织