Allowed - Versionsgeschichte

Ph1959de: diverse kleinere Korrekturen

2024-12-06T17:11:42Z

diverse kleinere Korrekturen

← Nächstältere Version		Version vom 6. Dezember 2024, 19:11 Uhr
Zeile 9:		Zeile 9:
	}}		}}
	DE \| [[Allowed/en\|EN]]		DE \| [[Allowed/en\|EN]]

	[[allowed]] ist ein Erweiterungsmodul um Zugriffe auf die von fhem.pl bereitgestellten Serverdienste (FHEM-Webserver und FHEM-telnet-Server) abzusichern und zu steuern.		[[allowed]] ist ein Erweiterungsmodul um Zugriffe auf die von fhem.pl bereitgestellten Serverdienste (FHEM-Webserver und FHEM-telnet-Server) abzusichern und zu steuern.

	==Einführung==		==Einführung==
	In der Grundkonfiguration kann jeder, der sich ~~in dem~~ selben Netzwerk<ref>Haben z.B. in Ihrem Heimnetzwerk alle angeschlossenen Geräte Adressen aus dem Bereich 192.168.178.x, wäre ein Zugriff von einem Gerät mit der Adresse 192.168.178.3 zulässig, nicht aber von 192.168.'''179'''.3 </ref> wie der FHEM-Server befindet, unverschlüsselt und ohne ~~der~~ Eingabe von Benutzerdaten auf FHEM zugreifen. FHEM weist mit einer Sicherheitswarnung auf diesen Umstand hin.		In der Grundkonfiguration kann jeder, der sich im selben Netzwerk<ref>Haben z.B. in Ihrem Heimnetzwerk alle angeschlossenen Geräte Adressen aus dem Bereich 192.168.178.x, wäre ein Zugriff von einem Gerät mit der Adresse 192.168.178.3 zulässig, nicht aber von 192.168.'''179'''.3 </ref> wie der FHEM-Server befindet, unverschlüsselt und ohne Eingabe von Benutzerdaten auf FHEM zugreifen. FHEM weist mit einer Sicherheitswarnung auf diesen Umstand hin.
	Das Definieren einer allowed-Instanz ist eine Möglichkeit, die Installation abzusichern.		Das Definieren einer allowed-Instanz ist eine Möglichkeit, die Installation abzusichern.

	~~Daher~~ ist es erforderlich, eine allowed-Instanz zu definieren, um		Es ist erforderlich, eine allowed-Instanz zu definieren, um
	* Zugriffe auf FHEM aus anderen Netzwerken zu ermöglichen und/oder		* Zugriffe auf FHEM aus anderen Netzwerken zu ermöglichen und/oder
	* die Möglichkeiten, auf FHEM zuzugreifen für Teilnehmer desselben Netzwerks einzuschränken oder auszuschließen.		* die Möglichkeiten, auf FHEM zuzugreifen für Teilnehmer desselben Netzwerks einzuschränken oder auszuschließen.
