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 or superuser 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.

Email

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 level

While permissions specify which cameras and images 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, but only 3 of them are intended to be used by customers. Admins and superusers should only be used by a yellow partner internally. Also, superusers are not allowed to create new admin or superuser accounts.

Here’s a quick rundown of the user levels:

  • admin: Essentially, can do anything. This should not be the default account you log in with to do ordinary work, as wrong actions may cause damage to your 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 damage your data, it’s just a bit more difficult.

  • poweruser: The poweruser level is intended for any of your customers you wish to give limited control over the camera. They are allowed to delete and/or download images, to change a cameras schedule, capture an image or focus remotely and change feed settings. They cannot create new cameras or feeds. In the future, powerusers we plan to give poweruser limited user managment abilities as well.

  • 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.