Users

Introduction

The koi-api manages all users interacting with the KOI-System. Every user is allowed or forbidden to perform specific tasks when interacting with the service. Such tasks could be the inspection of objects, uploading new models, setting up new instances, or fulfilling label requests.

To grant users privileges, the system uses roles associating users with objects. Every user can have an arbitrary number of roles related to each object. There are three distinct types of roles to manage the complexity and follow the paradigm of the three objects used in the system design.

• General Role
• Model Role
• Instance Role

The general role defines what the user can do on a global scale. This includes the creation of new user accounts and roles and the definition of new models. The roles for models and instances define what the user can do with each type of object.

Default Users and Roles

The system defines some default roles and users, which we believe would benefit many use cases. The base configuration from ./config/base.py defines the default roles and users. The user can edit these defaults before or after the installation. However, the configuration can not delete a present user.