Zeile 57:		Zeile 56:
	</pre>		</pre>
	basicAuthExpiry erwartet einen Wert in Tagen (in diesem Beispiel also 90 Tage). Nach der Anmeldung wird ein Cookie in den Browser des Benutzers gesetzt, der ein erneutes Eingeben der Anmeldedaten obsolet macht. Dies sollte nur in sicheren Umgebungen gemacht werden und lässt sich nur in Kombination mit einem gesetzten basicAuth realisieren.		basicAuthExpiry erwartet einen Wert in Tagen (in diesem Beispiel also 90 Tage). Nach der Anmeldung wird ein Cookie in den Browser des Benutzers gesetzt, der ein erneutes Eingeben der Anmeldedaten obsolet macht. Dies sollte nur in sicheren Umgebungen gemacht werden und lässt sich nur in Kombination mit einem gesetzten basicAuth realisieren.

			== Fußnoten ==
			<references />

	== Weblinks ==		== Weblinks ==
	*[https://demaya.de/fhem-eingeloggt-bleiben-basicauthexpiry/ Ausführliche Erklärung zu dem Attribut "basicAuthExpiry"]		*[https://demaya.de/fhem-eingeloggt-bleiben-basicauthexpiry/ Ausführliche Erklärung zu dem Attribut "basicAuthExpiry"]

Krikan: /* Beispiele */

2019-05-07T15:03:51Z

Beispiele

← Nächstältere Version		Version vom 7. Mai 2019, 17:03 Uhr
Zeile 48:		Zeile 48:
	attr allowedTelnet password secret		attr allowedTelnet password secret
	</pre>		</pre>

			Die <code>set <allowed></code>-Befehle <code>basicAuth <username> <password></code>, <code>password <password></code> und <code>globalpassword <password></code> setzen das entsprechende Attribut, indem sie aus den Parameter(n) und Salt ein SHA256 Hashwert berechnen (Achtung: das Perl-Modul Digest::SHA wird benötigt.). Beim direkten Setzen der Attribute, beispielsweise über <code>attr</code>, erfolgt keine Umsetzung von Attributwerten; die Attribute werden so gespeichert, wie angegeben.

	Erweiterung, dass nicht bei jedem Login die Anmeldeinformationen abgefragt werden:		Erweiterung, dass nicht bei jedem Login die Anmeldeinformationen abgefragt werden:

	<pre>		<pre>
	attr allowedWEB basicAuthExpiry 90		attr allowedWEB basicAuthExpiry 90

Drhirn: englische Version hier verlinkt

2018-06-13T12:21:38Z

englische Version hier verlinkt

← Nächstältere Version		Version vom 13. Juni 2018, 14:21 Uhr
Zeile 8:		Zeile 8:
	\|ModOwner=rudolfkoenig / [http://forum.fhem.de/index.php?action=profile;u=8 rudolfkoenig]		\|ModOwner=rudolfkoenig / [http://forum.fhem.de/index.php?action=profile;u=8 rudolfkoenig]
	}}		}}
			DE \| [[Allowed/en\|EN]]

	[[allowed]] ist ein Erweiterungsmodul um Zugriffe auf die von fhem.pl bereitgestellten Serverdienste (FHEM-Webserver und FHEM-telnet-Server) abzusichern und zu steuern.		[[allowed]] ist ein Erweiterungsmodul um Zugriffe auf die von fhem.pl bereitgestellten Serverdienste (FHEM-Webserver und FHEM-telnet-Server) abzusichern und zu steuern.

Demaya: Hinzufügen des Attributs basicAuthExpiry in den Beispielen, Umbau in pre-Tags bei den Beispielen

2018-04-15T21:08:55Z

Hinzufügen des Attributs basicAuthExpiry in den Beispielen, Umbau in pre-Tags bei den Beispielen

← Nächstältere Version		Version vom 15. April 2018, 23:08 Uhr
Zeile 22:		Zeile 22:
	Ein allowed-Device für ein- oder mehrere FHEMWEB oder telnet-Instanzen wird wie folgt definiert:		Ein allowed-Device für ein- oder mehrere FHEMWEB oder telnet-Instanzen wird wie folgt definiert:

	define <name> allowed <deviceList>		<pre>
			define <name> allowed <deviceList>
			</pre>

	==Weitere Hinweise==		==Weitere Hinweise==
