鸿蒙API14开发【@ohos.enterprise.securityManager（安全管理）】短距通信服务_securitypolicy securitypolicy = devicepolicymanage
本模块提供设备安全管理的能力，包括查询安全补丁状态、查询文件加密状态等。
说明
本模块首批接口从API version 12开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
本模块接口仅可在Stage模型下使用。
本模块接口仅对[设备管理应用]开放，需将设备管理应用激活后调用，实现相应功能。
导入模块
import { securityManager } from \'@kit.MDMKit\';securityManager.uninstallUserCertificate
uninstallUserCertificate(admin: Want, certUri: string): Promise
卸载用户证书，使用Promise异步回调。
需要权限： ohos.permission.ENTERPRISE_MANAGE_CERTIFICATE
系统能力： SystemCapability.Customization.EnterpriseDeviceManager
参数：
返回值：
示例：
import { Want } from \'@kit.AbilityKit\';import { BusinessError } from \'@kit.BasicServicesKit\';let wantTemp: Want = { bundleName: \'com.example.myapplication\', abilityName: \'EntryAbility\',};let aliasStr = \"certName\"securityManager.uninstallUserCertificate(wantTemp, aliasStr).then(() => { console.info(`Succeeded in uninstalling user certificate.`);}).catch((err: BusinessError) => { console.error(`Failed to uninstall user certificate. Code is ${err.code}, message is ${err.message}`);});securityManager.installUserCertificate
installUserCertificate(admin: Want, certificate: CertBlob): Promise
安装用户证书，使用Promise异步回调。
需要权限： ohos.permission.ENTERPRISE_MANAGE_CERTIFICATE
系统能力： SystemCapability.Customization.EnterpriseDeviceManager
参数：
返回值：
示例：
import { Want } from \'@kit.AbilityKit\';import { BusinessError } from \'@kit.BasicServicesKit\';let wantTemp: Want = { bundleName: \'com.example.myapplication\', abilityName: \'EntryAbility\',};let certFileArray: Uint8Array = new Uint8Array();// The variable context needs to be initialized in MainAbility\'s onCreate callback function// test.cer needs to be placed in the rawfile directorygetContext().resourceManager.getRawFileContent(\"test.cer\").then((value) => { certFileArray = value securityManager.installUserCertificate(wantTemp, { inData: certFileArray, alias: \"cert_alias_xts\" }) .then((result) => { console.info(`Succeeded in installing user certificate, result : ${JSON.stringify(result)}`); }).catch((err: BusinessError) => { console.error(`Failed to install user certificate. Code: ${err.code}, message: ${err.message}`); })}).catch((err: BusinessError) => { console.error(`Failed to get row file content. message: ${err.message}`); return});securityManager.getSecurityStatus
getSecurityStatus(admin: Want, item: string): string
获取安全策略信息。
需要权限： ohos.permission.ENTERPRISE_MANAGE_SECURITY
系统能力： SystemCapability.Customization.EnterpriseDeviceManager
参数：
返回值：
示例：
import { Want } from \'@kit.AbilityKit\';let wantTemp: Want = { bundleName: \'com.example.myapplication\', abilityName: \'EntryAbility\',};try { let result: string = securityManager.getSecurityStatus(wantTemp, \'patch\'); console.info(`Succeeded in getting security patch tag. tag: ${result}`);} catch (err) { console.error(`Failed to get security patch tag. Code: ${err.code}, message: ${err.message}`);}securityManager.setPasswordPolicy
setPasswordPolicy(admin: Want, policy: PasswordPolicy): void
设置设备口令策略。
需要权限： ohos.permission.ENTERPRISE_MANAGE_SECURITY
系统能力： SystemCapability.Customization.EnterpriseDeviceManager
参数：
示例：
import { Want } from \'@kit.AbilityKit\';let wantTemp: Want = { bundleName: \'com.example.myapplication\', abilityName: \'EntryAbility\',};let policy: securityManager.PasswordPolicy = { complexityRegex: \'^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)[a-zA-Z\\d]{8,}$\', validityPeriod: 1, additionalDescription: \'至少八个字符，至少一个大写字母，一个小写字母，一个数字和一个特殊字符\',}try { securityManager.setPasswordPolicy(wantTemp, policy); console.info(`Succeeded in setting password policy.`);} catch(err) { console.error(`Failed to set password policy. Code: ${err.code}, message: ${err.message}`);}securityManager.getPasswordPolicy
getPasswordPolicy(admin: Want): PasswordPolicy
获取设备口令策略。
需要权限： ohos.permission.ENTERPRISE_MANAGE_SECURITY
系统能力： SystemCapability.Customization.EnterpriseDeviceManager
参数：
返回值：
示例：
import { Want } from \'@kit.AbilityKit\';let wantTemp: Want = { bundleName: \'com.example.myapplication\', abilityName: \'EntryAbility\',};try { let result: securityManager.PasswordPolicy = securityManager.getPasswordPolicy(wantTemp); console.info(`Succeeded in getting password policy, result : ${JSON.stringify(result)}`);} catch(err) { console.error(`Failed to get password policy. Code: ${err.code}, message: ${err.message}`);}securityManager.setAppClipboardPolicy
setAppClipboardPolicy(admin: Want, tokenId: number, policy: ClipboardPolicy): void
设置设备剪贴板策略。
需要权限： ohos.permission.ENTERPRISE_MANAGE_SECURITY
系统能力： SystemCapability.Customization.EnterpriseDeviceManager
参数：
示例：
import { Want } from \'@kit.AbilityKit\';let wantTemp: Want = { bundleName: \'com.example.myapplication\', abilityName: \'EntryAbility\',};let tokenId: number = 586874394;try { securityManager.setAppClipboardPolicy(wantTemp, tokenId, securityManager.ClipboardPolicy.IN_APP); console.info(`Succeeded in setting clipboard policy.`);} catch(err) { console.error(`Failed to set clipboard policy. Code: ${err.code}, message: ${err.message}`);}securityManager.getAppClipboardPolicy
getAppClipboardPolicy(admin: Want, tokenId?: number): string
获取设备剪贴板策略。
需要权限： ohos.permission.ENTERPRISE_MANAGE_SECURITY
系统能力： SystemCapability.Customization.EnterpriseDeviceManager
参数：
返回值：
示例：
import { Want } from \'@kit.AbilityKit\';let wantTemp: Want = { bundleName: \'com.example.myapplication\', abilityName: \'EntryAbility\',};let tokenId: number = 586874394;try { let result: string = securityManager.getAppClipboardPolicy(wantTemp, tokenId); console.info(`Succeeded in getting password policy, result : ${result}`);} catch(err) { console.error(`Failed to set clipboard policy. Code: ${err.code}, message: ${err.message}`);}securityManager.setWatermarkImage14+
setWatermarkImage(admin: Want, bundleName: string, source: string | image.PixelMap, accountId: number): void
设置水印策略，当前仅支持2in1设备使用。
需要权限： ohos.permission.ENTERPRISE_MANAGE_SECURITY
系统能力： SystemCapability.Customization.EnterpriseDeviceManager
参数：
示例：
import { Want } from \'@kit.AbilityKit\';let wantTemp: Want = { bundleName: \'com.example.myapplication\', abilityName: \'EntryAbility\',};let bundleName: string = \'com.example.myapplication\';let source: string = \'/data/storage/el1/base/test.png\';let accountId: number = 100;try { securityManager.setWatermarkImage(wantTemp, bundleName, source, accountId); console.info(`Succeeded in setting set watermarkImage policy.`);} catch(err) { console.error(`Failed to set watermarkImage policy. Code: ${err.code}, message: ${err.message}`);}securityManager.cancelWatermarkImage14+
cancelWatermarkImage(admin: Want, bundleName: string, accountId: number): void
取消水印策略，当前仅支持2in1设备使用。
需要权限： ohos.permission.ENTERPRISE_MANAGE_SECURITY
系统能力： SystemCapability.Customization.EnterpriseDeviceManager
参数：
示例：
import { Want } from \'@kit.AbilityKit\';let wantTemp: Want = { bundleName: \'com.example.myapplication\', abilityName: \'EntryAbility\',};let bundleName: string = \'com.example.myapplication\';let accountId: number = 100;try { securityManager.cancelWatermarkImage(wantTemp, bundleName, accountId); console.info(`Succeeded in setting cancel watermarkImage policy.`);} catch(err) { console.error(`Failed to cancel watermarkImage policy. Code: ${err.code}, message: ${err.message}`);}CertBlob
证书信息。
系统能力： SystemCapability.Customization.EnterpriseDeviceManager
PasswordPolicy
设备口令策略。
系统能力： SystemCapability.Customization.EnterpriseDeviceManager
ClipboardPolicy
设备剪贴板策略。
系统能力： SystemCapability.Customization.EnterpriseDeviceManager
