Users, keys and who can do what
Every change is made by someone. Who that is comes from the API key a connection sends, or from the instance's choice of who a connection without a key is.
Users
A user is an item in the plan like a task: it has an ID, a version and a history of what was done to it. The tasks it is given are not in that history: they are in the tasks'. It has a username and one of three types.
| Type | Is | May call |
|---|---|---|
admin | Whoever maintains the instance. Creates users, resets keys, deletes for good, reads the service's status. | 21 of 21 operations |
person | A human that work can be assigned to. | 19 of 21 operations |
agent | An AI agent. | 19 of 21 operations |
Every instance starts with three users:
| User | Type | For |
|---|---|---|
admin | admin | Maintenance. It always needs its API key, which config init writes into the config file. |
user | person | A person that agents can assign work to. It has no key until one is issued. |
agent1 | agent | Who a connection without an API key acts as, unless the config says otherwise. |
More agents mean more users: give each agent its own, so that their work can be told apart in the history and each can be assigned its own tasks.
Keys
A key is a long random text that starts with vig_, sent with every request as Authorization: Bearer vig_....
- The service makes a key when a user is created or its key is reset, and shows it once.
- Keys are kept in the instance's config file, which only your account can read, and apply at once.
- A key counts only for the user it was made for, and
adminalways needs its key.
Without a key
By default, a connection without a key acts as agent1, and can read and change the plan. That is the setting auth.keyless_user. It makes the first minutes easy and is fine while the service listens on 127.0.0.1 only.
Set it to nothing and every connection needs a key:
vigile config set auth.keyless_user ""
Do that before the service can be reached from another machine. serve and the doctor both warn while it is open on a network address. See Security.
What a user may do
Everyone in an instance sees the whole plan, and every user may call the operations that read and change projects, tasks and links. What depends on the type:
- Creating users and resetting keys are operations for admins. They are not even listed for anyone else: an agent's list of tools does not have them.
- Deleting for good, and deleting or restoring a user, are for admins, within operations everyone may call.
- The status of the service is for admins.
There is no access by team or by item: whoever is let in may read and change everything but users and keys.
The command line and the page
The command line acts as admin unless a command is given --as <username>; it takes the key from the config file. The page mostly reads the plan; a task panel's priority −/+ controls call update_task as the browser's current user. When a key is required the page asks for one and keeps it in that browser.
Reference
create_user,reset_user_key,list_users.vigile useron the command line.- Security: keys, the browser guards, and what to expose.
- The command above is typed in a terminal set up as Install and first run leaves it.