Create Users and Groups
The prime source of users is the Azure Active Directory (AAD) of the Azure Subscription where the system is installed. The system resources are created within a dedicated Resource Group in that Azure Subscription. In the AAD a dedicated user group (Root User Group) is created where all users with access to the system should be added. The name of this user group is with the name of the Resource Group.
Important note: All users (and groups) members of the Root User Group are automatically synced (periodically) with the system’s internal database.
Purpose: Users and groups in Upkip can be created by the user with the role System administrator.
Precondition: Log in to the Upkip Administration as a user with a role System administrator.
- The user sees organizations and menu Users and Groups.
Figure 1: Upkip Administration - Home page
Click on the button USERS AND GROUPS
- Form for creating users and groups is opened.
Figure 2: Upkip Administration - Create users and groups
Create or Delete Groups
Purpose: Created groups in AAD are related to some department(s) or whole factory. They are used for limiting user rights only to some department(s) or to the whole factory in the Upkip Visualization.
Selecting tab Department groups the user is possible to create or delete groups.
Figure 3: Upkip Administration - Create or Delete groups
Enter the group name in Create group and click Create.
- The new group is added in Azure Active Directory /Groups. The new group is visible in the dropdown for deleting groups.
From the Select group in the Delete group section select the newly created group and click Delete.
- The group is deleted from Azure Active Directory/Groups
Create User in Upkip
Purpose: The user can create new users in Upkip from Upkip Administration by automatically using the Azure functionality Create user.
Precondition: The user with role System administrator is logged in to the Upkip Administration. Click on the menu Users and Groups. Click on the tab Create User.
- The form for creating users and groups in Upkip is opened
Figure 4: Upkip Administration - Create new user
Enter user data:
- User name - enter user name till "@". The domain name will be added automatically
- Password - user password
- Names - user first and last names
- Role – select from roles list
- Group(optional) – select from the groups list
After filling all fields, Create button is enabled. Click Create.
- The user should be created successfully if all information is added
- The user is created in the azure active directory
- The user is added to the selected group
- The user is synchronized with the Upkip internal database and can log in to the applications Upkip Administration and Upkip Visualization.
Invite User in Upkip
Purpose: The user can create new users in Upkip from Upkip Administration by automatically using azure functionality Invite user.
Precondition: The user with role System administrator is logged in to the Upkip Administration. Click on the menu Users and Groups. Click on the tab Invite User.
- The form for inviting users in Upkip is opened
Figure 5: Upkip Administration - invite users
Enter user data:
- Name - the user first and last names
- Email – user email
- Role – select from the roles list
- Group(optional) – select from the groups' list
After filling in all fields, the Invite button is enabled. Click Invite.
- The user will be emailed an invitation they can accept
The user has to click Accept Invitation in the received email. If the user has not Microsoft account, he is guided to create a Microsoft account.
The user logs in with their Microsoft account and clicks Accept button.
- The new user is created in AAD and appears in the AAD All users list
- The user is added to the select group (if selected)
- The user is synchronized with the Upkip internal database and can log in to the applications Upkip Administration and Upkip Visualization.
Add User in Upkip
Purpose: The user can add to the Upkip existing users from AAD. Existing users not added to Upkip are shown in the User dropdown list.
Precondition: The user with role System administrator is logged in to the Upkip Administration. Click on the menu Users and Groups. Click on the tab Add User.
- The form for adding users in Upkip is opened
Figure 6: Upkip Administration - Add user to Upkip
Users existing in AAD and not added to Upkip are listed in the User dropdown list. Enter user data:
- User - select an existing user from the User dropdown list
- Role – select from the roles list
- Group(optional) – select from the groups' list
After filling in all fields, the Add button is enabled. Click Add.
- Selected user from AAD is added to Upkip
- The user is added to the selected group (if selected)
- The user is synchronized with the Upkip internal database and can log in to the applications Upkip Administration and Upkip Visualization.
Upkip Visualization Sign in
The created user in Upkip by Create, Invite, or Add automatically is synchronized with the Upkip internal database.
The new user automatically is added to the corresponding team in the Upkip Visualization (The team is related to the assigned role in AAD)
Sign in with Azure AD in the Upkip Visualization as a newly created user
Figure 7: Upkip Visualization login form
Click on the button Sign in with Azure AD button, enter username and password.
- The new user is logged in to the Upkip Visualization
- The user see dashboards depending on their role
Figure 8: Upkip Visualization Home page
To check if the created user is added to the team in Upkip Visualization, log as a user with a role System administrator. Select menu Teams.
Figure 9: Upkip Visualization - Open Teams page
- The Teams page is opened
Click on some Team – e.g. Manager (if the new user has role Manager)
Figure 10: Upkip Visualization - Open Team page
- The team page is opened – e.g. Teams/Manager page
- The user is added to the team (e.g. with role Manager)
Upkip Administration Sign in
Precondition: To log in the Upkip Administration user should have been assigned the role System Administrator or Organization Administrator.
Navigate to the Upkip Administration login page.
Figure 11: Upkip Administration Login page
Click on the button Sign in with Microsoft. Enter Microsoft account user name and password.
- The Upkip Administration Home page is opened.
Figure 12: Upkip Administration Home page
The main elements of the page are:
- Vertical menus (collapsible)
- An Organization tree structure with factory, departments, and machines
- Factory floors layout with machines (Factory Layout is visualized in the Upkip Visualization)
To sign out from Upkip Administration click on the top right button.
- The user is logged out of the Upkip Administration
Edit and Delete Users
Edit User role in the Upkip
Purpose: From the Upkip Administration-Organizations users list is possible to edit the user role.
Precondition: The user with the role System Administrator is logged in Upkip Administration
Click on the users’ icon and open the Users list. Users are created in the AAD of the tenant where the Upkip has been installed. Users are synchronized with the Upkip internal database.
Figure 13: Upkip Administration - Open Users' form
- Users list form is opened.
Figure 14: Upkip Administration - Users list
Find the user in the list and click Edit.
- Edit user form is opened.
In Edit user form is possible to:
- Add the user phone number
- Change user role
- Add allowed time interval for different notifications by Email, SMS, Viber, Microsoft Teams.
Change user role from the dropdown with roles and click OK.
Figure 15: Upkip Administration - Edit user - change user role
- User role is changed in Azure Active Directory (AAD)
- Automatically executed synchronization of users
- The user's new role is visible in the Upkip Administration users’ list
- User role is changed also in the Upkip Visualization team (this is visible in User/Preferences/Teams)
Delete User from Upkip
Purpose: The user can be deleted from the Upkip platform by deleting in Azure Active Directory (AAD) and then by synchronization removed from the Upkip internal database.
The user with a role System Administrator (Global administrator) is logged in AAD of the Azure Subscription where the system is installed.
Navigate to the Azure Active Directory/All Users. Search for a user, check the user, and click Delete user. Confirm “Delete selected user?” with OK.
- The user is successfully deleted from AAD
Log in as System Administrator in Upkip Administration. Open the users' list and click the button Synchronize.
Figure 16: Upkip Users list - Synchronize users
- Deleted user in AAD is also removed from the Upkip internal database.
- The user is removed from the Upkip Administration
- The user is removed from the Upkip Visualization.