Skip to main content

Authority to Operate

The Authority to Operate capability of the HaaS environment allows for the Holder to designate users who are able to effectively impersonate, for a variety of reasons, other users.

Within the HaaS environment this is presented as a Principal/Profile Selector allowing a user to effectively become the Consumer they have authority over. Note that data sharing under an ATO is only permitted if there is a direct relationship defined between the user and the individual that they have an authority over thus that user cannot "inherit" the ATO relationship of another individual. This is also applied when an individual is a nominated representative for a business, thus the user will not have access to the non-individual entity of the individual under an ATO unless that user is also made a nominated representative of that non-individual entity.

The HaaS environment ATO will allow the user to vote in Disclosure Option Management Service requests on behalf of the other user.

Authority to Operate is differentiated from a Secondary User Instruction on the basis of legal authority to operate on behalf of an individual person versus access to account information. A simplistic example is that a Power of Attorney has authority to make decisions on behalf of ("impersonate") a person ("Authority to Operate") whereas an Accountant has the power to execute actions on an account ("Secondary User")

An Authority To Operate Instruction exists until it is no longer returned from the Adapter. When a token is refreshed, HaaS will refresh and clean up its Authority To Operate knowledge by calling the Data Adapter's Get User endpoint to retrieve fresh data.

Configuration​

The Authority to Operate behaviour is determined based on authoritative_source_ato configuration setting:

ValueSource of Authority to Operate
WIKKIT_GATEHaaS Manager
DATA_ADAPTERGet User API authorityToOperate structure

HaaS Manager​

Administering Authority to Operate from HaaS Manager allows the viewing, adding and removing ATO structures directly.

Refer to View Authority to Operate, Add an Authority to Operate and Remove an Authority to Operate within the HaaS Manager guide.

Adapter​

The Get User endpoint is used to communicate the Authority to Operate settings of a certain user in a certain principal context.

A summary of the supported ATO types are as follows:

Enum ValueDescriptionGet User API Version
POWER_OF_ATTORNEYEnduring Power of AttorneyV0
AUTHORITY_TO_ACTAuthority to ActV1
STATE_TRUSTEEState TrusteeV1
COURT_APPOINTEDCourt Appointed AuthorityV1
info

From Get User V1, it is possible to hide a user who is exclusively an ATO on another account by setting isVisible to false

Further detail can be found within the Get User API endpoint and guidance.