Create a new user
The yellow portal offers the ability to partners to create their own users with granular viewing permissions. To be able to manage users, you must have an admin, superuser or poweruser account.
Each user must have a user name, an email address, a password, a user level and specific permissions.
User name
The user name is a unique identifier on the entire platform, and is not case sensitive. Users with names that already exist cannot be created, and user names cannot be changed after creation. As such, it is not advisable to create users with names like “customer”, “manager” etc.
We also strictly recommend against sharing accounts. If you have two parties that need access to the same camera, you should create a user account for each of them, not let them use the same one. As a general rule of thumb, sharing an account among several users is acceptable if all of them also have shared access to the email address registered to the account, otherwise it is ill-advised.
Here are some guidelines we ask you to consider when naming a user:
A full company name is generally save to use as a username, if there is only intended to be one user account for that entire company.
If there are going to be multiple users for the same company, a combination of <company name>_<first letter of first name><last name> is recommended. Example: Weyland-Yutani_MBishop
For shared accounts that are only intended to be used by a partner itself, not its customers (as is usually the case with admins and superusers) a combination of <partner name>_<user level> is recommended. Example: Weyland-Yutani_admin. If you are expecting to need multiple admin or superuser accounts, follow the convention outlined in the previous point instead.
An email address is required,as several actions on the portal might use that address to deliver the results of certain operations, like for example large downloads.
Password
A password has a minimum length of 8 characters. There are no other conditions, but we highly recommend to make your passwords as strong as conveniently possible. Here is a good guideline for strong passwords and account security: https://blog.fleetsmith.com/password-security-guide/
Permissions
Permissions serve to control exactly which images a user is allowed to see or manage. You can choose one or multiple cameras, and you can choose one or multiple tables.
Camera permissions
Having permission for a specific camera will allow a user to perform all operations his user level allows on that camera, like for example configuring the schedule etc. It does not automatically grant access to the images of the camera. If you want a user to have permission for all of your cameras, you can pick the “All” option.
Table permissions
Any user can only see the images or feeds of the tables they have explicit permission for. A user does not implicitly receive those permissions by receiving a permission for a camera. This allows you to selectively restrict a user from seeing certain images or feeds of a camera. For example, you might decide that this user only has permission for the anonymised table, or that they may see all images except for those in original resolution. If you want a user to have access to all images of all cameras they have permission for, you can pick the “All” option.
Important!!
The camera and table permissions are not depending on each other. A user may have permissions for tables of a camera they do not have permission for. In this case, they will not be able to access the images directly, since they cannot browse the camera. However, they will see feeds pointing to that table, and, depending on their user level, may even be able to edit those feeds. If you assign a user permission for all tables, they will be able to see all the feeds, even those belonging to cameras they do not have explicit permission for. Keep this in mind when using the “all” option for table permissions.
User permissions
Users of level Admin, Superuser or Poweruser can manage other users. You can select which users you want this user to have permission for. If you want a user to have access to all users of adequate level, you can pick the “All” option. User permission can be granted according to the table bellow:
level | can have user permission for |
---|---|
guest, user | no one |
poweruser | guests, users |
superuser | guests, users, powerusers |
admin | every user |
User level
While permissions specify which cameras, images, and users a user has access to, the user level specifies what things they can do with these cameras and images. There are 5 user levels available, and you should choose the correct one depending on the tasks the user will have to execute, or the tasks they shouldn’t be allowed to execute.
Here’s a quick rundown of the user levels:
admin: Can do anything to tables, cameras and users they have permission for, and can create new ones. This should not be the default account you log in with to do ordinary work, as mistakes may cause loss of data.
superuser: Can do everything an Admin can do, except deleting cameras or tables. They can still delete images inside tables, so mistakes can still lead to some data loss.
poweruser: The poweruser level is intended for any user that requires limited control over the camera and might have to manage a handful of users. They are allowed to change most settings, but are prohibited from deleting or creating tables, feeds and cameras. They do have the ability to create new users, though only of lower levels. This is intended for customers that need to be able to manage third party access to the cameras images. Appart from that, powerusers are also allowed to download images in bulk.
user: The default level that most of your users should have. Users can view images and feeds they have permission for and they can trigger a camera remotely. They cannot delete or download any data and cannot see or change any settings.
guest: Can view images and feeds they have permission for.