程序訪問控制管理

導(dǎo)入模塊

import abilityAccessCtrl from '@ohos.abilityAccessCtrl'

abilityAccessCtrl.createAtManager

createAtManager(): AtManager

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

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

返回值：

示例：

let atManager = abilityAccessCtrl.createAtManager();

AtManager

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

checkAccessToken9+

checkAccessToken(tokenID: number, permissionName: Permissions): Promise<GrantStatus>

校驗(yàn)應(yīng)用是否授予權(quán)限。使用Promise異步回調(diào)。

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

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見程序訪問控制錯誤碼。

示例：

import abilityAccessCtrl from '@ohos.abilityAccessCtrl';

let atManager = abilityAccessCtrl.createAtManager();
let tokenID = 0; // 系統(tǒng)應(yīng)用可以通過bundleManager.getApplicationInfo獲取,普通應(yīng)用可以通過bundleManager.getBundleInfoForSelf獲取
try {
    atManager.checkAccessToken(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS").then((data) => {
        console.log(`checkAccessToken success, data->${JSON.stringify(data)}`);
    }).catch((err) => {
        console.log(`checkAccessToken fail, err->${JSON.stringify(err)}`);
    });
} catch(err) {
    console.log(`catch err->${JSON.stringify(err)}`);
}

verifyAccessTokenSync9+

verifyAccessTokenSync(tokenID: number, permissionName: Permissions): GrantStatus

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

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

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見程序訪問控制錯誤碼。

示例：

let atManager = abilityAccessCtrl.createAtManager();
let tokenID = 0; // 系統(tǒng)應(yīng)用可以通過bundleManager.getApplicationInfo獲取,普通應(yīng)用可以通過bundleManager.getBundleInfoForSelf獲取
let data = atManager.verifyAccessTokenSync(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS");
console.log(`data->${JSON.stringify(data)}`);

verifyAccessToken9+

verifyAccessToken(tokenID: number, permissionName: Permissions): Promise<GrantStatus>

校驗(yàn)應(yīng)用是否授予權(quán)限。使用Promise異步回調(diào)。

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

參數(shù)：

返回值：

示例：

import abilityAccessCtrl from '@ohos.abilityAccessCtrl';

let atManager = abilityAccessCtrl.createAtManager();
let tokenID = 0; // 系統(tǒng)應(yīng)用可以通過bundleManager.getApplicationInfo獲取,普通應(yīng)用可以通過bundleManager.getBundleInfoForSelf獲取
let promise = atManager.verifyAccessToken(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS");
promise.then(data => {
    console.log(`promise: data->${JSON.stringify(data)}`);
});

requestPermissionsFromUser9+

requestPermissionsFromUser(context: Context, permissionList: Array<Permissions>, requestCallback: AsyncCallback<PermissionRequestResult>) : void;

用于UIAbility拉起彈框請求用戶授權(quán)。使用callback異步回調(diào)。

模型約束：此接口僅可在Stage模型下使用。

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

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見程序訪問控制錯誤碼。

示例：

import abilityAccessCtrl from '@ohos.abilityAccessCtrl';
let atManager = abilityAccessCtrl.createAtManager();
try {
  atManager.requestPermissionsFromUser(this.context, ["ohos.permission.CAMERA"], (err, data)=>{
      console.info("data:" + JSON.stringify(data));
      console.info("data permissions:" + data.permissions);
      console.info("data authResults:" + data.authResults);
  });
} catch(err) {
  console.log(`catch err->${JSON.stringify(err)}`);
}

requestPermissionsFromUser9+

requestPermissionsFromUser(context: Context, permissionList: Array<Permissions>) : Promise<PermissionRequestResult>;

用于UIAbility拉起彈框請求用戶授權(quán)。使用promise異步回調(diào)。

模型約束：此接口僅可在Stage模型下使用。

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

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見程序訪問控制錯誤碼。

示例：

import abilityAccessCtrl from '@ohos.abilityAccessCtrl';
let atManager = abilityAccessCtrl.createAtManager();
try {
  atManager.requestPermissionsFromUser(this.context, ["ohos.permission.CAMERA"]).then((data) => {
      console.info("data:" + JSON.stringify(data));
      console.info("data permissions:" + data.permissions);
      console.info("data authResults:" + data.authResults);
  }).catch((err) => {
      console.info("data:" + JSON.stringify(err));
  })
} catch(err) {
  console.log(`catch err->${JSON.stringify(err)}`);
}

verifyAccessToken(deprecated)

verifyAccessToken(tokenID: number, permissionName: string): Promise<GrantStatus>

校驗(yàn)應(yīng)用是否授予權(quán)限。使用Promise異步回調(diào)。

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

參數(shù)：

返回值：

示例：

import abilityAccessCtrl from '@ohos.abilityAccessCtrl';

let atManager = abilityAccessCtrl.createAtManager();
let tokenID = 0; // 系統(tǒng)應(yīng)用可以通過bundleManager.getApplicationInfo獲取,普通應(yīng)用可以通過bundleManager.getBundleInfoForSelf獲取
let promise = atManager.verifyAccessToken(tokenID, "ohos.permission.GRANT_SENSITIVE_PERMISSIONS");
promise.then(data => {
    console.log(`promise: data->${JSON.stringify(data)}`);
});

GrantStatus

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

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