Zeile 33:		Zeile 35:
	== Beispiele ==		== Beispiele ==
	Festlegen eines Users samt Passwort für gängige FHEMWEB-Instanzen:		Festlegen eines Users samt Passwort für gängige FHEMWEB-Instanzen:
	define allowedWEB allowed		<pre>
	attr allowedWEB validFor WEB,WEBphone,WEBtablet		define allowedWEB allowed
	attr allowedWEB basicAuth { "$user:$password" eq "admin:secret" }		attr allowedWEB validFor WEB,WEBphone,WEBtablet
	attr allowedWEB allowedCommands set,get		attr allowedWEB basicAuth { "$user:$password" eq "admin:secret" }
			attr allowedWEB allowedCommands set,get
			</pre>
	Dasselbe für Telnet:		Dasselbe für Telnet:
	define allowedTelnet allowed		<pre>
	attr allowedTelnet validFor telnetPort		define allowedTelnet allowed
	attr allowedTelnet password secret		attr allowedTelnet validFor telnetPort
			attr allowedTelnet password secret
			</pre>
			Erweiterung, dass nicht bei jedem Login die Anmeldeinformationen abgefragt werden:
			<pre>
			attr allowedWEB basicAuthExpiry 90
			</pre>
			basicAuthExpiry erwartet einen Wert in Tagen (in diesem Beispiel also 90 Tage). Nach der Anmeldung wird ein Cookie in den Browser des Benutzers gesetzt, der ein erneutes Eingeben der Anmeldedaten obsolet macht. Dies sollte nur in sicheren Umgebungen gemacht werden und lässt sich nur in Kombination mit einem gesetzten basicAuth realisieren.

	~~<!--~~		== Weblinks ==
	== ~~Links~~ ==		*[https://demaya.de/fhem-eingeloggt-bleiben-basicauthexpiry/ Ausführliche Erklärung zu dem Attribut "basicAuthExpiry"]
	-->

Beta-User: HTTPS als Empfehlung, ungenutzte Bereiche deaktiviert, Baustelle entfernt

2018-03-14T06:21:32Z

HTTPS als Empfehlung, ungenutzte Bereiche deaktiviert, Baustelle entfernt

← Nächstältere Version		Version vom 14. März 2018, 08:21 Uhr
Zeile 1:		Zeile 1:
	~~{{Baustelle}}~~
	{{SEITENTITEL:allowed}} <!-- da richtige Schreibweise kleinen Anfangsbuchstaben hat -->		{{SEITENTITEL:allowed}} <!-- da richtige Schreibweise kleinen Anfangsbuchstaben hat -->
	{{Infobox Modul		{{Infobox Modul
Zeile 27:		Zeile 26:
	==Weitere Hinweise==		==Weitere Hinweise==
	Sofern FHEM nicht nur aus dem lokalen Netz erreichbar sein soll, sollten neben der Definition einer oder mehrerer allowed-Instanzen zusätzliche Sicherheitsmaßnahmen ergriffen werden. Mögliche Optionen dafür sind die Verwendung eines VPNs (Virtual Private Network) und/oder eines Reverse-Proxy-Servers mit z.B. [[Apache_Authentication_Proxy\|Apache]] oder [[HTTPS-Absicherung_%26_Authentifizierung_via_nginx_Webserver\|nginx]].		Sofern FHEM nicht nur aus dem lokalen Netz erreichbar sein soll, sollten neben der Definition einer oder mehrerer allowed-Instanzen zusätzliche Sicherheitsmaßnahmen ergriffen werden. Mögliche Optionen dafür sind die Verwendung eines VPNs (Virtual Private Network) und/oder eines Reverse-Proxy-Servers mit z.B. [[Apache_Authentication_Proxy\|Apache]] oder [[HTTPS-Absicherung_%26_Authentifizierung_via_nginx_Webserver\|nginx]].
	~~Zusätzlich kann~~ für FHEMWEB mithilfe des Attributes {{Link2CmdRef\|Anker=HTTPS\|Lang=de\|Label=HTTPS}} eine HTTPS-Verbindung ~~aktiviert werden~~. Für telnet (welches mehr oder weniger ein TCP/IP Port ist) wird das Attribut {{Link2CmdRef\|Anker=SSL\|Lang=de\|Label=SSL}} verwendet.		Es wird dringend empfohlen, für alle Webserver des Typs '''FHEMWEB''' mithilfe des Attributes {{Link2CmdRef\|Anker=HTTPS\|Lang=de\|Label=HTTPS}} eine HTTPS-Verbindung zu aktivieren. Für telnet (welches mehr oder weniger ein TCP/IP Port ist) wird das Attribut {{Link2CmdRef\|Anker=SSL\|Lang=de\|Label=SSL}} verwendet.


			<!--
	== Einschränkungen ==		== Einschränkungen ==
			-->
	== Beispiele ==		== Beispiele ==
	Festlegen eines Users samt Passwort für gängige FHEMWEB-Instanzen:		Festlegen eines Users samt Passwort für gängige FHEMWEB-Instanzen:
Zeile 42:		Zeile 41:
	attr allowedTelnet validFor telnetPort		attr allowedTelnet validFor telnetPort
	attr allowedTelnet password secret		attr allowedTelnet password secret

			<!--
	== Links ==		== Links ==
			-->

Beta-User: Modultyp geändert

2018-03-13T08:24:08Z

Modultyp geändert

← Nächstältere Version		Version vom 13. März 2018, 10:24 Uhr
Zeile 3:		Zeile 3:
	{{Infobox Modul		{{Infobox Modul
	\|ModPurpose=Absicherung des FHEM-Servers		\|ModPurpose=Absicherung des FHEM-Servers
	\|ModType=d		\|ModType=h
	\|ModCmdRef=allowed		\|ModCmdRef=allowed
	\|ModForumArea=Automatisierung		\|ModForumArea=Automatisierung

Beta-User: Einleitung geändert

2018-03-13T08:22:22Z

Einleitung geändert

← Nächstältere Version		Version vom 13. März 2018, 10:22 Uhr
Zeile 10:		Zeile 10:
	}}		}}

	[[allowed]] ist ein Erweiterungsmodul um Zugriffe auf ~~den~~ von fhem.pl bereitgestellten ~~Serverdienst~~ abzusichern.		[[allowed]] ist ein Erweiterungsmodul um Zugriffe auf die von fhem.pl bereitgestellten Serverdienste (FHEM-Webserver und FHEM-telnet-Server) abzusichern und zu steuern.

	==Einführung==		==Einführung==

Beta-User: Einleitung geändert

2018-03-13T08:19:57Z

Einleitung geändert

← Nächstältere Version		Version vom 13. März 2018, 10:19 Uhr
Zeile 7:		Zeile 7:
	\|ModForumArea=Automatisierung		\|ModForumArea=Automatisierung
	\|ModTechName=96_allowed.pm		\|ModTechName=96_allowed.pm
	\|ModOwner=rudolfkoenig ([http://forum.fhem.de/index.php?action=profile;u=8 ~~Forum] / [[Benutzer Diskussion:~~rudolfkoenig~~\|Wiki]~~])		\|ModOwner=rudolfkoenig / [http://forum.fhem.de/index.php?action=profile;u=8 rudolfkoenig]
	}}		}}

	In der Grundkonfiguration kann jeder, der sich in dem selben Netzwerk wie der FHEM-Server befindet, unverschlüsselt und ohne der Eingabe von Benutzerdaten auf FHEM zugreifen. FHEM weist mit einer Sicherheitswarnung auf diesen Umstand hin.		[[allowed]] ist ein Erweiterungsmodul um Zugriffe auf den von fhem.pl bereitgestellten Serverdienst abzusichern.

			==Einführung==
			In der Grundkonfiguration kann jeder, der sich in dem selben Netzwerk<ref>Haben z.B. in Ihrem Heimnetzwerk alle angeschlossenen Geräte Adressen aus dem Bereich 192.168.178.x, wäre ein Zugriff von einem Gerät mit der Adresse 192.168.178.3 zulässig, nicht aber von 192.168.'''179'''.3 </ref> wie der FHEM-Server befindet, unverschlüsselt und ohne der Eingabe von Benutzerdaten auf FHEM zugreifen. FHEM weist mit einer Sicherheitswarnung auf diesen Umstand hin.
	Das Definieren einer allowed-Instanz ist eine Möglichkeit, die Installation abzusichern.		Das Definieren einer allowed-Instanz ist eine Möglichkeit, die Installation abzusichern.

	~~Ist keine~~ allowed-Instanz ~~definiert~~, ~~sind~~ Zugriffe auf FHEM ~~nur innerhalb~~ desselben Netzwerks ~~möglich.~~		Daher ist es erforderlich, eine allowed-Instanz zu definieren, um
			* Zugriffe auf FHEM aus anderen Netzwerken zu ermöglichen und/oder
	~~Zusätzlich kann für FHEMWEB mithilfe des Attributes {{Link2CmdRef\|Anker=HTTPS\|Lang=de\|Label=HTTPS}} eine HTTPS-Verbindung aktiviert werden. Für telnet (welches mehr~~ oder ~~weniger ein TCP/IP Port ist) wird das Attribut {{Link2CmdRef\|Anker=SSL\|Lang=de\|Label=SSL}} verwendet~~.		* die Möglichkeiten, auf FHEM zuzugreifen für Teilnehmer desselben Netzwerks einzuschränken oder auszuschließen.

	== Syntax ==		== Syntax ==
Zeile 24:		Zeile 27:
	==Weitere Hinweise==		==Weitere Hinweise==
	Sofern FHEM nicht nur aus dem lokalen Netz erreichbar sein soll, sollten neben der Definition einer oder mehrerer allowed-Instanzen zusätzliche Sicherheitsmaßnahmen ergriffen werden. Mögliche Optionen dafür sind die Verwendung eines VPNs (Virtual Private Network) und/oder eines Reverse-Proxy-Servers mit z.B. [[Apache_Authentication_Proxy\|Apache]] oder [[HTTPS-Absicherung_%26_Authentifizierung_via_nginx_Webserver\|nginx]].		Sofern FHEM nicht nur aus dem lokalen Netz erreichbar sein soll, sollten neben der Definition einer oder mehrerer allowed-Instanzen zusätzliche Sicherheitsmaßnahmen ergriffen werden. Mögliche Optionen dafür sind die Verwendung eines VPNs (Virtual Private Network) und/oder eines Reverse-Proxy-Servers mit z.B. [[Apache_Authentication_Proxy\|Apache]] oder [[HTTPS-Absicherung_%26_Authentifizierung_via_nginx_Webserver\|nginx]].
			Zusätzlich kann für FHEMWEB mithilfe des Attributes {{Link2CmdRef\|Anker=HTTPS\|Lang=de\|Label=HTTPS}} eine HTTPS-Verbindung aktiviert werden. Für telnet (welches mehr oder weniger ein TCP/IP Port ist) wird das Attribut {{Link2CmdRef\|Anker=SSL\|Lang=de\|Label=SSL}} verwendet.


Zeile 39:		Zeile 43:
	attr allowedTelnet password secret		attr allowedTelnet password secret
	== Links ==		== Links ==

	~~[[Kategorie:]]~~

Beta-User: Erste Rohfassung - needs editing...

2018-03-12T17:08:04Z

Erste Rohfassung - needs editing...

Neue Seite

{{Baustelle}}
{{SEITENTITEL:allowed}} 
{{Infobox Modul
|ModPurpose=Absicherung des FHEM-Servers
|ModType=d
|ModCmdRef=allowed
|ModForumArea=Automatisierung
|ModTechName=96_allowed.pm
|ModOwner=rudolfkoenig ([http://forum.fhem.de/index.php?action=profile;u=8 Forum] / [[Benutzer Diskussion:rudolfkoenig|Wiki]])
}}

In der Grundkonfiguration kann jeder, der sich in dem selben Netzwerk wie der FHEM-Server befindet, unverschlüsselt und ohne der Eingabe von Benutzerdaten auf FHEM zugreifen. FHEM weist mit einer Sicherheitswarnung auf diesen Umstand hin.
Das Definieren einer allowed-Instanz ist eine Möglichkeit, die Installation abzusichern.

Ist keine allowed-Instanz definiert, sind Zugriffe auf FHEM nur innerhalb desselben Netzwerks möglich.

Zusätzlich kann für FHEMWEB mithilfe des Attributes {{Link2CmdRef|Anker=HTTPS|Lang=de|Label=HTTPS}} eine HTTPS-Verbindung aktiviert werden. Für telnet (welches mehr oder weniger ein TCP/IP Port ist) wird das Attribut {{Link2CmdRef|Anker=SSL|Lang=de|Label=SSL}} verwendet.

== Syntax ==
Ein allowed-Device für ein- oder mehrere FHEMWEB oder telnet-Instanzen wird wie folgt definiert:

define <name> allowed <deviceList>

==Weitere Hinweise==
Sofern FHEM nicht nur aus dem lokalen Netz erreichbar sein soll, sollten neben der Definition einer oder mehrerer allowed-Instanzen zusätzliche Sicherheitsmaßnahmen ergriffen werden. Mögliche Optionen dafür sind die Verwendung eines VPNs (Virtual Private Network) und/oder eines Reverse-Proxy-Servers mit z.B. [[Apache_Authentication_Proxy|Apache]] oder [[HTTPS-Absicherung_%26_Authentifizierung_via_nginx_Webserver|nginx]].

== Einschränkungen ==

== Beispiele ==
Festlegen eines Users samt Passwort für gängige FHEMWEB-Instanzen:
define allowedWEB allowed
attr allowedWEB validFor WEB,WEBphone,WEBtablet
attr allowedWEB basicAuth { "$user:$password" eq "admin:secret" }
attr allowedWEB allowedCommands set,get
Dasselbe für Telnet:
define allowedTelnet allowed
attr allowedTelnet validFor telnetPort
attr allowedTelnet password secret
== Links ==

[[Kategorie:]]