harmony 鸿蒙Verifying API Access Permissions

2022-11-09
浏览 (712)

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:

Obtain the caller’s identity (tokenId). > NOTE > > You can use getCallingTokenId to obtain the caller’s tokenId. For details, see RPC.
Determine the permission to verify, which is ohos.permission.ACCELEROMETER in this example.
Call checkAccessToken() to perform a permission verification for the caller.
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;
      }
  }