訪問(wèn)控制管理

說(shuō)明： 本模塊首批接口從API version 8開(kāi)始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。 開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導(dǎo)入模塊

import abilityAccessCtrl from '@ohos.abilityAccessCtrl'

abilityAccessCtrl.createAtManager

createAtManager(): AtManager

訪問(wèn)控制管理：獲取訪問(wèn)控制模塊對(duì)象。

系統(tǒng)能力： SystemCapability.Security.AccessToken

返回值：

示例：

var AtManager = abilityAccessCtrl.createAtManager();

AtManager

管理訪問(wèn)控制模塊的實(shí)例。

verifyAccessToken

verifyAccessToken(tokenID: number, permissionName: string): Promise

校驗(yàn)應(yīng)用是否授予權(quán)限，使用Promise方式異步返回結(jié)果。

系統(tǒng)能力： SystemCapability.Security.AccessToken

參數(shù)：

返回值：

示例：

var AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let promise = AtManager.verifyAccessToken(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS");
promise.then(data = > {
    console.log(`promise: data- >${JSON.stringify(data)}`);
});

grantUserGrantedPermission

grantUserGrantedPermission(tokenID: number, permissionName: string, permissionFlag: number): Promise

授予應(yīng)用user grant權(quán)限，使用Promise方式異步返回結(jié)果。

需要權(quán)限： ohos.permission.GRANT_SENSITIVE_PERMISSIONS

系統(tǒng)能力： SystemCapability.Security.AccessToken

參數(shù)：

返回值：

示例：

var AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let permissionFlag = 1;
let promise = AtManager.grantUserGrantedPermission(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS",permissionFlag);
promise.then(data = > {
    console.log(`promise: data- >${JSON.stringify(data)}`);
});

grantUserGrantedPermission

grantUserGrantedPermission(tokenID: number, permissionName: string, permissionFlag: number, callback: AsyncCallback): void

授予應(yīng)用user grant權(quán)限，使用callback回調(diào)異步返回結(jié)果。

需要權(quán)限： ohos.permission.GRANT_SENSITIVE_PERMISSIONS

系統(tǒng)能力： SystemCapability.Security.AccessToken

參數(shù)：

示例：

var AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let permissionFlag = 1;
AtManager.grantUserGrantedPermission(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS",permissionFlag, data = > {
    console.log(`callback: data- >${JSON.stringify(data)}`);
});

revokeUserGrantedPermission

revokeUserGrantedPermission(tokenID: number, permissionName: string, permissionFlag: number): Promise

撤銷應(yīng)用user grant權(quán)限，使用Promise方式異步返回結(jié)果。

需要權(quán)限： ohos.permission.REVOKE_SENSITIVE_PERMISSIONS

系統(tǒng)能力： SystemCapability.Security.AccessToken

參數(shù)：

返回值：

示例：

var AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let permissionFlag = 1;
let promise = AtManager.revokeUserGrantedPermission(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS", permissionFlag);
promise.then(data = > {
    console.log(`promise: data- >${JSON.stringify(data)}`);
});

revokeUserGrantedPermission

revokeUserGrantedPermission(tokenID: number, permissionName: string, permissionFlag: number, callback: AsyncCallback): void

撤銷應(yīng)用user grant權(quán)限，使用callback回調(diào)異步返回結(jié)果。

需要權(quán)限： ohos.permission.REVOKE_SENSITIVE_PERMISSIONS

系統(tǒng)能力： SystemCapability.Security.AccessToken

參數(shù)：

示例：

var AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let permissionFlag = 1;
AtManager.revokeUserGrantedPermission(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS",permissionFlag, data = > {
    console.log(`callback: data- >${JSON.stringify(data)}`);
});

getPermissionFlags

getPermissionFlags(tokenID: number, permissionName: string): Promise

獲取指定應(yīng)用的指定權(quán)限的flag，使用Promise方式異步返回結(jié)果。

需要權(quán)限： ohos.permission.GET_SENSITIVE_PERMISSIONS or GRANT_SENSITIVE_PERMISSIONS or REVOKE_SENSITIVE_PERMISSIONS

系統(tǒng)能力： SystemCapability.Security.AccessToken

參數(shù)：

返回值：

類型	說(shuō)明HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿
Promise	Promise實(shí)例，用于獲取異步返回的查詢結(jié)果。

示例：

var AtManager = abilityAccessCtrl.createAtManager();
let tokenID = 0;
let promise = AtManager.getPermissionFlags(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS");
promise.then(data = > {
    console.log(`promise: data- >${JSON.stringify(data)}`);
});

GrantStatus

表示授權(quán)狀態(tài)的枚舉。

系統(tǒng)能力： 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Security.AccessToken

審核編輯 黃宇