訪問控制管理

說明： 本模塊首批接口從API version 8開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。 開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導入模塊

import abilityAccessCtrl from '@ohos.abilityAccessCtrl'

abilityAccessCtrl.createAtManager

createAtManager(): AtManager

訪問控制管理：獲取訪問控制模塊對象。

系統能力： SystemCapability.Security.AccessToken

返回值：

示例：

var AtManager = abilityAccessCtrl.createAtManager();

AtManager

管理訪問控制模塊的實例。

verifyAccessToken

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

校驗應用是否授予權限，使用Promise方式異步返回結果。

系統能力： SystemCapability.Security.AccessToken

參數：

返回值：

示例：

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

授予應用user grant權限，使用Promise方式異步返回結果。

需要權限： ohos.permission.GRANT_SENSITIVE_PERMISSIONS

系統能力： SystemCapability.Security.AccessToken

參數：

返回值：

示例：

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

授予應用user grant權限，使用callback回調異步返回結果。

需要權限： ohos.permission.GRANT_SENSITIVE_PERMISSIONS

系統能力： SystemCapability.Security.AccessToken

參數：

示例：

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

撤銷應用user grant權限，使用Promise方式異步返回結果。

需要權限： ohos.permission.REVOKE_SENSITIVE_PERMISSIONS

系統能力： SystemCapability.Security.AccessToken

參數：

返回值：

示例：

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

撤銷應用user grant權限，使用callback回調異步返回結果。

需要權限： ohos.permission.REVOKE_SENSITIVE_PERMISSIONS

系統能力： SystemCapability.Security.AccessToken

參數：

示例：

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

獲取指定應用的指定權限的flag，使用Promise方式異步返回結果。

需要權限： ohos.permission.GET_SENSITIVE_PERMISSIONS or GRANT_SENSITIVE_PERMISSIONS or REVOKE_SENSITIVE_PERMISSIONS

系統能力： SystemCapability.Security.AccessToken

參數：

返回值：

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

示例：

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

表示授權狀態的枚舉。

系統能力： 以下各項對應的系統能力均為SystemCapability.Security.AccessToken

審核編輯 黃宇