Internet of Things/Node-RED - Bewerkingsoverzicht

Eelco op 26 sep 2017 om 13:44

2017-09-26T13:44:31Z

← Oudere versie		Versie van 26 sep 2017 13:44
Regel 23:		Regel 23:
	# je stopt de server door middel van ^C (control-C) in hetzelfde terminal-venster.		# je stopt de server door middel van ^C (control-C) in hetzelfde terminal-venster.

	~~== Configureren van NodeRed ==~~

	~~=== Een eigen nodered-configuratie (settings.js) ===~~
	~~We hebben een aantal aanpassingen nodig in de settings, onder andere voor het beveiligen van het user interface. Hiervoor gebruiken we een lokale versie van het settings-bestand.~~
	~~# Kopieer het default settings-bestand naar je eigen workspace:~~
	~~## <code>cp $HOME/.node-red/settings.js .</code>~~
	~~# Start nu NodeRed met de lokale settings:~~
	~~## <code>node-red -s settings.js</code>~~
	~~# Controleer of NodeRed werkt, via de Preview~~
	~~# Stop de server met ^C.~~

	~~Voor het starten van NodeRed gebruik je dan voortaan: <code>node-red -s settings.js</code>~~

	~~=== Beveiligen van het interface ===~~
	Via het NodeRed interface kun je je eigen server inrichten. Maar, als je dit interface niet beveiligt, kunnen anderen dat ook. Je kunt je NodeRed-interface eenvoudig beveiligen. Zie ook: https://nodered.org/docs/security.html#usernamepassword-based-authentication

	~~# Installeer node-red-admin, met het volgende commando:~~
	~~## <code>npm install -g node-red-admin</code>~~
	~~# Maak de hashcode voor het wachtwoord waarmee je nodered wilt beveiligen:~~
	~~## <code>node-red-admin hash-pw</code>~~
	~~# Pas je eigen <code>settings.js</code> aan, met de c9-editor (klik op settings.js in de linker kolom).~~
	~~## zoek het gedeelte dat begint met <code>adminAuth: {</code>; dit staat nog als commentaar~~
	~~## verwijder voor dit gedeelte (t/m bijbehorende <code>}</code>) de commentaar-<code>//</code>~~
	~~## verander <code>admin</code> in je eigen naam~~
	~~## verander de hash-code voor het wachtwoord door de hashcode van je eigen wachtwoord.~~
	~~## bewaar het bestand.~~
	~~# Start node-red op (<code>node-red -s settings.js</code>), en ga naar de Preview.~~
	~~## als het goed is kom je nu in een inlog-pagina~~
	~~## voer je naam en wachtwoord (niet de hashcode!) in.~~

	~~Voorbeeld van een beveiligingsdeel:~~
	~~<syntaxhighlight lang=javascript>~~
	~~// Securing Node-RED~~
	~~// -----------------~~
	~~// To password protect the Node-RED editor and admin API, the following~~
	~~// property can be used. See http://nodered.org/docs/security.html for details.~~
	~~adminAuth: {~~
	~~type: "credentials",~~
	~~users: [{~~
	~~username: "hans",~~
	~~password: "$2a$08$5acKiQ0JAh/PYu6SARDQGOQusZ0myS10PkbWg9jOLFw1qSes/uz1W",~~
	~~permissions: "*"~~
	}]
	},
	~~</syntaxhighlight>~~

	~~=== Gebruik van statische bestanden ===~~

	We gebruiken voor de dynamische webpagina's NodeRed-flows. Maar een website bevat vaak ook statische bestanden, zoals css- en javascript-bestanden. Het is eenvoudiger om die direct af te laten handelen, buiten de flows om. In de configuratie (settings.js) kun je aangeven waar deze statische bestanden gevonden kunnen worden.

	~~In dit geval moet je het URL-pad voor de editor aanpassen. We kiezen daarvoor <code>.../admin</code>.~~

	~~# Breng de volgende wijzigingen aan in <code>settings.js</code>:~~
	~~# - pas het URL-pad voor de editor aan:~~
	~~## <code> httpAdminRoot: '/admin',</code>~~
	~~# - geef de map (directory) waar NodeRed de statische bestanden kan vinden, bijvoorbeeld:~~
	~~## <code> httpStatic: '/home/ubuntu/workspace/node-red-static/', </code>~~
	~~## NB: pas dit aan voor je eigen situatie; dit is een keuze voor Cloud9.~~
	~~# Herstart NodeRed~~
	~~## <code>node-red -s settings.js</code>~~

	~~Het resultaat in settings.js ziet er dan als volgt uit:~~
	~~<syntaxhighlight lang=javascript>~~
	~~// By default, the Node-RED UI is available at http://localhost:1880/~~
	~~// The following property can be used to specifiy a different root path.~~
	~~// If set to false, this is disabled.~~
	~~httpAdminRoot: '/admin',~~
	~~...~~
	~~// When httpAdminRoot is used to move the UI to a different root path, the~~
	~~// following property can be used to identify a directory of static content~~
	~~// that should be served at http://localhost:1880/.~~
	~~httpStatic: '/home/ubuntu/workspace/node-red-static/',~~
	~~</syntaxhighlight>~~

	== Tutorial: first flow ==		== Tutorial: first flow ==

