harmony 鸿蒙Verifying API Access Permissions

  • 2022-11-09
  • 浏览 (691)

Verifying API Access Permissions

When to Use

To protect sensitive data and eliminate security threats on core abilities, you can use the permissions in the Application Permission List to protect the related API from unauthorized calling. Each time before the API is called, a permission verification is performed to check whether the caller has the required permission.

Available APIs

The following describes only the API used for permission verification. For more information about the APIs, see Application Access Control.

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

Name Type Mandatory Description
tokenID number Yes Token ID of the application. You can obtain the value from the ApplicationInfo of the application.
permissionName Permissions Yes Name of the permission to verify. Valid permission names are defined in the Application Permission List.

Example

The procedure is as follows:

  1. Obtain the caller’s identity (tokenId). > NOTE > > You can use getCallingTokenId to obtain the caller’s tokenId. For details, see RPC.
  2. Determine the permission to verify, which is ohos.permission.ACCELEROMETER in this example.
  3. Call checkAccessToken() to perform a permission verification for the caller.
  4. Proceed based on the permission verification result.
  import abilityAccessCtrl from '@ohos.abilityAccessCtrl'
  import { BusinessError } from '@ohos.base';
  import rpc from '@ohos.rpc'

  class Stub extends rpc.RemoteObject {
      onRemoteMessageRequest(code: number, data: rpc.MessageSequence, reply: rpc.MessageSequence, option: rpc.MessageOption) {
          let callerTokenId: number = rpc.IPCSkeleton.getCallingTokenId();
          console.log("RpcServer: getCallingTokenId result: " + callerTokenId);
          let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
          try {
              atManager.checkAccessToken(callerTokenId, "ohos.permission.ACCELEROMETER").then((data: abilityAccessCtrl.GrantStatus) => {
                  console.log(`checkAccessToken success, data->${JSON.stringify(data)}`);
              }).catch((err: BusinessError) => {
                  console.log(`checkAccessToken fail, err->${JSON.stringify(err)}`);
              });
          } catch(err) {
              console.log(`catch err->${JSON.stringify(err)}`);
          }
          return true;
      }
  }

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Security

harmony 鸿蒙Applying for Permissions

harmony 鸿蒙Access Control (Permission) Overview

harmony 鸿蒙HarmonyAppProvision Configuration File

harmony 鸿蒙Certificate Development

harmony 鸿蒙Certificate Overview

harmony 鸿蒙Crypto Framework Development

harmony 鸿蒙Crypto Framework Overview

harmony 鸿蒙DLP Development

harmony 鸿蒙DLP Overview

0  赞