TC 2.1b - Use snap4city nodes on your local IoT Application


Warning message

You can't delete this newsletter because it has not been sent to all its subscribers.

Test Case Title

TC2.1b - Use snap4city nodes on your local IoT Application


The goal for this test case is to present a scenario that show how an user can

  • Install snap4city nodes on his/her local IoTApplication
  • Authenticate the nodes to use services in snap4city's cloud


A snap4city user registered

The user has installed Nodered on one of his devices

Expected successful result

The user is able to install the Snap4city nodes and use them with authentication




Please note that some of the following links could be accessible only for registered users.

1. Connect to your IoT Application installed on the device (usually the url is http://localhost:1880). Click on the top right corner to open the menu and then click on the Manage Palette item



2. A panel appears from the right of the screen.


3. Click on the "Install" tab and search the string "snap4city". The nodes are filtered and only two item should remain. Node-red-contrib-snap4city-user contains all the basic microservice for Final Users, meanwhile Node-red-contrib-snap4city-developer contains also the microservice for Developer (S4C Search Dev, S4CBigData, etc…), according the list available under Documentation And Articles  IOT Microservices For Final Users / Developer



4. Once one or both packages are installed, you can use them on your IoT Application. Some of these nodes (S4CData, S4CDashboard, S4CIoT) need to be authenticated in order to work properly with the services offered by Snap4city.

5. For example, if you try to use the "Impulse-Button" node found in the S4CDashboard group. It shows the messages that indicate to the user that he must register on the site and that the registration data are entered correctly to retrieve (in the particular case of the nodes of the S4CDashboard group) the list of the dashboards owned by that user.


6. Clicking on the button with the pencil as icon you can enter the username and password to link the nodes that are created to the user entered7. Once the data has been entered, it is possible to click on the "Add" button (which saves the user name and password), on the "Done" button (which saves the data of the node) and on the "Deploy" button (which allows the data just entered to be saved in a persistent way). If the authentication data is correct, the node will show all the information to be entered in the configuration in order to use that node.

8. If the authentication data is wrong, the node will display the message notifying the user to check the data.

9. Once the correct data has been entered, each node belonging to the previously written groups will automatically obtain authentication using the data entered in the first node. Also, if you go to you can find the IotApplication on which you entered the data. IotApplication ownership is associated with the first user to successfully enter data into a node.


10. The name given to the new authenticated IoTApplication is the date of creation of the first authentication. The color of the icon of that application will be green to indicate that the registered one is an IoT Edge App. When you are in the same network as the device on which the IoTApplication is installed by clicking on this icon you can see the editor on which to insert the flows