Eelco: /* Node-RED */

2017-09-26T13:43:32Z

Node-RED

← Oudere versie		Versie van 26 sep 2017 13:43
Regel 7:		Regel 7:
	In het bijzonder kun je je toepassing koppelen aan allerlei andere interfaces. Zo kun je bijvoorbeeld MQTT-boodschappen afhandelen, en deze in een database opslaan. In een andere flow kun je een http GET-request afhandelen, met een pagina met deze MQTT-gegevens als respons.		In het bijzonder kun je je toepassing koppelen aan allerlei andere interfaces. Zo kun je bijvoorbeeld MQTT-boodschappen afhandelen, en deze in een database opslaan. In een andere flow kun je een http GET-request afhandelen, met een pagina met deze MQTT-gegevens als respons.

	[[/NodeRed-installatie]]		* [[/NodeRed-installatie]]
			* [[/NodeRed-configuratie]]

	== Het installeren van Node-RED in Cloud9 (c9.io) ==		== Het installeren van Node-RED in Cloud9 (c9.io) ==

Eelco op 26 sep 2017 om 13:40

2017-09-26T13:40:42Z

← Oudere versie		Versie van 26 sep 2017 13:40
Regel 6:		Regel 6:

	In het bijzonder kun je je toepassing koppelen aan allerlei andere interfaces. Zo kun je bijvoorbeeld MQTT-boodschappen afhandelen, en deze in een database opslaan. In een andere flow kun je een http GET-request afhandelen, met een pagina met deze MQTT-gegevens als respons.		In het bijzonder kun je je toepassing koppelen aan allerlei andere interfaces. Zo kun je bijvoorbeeld MQTT-boodschappen afhandelen, en deze in een database opslaan. In een andere flow kun je een http GET-request afhandelen, met een pagina met deze MQTT-gegevens als respons.

			[[/NodeRed-installatie]]

	== Het installeren van Node-RED in Cloud9 (c9.io) ==		== Het installeren van Node-RED in Cloud9 (c9.io) ==

Eelco: /* Gebruik van statische bestanden */

2017-09-26T13:22:51Z

Gebruik van statische bestanden

← Oudere versie		Versie van 26 sep 2017 13:22
Regel 81:		Regel 81:
	## <code>node-red -s settings.js</code>		## <code>node-red -s settings.js</code>

	Het resultaat ziet er dan als volgt uit:		Het resultaat in settings.js ziet er dan als volgt uit:
	<syntaxhighlight lang=javascript>		<syntaxhighlight lang=javascript>
	// By default, the Node-RED UI is available at http://localhost:1880/		// By default, the Node-RED UI is available at http://localhost:1880/

Eelco: /* Beveiligen van het interface */

2017-09-26T13:21:58Z

Beveiligen van het interface

@@ Regel 64: / Regel 64: @@
          }]
      },
 </syntaxhighlight>

Eelco: /* Het installeren van Node-RED in Cloud9 (c9.io) */

2017-09-26T09:23:30Z

Het installeren van Node-RED in Cloud9 (c9.io)

← Oudere versie		Versie van 26 sep 2017 09:23
Regel 19:		Regel 19:
	## (ook anderen kunnen dit gebruiken; met alle voor- en nadelen vandien)		## (ook anderen kunnen dit gebruiken; met alle voor- en nadelen vandien)
	# je stopt de server door middel van ^C (control-C) in hetzelfde terminal-venster.		# je stopt de server door middel van ^C (control-C) in hetzelfde terminal-venster.

			== Configureren van NodeRed ==

	=== Een eigen nodered-configuratie (settings.js) ===		=== Een eigen nodered-configuratie (settings.js) ===

Eelco op 26 sep 2017 om 09:22

2017-09-26T09:22:43Z

← Oudere versie		Versie van 26 sep 2017 09:22
Regel 57:		Regel 57:
	type: "credentials",		type: "credentials",
	users: [{		users: [{
	username: "~~eelco~~",		username: "hans",
	password: "$2a$08$5acKiQ0JAh/PYu6SARDQGOQusZ0myS10PkbWg9jOLFw1qSes/uz1W",		password: "$2a$08$5acKiQ0JAh/PYu6SARDQGOQusZ0myS10PkbWg9jOLFw1qSes/uz1W",
	permissions: "*"		permissions: "*"

Eelco: /* Beveiligen van het interface */

2017-09-26T09:22:17Z

Beveiligen van het interface

← Oudere versie		Versie van 26 sep 2017 09:22
Regel 49:		Regel 49:

	Voorbeeld van een beveiligingsdeel:		Voorbeeld van een beveiligingsdeel:
	<~~code~~>		<syntaxhighlight lang=javascript>
	// Securing Node-RED		// Securing Node-RED
	// -----------------		// -----------------
Regel 62:		Regel 62:
	}]		}]
	},		},
	</~~code~~>		</syntaxhighlight>

	== Tutorial: first flow ==		== Tutorial: first flow ==

