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:
| Value | Source of Authority to Operate |
|---|---|
| WIKKIT_GATE | HaaS Manager |
| DATA_ADAPTER | Get 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 Value | Description | Get User API Version |
|---|---|---|
POWER_OF_ATTORNEY | Enduring Power of Attorney | V0 |
AUTHORITY_TO_ACT | Authority to Act | V1 |
STATE_TRUSTEE | State Trustee | V1 |
COURT_APPOINTED | Court Appointed Authority | V1 |
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.