You can also download this manual in PDF.
Description user functionalities iotroam
A user with IoT devices, for example a teacher, student or researcher, has the ability to use the self-service portal to:
- Personal IoT devices to add, modify and delete. These are personal devices, such as smartwatches. The administrator can also determine that users will not have this ability;
- Add, modify and delete IoT devices to a group, but only in groups for which the user has permissions. For example, a student can add a lab device for his/her practicum or a robot for the time period he/she will experiment with it;
- View all IoT devices and their details within the group(s) to which the user has permissions.
Login to the self-service portal
Go to https://www.iotroam.nl.
Click on 'Login'.
You will now be taken to the SURFconext login page for iotroam. Select your institution and log in with your institution account.
You are now logged in to the iotroam portal and will see the screen below.
On the left side at the top is Personal. Depending on your institution's policy, you can add a number of personal devices here. Below that are the groups to which you have been granted permissions. These permissions are set by your IT department.
By clicking on the arrow in the light blue bar, you will see your personal devices or the devices in the corresponding group.
Note: If your browser window is wide enough, the light blue bar will be fully visible immediately.
Add personal device
Click on Personal on the left side. Then click on blue +-sign with 'Add device' below it. You will now see the screen below.
Enter a description of the device.
Find the MAC address of the device and enter it under 'MAC'. The MAC address is often found on a sticker on the device and has the following syntax XX-XX-XX-XX-XX-XX-XX, where the X can have a value from 1 to 9 or A to F (hexadecimal).
The device location and expiration date are optional to enter. The expiration date is the date after which the device can no longer connect to the network. As the date approaches, the user will receive an e-mail with an option to enter a new expiration date. Of course, the user can also let it expire.
The 'Password' field contains a randomly selected and unique WiFi key. Clicking on the green eye shows the password.
Click on 'Create' to register the device.
Now the device can be connected to the WiFi network by choosing the SSID 'iotroam' and entering the iotroam password as the WiFi key or WiFi password.
Groups
A user who is a member of one or more groups will see the names of the corresponding group or groups on the left side under 'Personal'. If a group is not listed but is needed, contact the institution's ICT helpdesk.
Click on the name of a group and then the arrow in the light blue bar to see a list of the registered devices in that group. Click on the a device to view its details.
Note: If your browser screen is wide enough, the light blue bar will immediately be fully visible.
Add a device in a group
Click on the name of the group to which the device is to be added. Then click on the large +-symbol with "Add device" below it or in the device overview in the light blue bar on the + next to "Devices". Then go through the same steps as for a personal device.
Add devices in a group with CSV import
To add multiple devices in a group, it is possible to import them via a CSV file. An example of the CSV file can be downloaded in the portal. Click on the group where the devices should be added to. Click on the sentence 'Drag a CSV file here to import devices' in the lower right corner.
You will now see the screen below. From there, click on 'Preview CSV file' to download the preview.
When the CSV file is ready, it can be selected via 'Browse...'. After that, click on the Continue button. The list of devices is now displayed and a check is done for the correctness of the data, such as duplicate MAC addresses and whether a MAC address has the right number of characters and right characters (hexadecimal).
Important:
- MAC address and password are required in the CSV file, description and location are not. Description is recommended, though. If you do not want to fill a field, leave it blank and put the comma down before the next field, unless it is the last field;
- The password in the CSV file you have to generate and fill in yourself. You can choose this yourself. The reason behind this is that it takes a lot of time to find the password generated by iotroam in the iotroam portal for all imported devices afterwards. By choosing this yourself with CSV import, it is immediately known what it is with which device. You can optionally use a password generator.
Extend a device
When the expiration date of a device is approaching, the owner, in case of a personal device, or the group members, in case of a device in a group, get an email with the notification that the device will expire soon (the functionality of the reminder email is still in progress). The default expiration time for personal devices and groups is determined by the institution's iotroam administrator. This may be a different time for each group. If a device expires in iotroam, it will not be able to connect to the network after that date. Your institutions helpdesk can activate a device when it expired unintended.
Go through the following steps to renew a device.
Log into the iotroam portal and go to the device to be extended.
Click on the Edit button.
Choose a new expiry date for the device and click Save.
Delete a device
If you want to delete a device from iotroam, follow these steps.
Log in to the iotroam portal and click on the device you wish to delete. Click Edit and then click the Delete button. The device is now deleted.
This works the same for personal and group devices.
If a device was accidentally deleted, contact your institutions helpdesk. They can arrange for the device to be restored.
Settings
As a user you have the option to choose your language. To do this, click on the little flag next to your name in the top right corner of the screen. Choose the desired language. By default, the language setting of the browser is chosen.