Eelco: /* Het installeren van Node-RED in Cloud9 (c9.io) */

2017-09-26T09:21:26Z

Het installeren van Node-RED in Cloud9 (c9.io)

← Oudere versie		Versie van 26 sep 2017 09:21
Regel 20:		Regel 20:
	# je stopt de server door middel van ^C (control-C) in hetzelfde terminal-venster.		# je stopt de server door middel van ^C (control-C) in hetzelfde terminal-venster.

	=== ~~Beveiligen van het interface~~ ===		=== Een eigen nodered-configuratie (settings.js) ===
	We hebben een aantal aanpassingen nodig in de settings, onder andere voor het beveiligen van het user interface. Hiervoor gebruiken we een lokale versie van het settings-bestand. ~~Zie ook: https://nodered.org/docs/security.html#usernamepassword-based-authentication~~		We hebben een aantal aanpassingen nodig in de settings, onder andere voor het beveiligen van het user interface. Hiervoor gebruiken we een lokale versie van het settings-bestand.
	# Kopieer het default settings-bestand naar je eigen workspace:		# Kopieer het default settings-bestand naar je eigen workspace:
	## <code>cp $HOME/.node-red/settings.js .</code>		## <code>cp $HOME/.node-red/settings.js .</code>
Regel 28:		Regel 28:
	# Controleer of NodeRed werkt, via de Preview		# Controleer of NodeRed werkt, via de Preview
	# Stop de server met ^C.		# Stop de server met ^C.

			Voor het starten van NodeRed gebruik je dan voortaan: <code>node-red -s settings.js</code>

			=== Beveiligen van het interface ===
			Via het NodeRed interface kun je je eigen server inrichten. Maar, als je dit interface niet beveiligt, kunnen anderen dat ook. Je kunt je NodeRed-interface eenvoudig beveiligen. Zie ook: https://nodered.org/docs/security.html#usernamepassword-based-authentication

	# Installeer node-red-admin, met het volgende commando:		# Installeer node-red-admin, met het volgende commando:
	## <code>npm install -g node-red-admin</code>		## <code>npm install -g node-red-admin</code>
Regel 42:		Regel 48:
	## voer je naam en wachtwoord (niet de hashcode!) in.		## voer je naam en wachtwoord (niet de hashcode!) in.

	~~=== Uitleg ===~~		Voorbeeld van een beveiligingsdeel:
			<code>
	~~Cloud9 biedt je een virtuele machine voor elke workspace. In deze virtuele machine kun je een webserver draaien. Al die verschillende virtuele machines moeten een klein aantal IP~~-~~adressen delen. Hiervoor bepaalt Cloud9 het IP~~-~~adres en het PORT~~-~~nummer voor elke virtuele webserver~~, ~~respectievelijk <code>process~~.~~env.IP<~~/~~code> en <code>process.env~~.~~PORT<~~/~~code>. Deze gegevens moeten ingevuld worden in de node-red instellingen in het bestand <code>settings.js<~~/~~code>~~. ~~Dit is al voor je gedaan in het bestand dat je hierboven gekopieerd hebt~~.		// Securing Node-RED
	: ~~Als je node-red op je eigen computer gebruikt, dan kun je de default-instellingen gebruiken~~: ~~<code>127.0.0.1</code> (localhost)~~, ~~met port~~: ~~1880.~~		// -----------------
			// To password protect the Node-RED editor and admin API, the following
	~~==== Voor gevorderden ====~~		// property can be used. See http://nodered.org/docs/security.html for details.
			adminAuth: {
	~~Je kunt node-red starten en stoppen via een terminal (shell). Een alternatief is om een eigen~~ "~~runner~~" ~~aan te maken. Dan kun je de~~ "~~Run~~" ~~knop gebruiken.~~		type: "credentials",
			users: [{
			username: "eelco",
			password: "$2a$08$5acKiQ0JAh/PYu6SARDQGOQusZ0myS10PkbWg9jOLFw1qSes/uz1W",
			permissions: "*"
			}]
			},
			</code>

	== Tutorial: first flow ==		== Tutorial: first flow ==

Eelco: /* Beveiligen van het interface */

2017-09-26T08:56:18Z

Beveiligen van het interface

← Oudere versie		Versie van 26 sep 2017 08:56
Regel 21:		Regel 21:

	=== Beveiligen van het interface ===		=== Beveiligen van het interface ===
	We hebben een aantal aanpassingen nodig in de settings, onder andere voor het beveiligen van het user interface. Hiervoor gebruiken we een lokale versie van het settings-bestand.		We hebben een aantal aanpassingen nodig in de settings, onder andere voor het beveiligen van het user interface. Hiervoor gebruiken we een lokale versie van het settings-bestand. Zie ook: https://nodered.org/docs/security.html#usernamepassword-based-authentication
	# Kopieer het default settings-bestand naar je eigen workspace:		# Kopieer het default settings-bestand naar je eigen workspace:
	## <code>cp $HOME/.node-red/settings.js .</code>		## <code>cp $HOME/.node-red/settings.js .</code>