CsrfToken-HowTo - Versionsgeschichte

ChristophMorrison: Webhook sinnvoll eingebaut

2021-03-27T10:26:36Z

Webhook sinnvoll eingebaut

← Nächstältere Version		Version vom 27. März 2021, 12:26 Uhr
Zeile 4:		Zeile 4:
	Dieser Token wird bei jedem Neustart von FHEM neu gebildet.		Dieser Token wird bei jedem Neustart von FHEM neu gebildet.

	Dieses Feature erhöht die Sicherheit (siehe Links ganz unten), führt aber dazu, dass man nicht mehr (wie in älteren Anleitungen beschrieben), mit einem statischen http Link Steuerbefehle an das [[FHEMWEB]] senden kann.		Dieses Feature erhöht die Sicherheit (siehe Links ganz unten), führt aber dazu, dass man nicht mehr (wie in älteren Anleitungen beschrieben), mit einem statischen http Link Steuerbefehle (auch Webhooks) an das [[FHEMWEB]] senden kann.

	'''Beispiel'''		'''Beispiel'''

Ph1959de: Python Codebeispiel mit syntaxhighlight formatiert

2021-03-11T16:19:49Z

Python Codebeispiel mit syntaxhighlight formatiert

← Nächstältere Version		Version vom 11. März 2021, 18:19 Uhr
Zeile 109:		Zeile 109:
	Falls mal jemand aus python (hier für python 2.7) heraus fhem ansteuern möchte		Falls mal jemand aus python (hier für python 2.7) heraus fhem ansteuern möchte

	<~~nowiki~~>import sys		<syntaxhighlight lang="Python">
	import urllib2		import sys
	import urllib		import urllib2
	import ssl		import urllib
	import urlparse		import ssl
	BASEURL = 'https://user:password@server_ip:8083/fhem?'		import urlparse
	url = BASEURL + 'cmd=set+licht+on'		BASEURL = 'https://user:password@server_ip:8083/fhem?'
	def get_token(url):		url = BASEURL + 'cmd=set+licht+on'
	nurl = urlparse.urlsplit(url)		def get_token(url):
	username = nurl.username		nurl = urlparse.urlsplit(url)
	password = nurl.password		username = nurl.username
	url = url.replace(username + ':' + password + '@', '')		password = nurl.password
	url = url.replace(" ", "%20")		url = url.replace(username + ':' + password + '@', '')
	ssl._create_default_https_context = ssl._create_unverified_context		url = url.replace(" ", "%20")
	p = urllib2.HTTPPasswordMgrWithDefaultRealm()		ssl._create_default_https_context = ssl._create_unverified_context
	p.add_password(None, url, username, password)		p = urllib2.HTTPPasswordMgrWithDefaultRealm()
	handler = urllib2.HTTPBasicAuthHandler(p)		p.add_password(None, url, username, password)
	opener = urllib2.build_opener(handler)		handler = urllib2.HTTPBasicAuthHandler(p)
	urllib2.install_opener(opener)		opener = urllib2.build_opener(handler)
	try:		urllib2.install_opener(opener)
	uu = urllib2.urlopen(		try:
	url=url,		uu = urllib2.urlopen(
	data=None,		url=url,
	timeout=10		data=None,
	)		timeout=10
	token = uu.read()		)
	token = token[token.find('csrf_'):]		token = uu.read()
	token = token[:token.find("\'")]		token = token[token.find('csrf_'):]
	return token		token = token[:token.find("\'")]
	except urllib2.URLError, urllib2.URLError.reason:		return token
	print('URLError: %s' % urllib2.URLError.reason)		except urllib2.URLError, urllib2.URLError.reason:
	return False		print('URLError: %s' % urllib2.URLError.reason)
			return False

	def fire_command(url):		def fire_command(url):
	# type: (object) -> object		# type: (object) -> object
	if "@" in url:		if "@" in url:
	token = get_token(BASEURL)		token = get_token(BASEURL)
	data = {'fwcsrf': token}		data = {'fwcsrf': token}
	data = urllib.urlencode(data)		data = urllib.urlencode(data)
	nurl = urlparse.urlsplit(url)		nurl = urlparse.urlsplit(url)
	username = nurl.username		username = nurl.username
	password = nurl.password		password = nurl.password
	url = url.replace(username + ':' + password + '@', '')		url = url.replace(username + ':' + password + '@', '')
	url = url.replace(" ", "%20")		url = url.replace(" ", "%20")
	ssl._create_default_https_context = ssl._create_unverified_context		ssl._create_default_https_context = ssl._create_unverified_context
	p = urllib2.HTTPPasswordMgrWithDefaultRealm()		p = urllib2.HTTPPasswordMgrWithDefaultRealm()
	p.add_password(None, url, username, password)		p.add_password(None, url, username, password)
	handler = urllib2.HTTPBasicAuthHandler(p)		handler = urllib2.HTTPBasicAuthHandler(p)
	opener = urllib2.build_opener(handler)		opener = urllib2.build_opener(handler)
	urllib2.install_opener(opener)		urllib2.install_opener(opener)
	try:		try:
	urllib2.urlopen(		urllib2.urlopen(
	url=url,		url=url,
	data=data,		data=data,
	timeout=10		timeout=10
	)		)
	except urllib2.URLError, urllib2.URLError.reason:		except urllib2.URLError, urllib2.URLError.reason:
	print('URLError: %s' % urllib2.URLError.reason)		print('URLError: %s' % urllib2.URLError.reason)
	return False</~~nowiki~~>		return False
			</syntaxhighlight>

	==Alternative Konfiguration==		==Alternative Konfiguration==
Zeile 184:		Zeile 185:
	===csrfToken festlegen===		===csrfToken festlegen===
	Dies kann man tun, falls die dynamische Abfrage zur Laufzeit des Tokens nicht möglich ist.		Dies kann man tun, falls die dynamische Abfrage zur Laufzeit des Tokens nicht möglich ist.
			:<code><nowiki>attr WEB.* csrfToken <beliebige Folge aus Zeichen und Zahlen></nowiki></code>
	attr WEB.* csrfToken <beliebige Folge aus Zeichen und Zahlen>

	Damit können feste URLs verwendet werden:		Damit können feste URLs verwendet werden:
			:<code><nowiki>http://localhost:8083/fhem?cmd=set%20Office%20on&fwcsrf=<fester token></nowiki></code>
	<nowiki>http://localhost:8083/fhem?cmd=set%20Office%20on&fwcsrf=<fester token></nowiki>

	===csrfToken abschalten===		===csrfToken abschalten===
	Dies sollte man als erste Hilfe tun, aber unbedingt darüber nachdenken wie man die Applikation umstellt.		Dies sollte man als erste Hilfe tun, aber unbedingt darüber nachdenken wie man die Applikation umstellt.
			:<code>attr WEB.* csrfToken none</code>
	attr WEB.* csrfToken none

	===Featurelevel===		===Featurelevel===
	Eine weitere temporäre Notfallmaßnahme wäre den Featurelevel nach dem Update einfach wieder zurückzudrehen		Eine weitere temporäre Notfallmaßnahme wäre den Featurelevel nach dem Update einfach wieder zurückzudrehen
			:<code>attr global featurelevel 5.7</code>
	attr global featurelevel 5.7

	==Links==		==Links==

Otto123: /* Perl Sub */ Code etwas verbessert

2021-03-11T11:25:23Z

Perl Sub: Code etwas verbessert

← Nächstältere Version		Version vom 11. März 2021, 13:25 Uhr
Zeile 55:		Zeile 55:
	=== Perl Sub ===		=== Perl Sub ===
	Innerhalb von Perl geht die Abfrage eines anderen FHEM Servers natürlich auch:<syntaxhighlight lang="perl">		Innerhalb von Perl geht die Abfrage eines anderen FHEM Servers natürlich auch:<syntaxhighlight lang="perl">
	sub fhemcl~~($$)~~		sub fhemcl
	{		{
	use URI::Escape;		use URI::Escape;
	use LWP::UserAgent;		use LWP::UserAgent;
	my ($hosturl~~,$fhemcmd)~~ = @_;		# if url is empty, localhost and default port is used
			my $fhemcmd = shift // return "Usage: fhemcl('fhem cmd'[,'urlToHost']) - like fhemcl('set Test2 toggle','http://host:8083')\n";
			my $hosturl = shift \|\| 'http://localhost:8083';
	my $token;		my $token;
	# get token		# get token
Zeile 70:		Zeile 72:
	$url = "$hosturl/fhem?cmd=$fhemcmd&fwcsrf=$token&XHR=1";		$url = "$hosturl/fhem?cmd=$fhemcmd&fwcsrf=$token&XHR=1";
	$resp = $ua->get($url)->content;		$resp = $ua->get($url)->content;
	# cut the last character, the additional newline		# cut the last character: the additional newline
	return substr $resp,0,-1		return substr $resp,0,-1
	}		}
	~~# Usage~~
	~~#{fhemcl("http://raspib3:8083","{ReadingsVal('Melder','state','error')}")}~~
	~~#{fhemcl("http://raspib3:8083","set Test2 toggle")}~~
	~~#{fhemcl("http://raspib3:8083","list global")}~~
	</syntaxhighlight>		</syntaxhighlight>

Zeile 112:		Zeile 110:

	<nowiki>import sys		<nowiki>import sys
	import urllib2		import urllib2
	import urllib		import urllib
	import ssl		import ssl
	import urlparse		import urlparse
	BASEURL = 'https://user:password@server_ip:8083/fhem?'		BASEURL = 'https://user:password@server_ip:8083/fhem?'
	url = BASEURL + 'cmd=set+licht+on'		url = BASEURL + 'cmd=set+licht+on'
	def get_token(url):		def get_token(url):
	nurl = urlparse.urlsplit(url)		nurl = urlparse.urlsplit(url)
	username = nurl.username		username = nurl.username
	password = nurl.password		password = nurl.password
	url = url.replace(username + ':' + password + '@', '')		url = url.replace(username + ':' + password + '@', '')
	url = url.replace(" ", "%20")		url = url.replace(" ", "%20")
	ssl._create_default_https_context = ssl._create_unverified_context		ssl._create_default_https_context = ssl._create_unverified_context
	p = urllib2.HTTPPasswordMgrWithDefaultRealm()		p = urllib2.HTTPPasswordMgrWithDefaultRealm()
	p.add_password(None, url, username, password)		p.add_password(None, url, username, password)
	handler = urllib2.HTTPBasicAuthHandler(p)		handler = urllib2.HTTPBasicAuthHandler(p)
	opener = urllib2.build_opener(handler)		opener = urllib2.build_opener(handler)
	urllib2.install_opener(opener)		urllib2.install_opener(opener)
	try:		try:
	uu = urllib2.urlopen(		uu = urllib2.urlopen(
	url=url,		url=url,
	data=None,		data=None,
	timeout=10		timeout=10
	)		)
	token = uu.read()		token = uu.read()
	token = token[token.find('csrf_'):]		token = token[token.find('csrf_'):]
	token = token[:token.find("\'")]		token = token[:token.find("\'")]
	return token		return token
	except urllib2.URLError, urllib2.URLError.reason:		except urllib2.URLError, urllib2.URLError.reason:
	print('URLError: %s' % urllib2.URLError.reason)		print('URLError: %s' % urllib2.URLError.reason)
	return False		return False

	def fire_command(url):		def fire_command(url):
	# type: (object) -> object		# type: (object) -> object
	if "@" in url:		if "@" in url:
	token = get_token(BASEURL)		token = get_token(BASEURL)
	data = {'fwcsrf': token}		data = {'fwcsrf': token}
	data = urllib.urlencode(data)		data = urllib.urlencode(data)
	nurl = urlparse.urlsplit(url)		nurl = urlparse.urlsplit(url)
	username = nurl.username		username = nurl.username
	password = nurl.password		password = nurl.password
	url = url.replace(username + ':' + password + '@', '')		url = url.replace(username + ':' + password + '@', '')
	url = url.replace(" ", "%20")		url = url.replace(" ", "%20")
	ssl._create_default_https_context = ssl._create_unverified_context		ssl._create_default_https_context = ssl._create_unverified_context
	p = urllib2.HTTPPasswordMgrWithDefaultRealm()		p = urllib2.HTTPPasswordMgrWithDefaultRealm()
	p.add_password(None, url, username, password)		p.add_password(None, url, username, password)
	handler = urllib2.HTTPBasicAuthHandler(p)		handler = urllib2.HTTPBasicAuthHandler(p)
	opener = urllib2.build_opener(handler)		opener = urllib2.build_opener(handler)
	urllib2.install_opener(opener)		urllib2.install_opener(opener)
	try:		try:
	urllib2.urlopen(		urllib2.urlopen(
	url=url,		url=url,
	data=data,		data=data,
	timeout=10		timeout=10
	)		)
	except urllib2.URLError, urllib2.URLError.reason:		except urllib2.URLError, urllib2.URLError.reason:
	print('URLError: %s' % urllib2.URLError.reason)		print('URLError: %s' % urllib2.URLError.reason)
	return False</nowiki>		return False</nowiki>

Otto123: /* Codebeispiele */ Perl Sub ergänzt

2020-04-13T17:15:24Z

Codebeispiele: Perl Sub ergänzt

← Nächstältere Version		Version vom 13. April 2020, 19:15 Uhr
Zeile 51:		Zeile 51:
	Beispiel (funktioniert auch in der FHEM Kommandozeile)		Beispiel (funktioniert auch in der FHEM Kommandozeile)
	:<syntaxhighlight lang="perl">{my $button_test = "<a href='http://localhost:8083/fhem?cmd=set%20Office%20on$FW_CSRF'>test</a>"}		:<syntaxhighlight lang="perl">{my $button_test = "<a href='http://localhost:8083/fhem?cmd=set%20Office%20on$FW_CSRF'>test</a>"}
			</syntaxhighlight>

			=== Perl Sub ===
			Innerhalb von Perl geht die Abfrage eines anderen FHEM Servers natürlich auch:<syntaxhighlight lang="perl">
			sub fhemcl($$)
			{
			use URI::Escape;
			use LWP::UserAgent;
			my ($hosturl,$fhemcmd) = @_;
			my $token;
			# get token
			my $ua = new LWP::UserAgent;
			my $url = "$hosturl/fhem?XHR=1/";
			my $resp = $ua->get($url);
			$token = $resp->header('X-FHEM-CsrfToken');
			# url encode the cmd
			$fhemcmd = uri_escape($fhemcmd);
			$url = "$hosturl/fhem?cmd=$fhemcmd&fwcsrf=$token&XHR=1";
			$resp = $ua->get($url)->content;
			# cut the last character, the additional newline
			return substr $resp,0,-1
			}
			# Usage
			#{fhemcl("http://raspib3:8083","{ReadingsVal('Melder','state','error')}")}
			#{fhemcl("http://raspib3:8083","set Test2 toggle")}
			#{fhemcl("http://raspib3:8083","list global")}
	</syntaxhighlight>		</syntaxhighlight>

Zeile 86:		Zeile 112:

	<nowiki>import sys		<nowiki>import sys
	import urllib2		import urllib2
	import urllib		import urllib
	import ssl		import ssl
	import urlparse		import urlparse
	BASEURL = 'https://user:password@server_ip:8083/fhem?'		BASEURL = 'https://user:password@server_ip:8083/fhem?'
	url = BASEURL + 'cmd=set+licht+on'		url = BASEURL + 'cmd=set+licht+on'
	def get_token(url):		def get_token(url):
	nurl = urlparse.urlsplit(url)		nurl = urlparse.urlsplit(url)
	username = nurl.username		username = nurl.username
	password = nurl.password		password = nurl.password
	url = url.replace(username + ':' + password + '@', '')		url = url.replace(username + ':' + password + '@', '')
	url = url.replace(" ", "%20")		url = url.replace(" ", "%20")
	ssl._create_default_https_context = ssl._create_unverified_context		ssl._create_default_https_context = ssl._create_unverified_context
	p = urllib2.HTTPPasswordMgrWithDefaultRealm()		p = urllib2.HTTPPasswordMgrWithDefaultRealm()
	p.add_password(None, url, username, password)		p.add_password(None, url, username, password)
	handler = urllib2.HTTPBasicAuthHandler(p)		handler = urllib2.HTTPBasicAuthHandler(p)
	opener = urllib2.build_opener(handler)		opener = urllib2.build_opener(handler)
	urllib2.install_opener(opener)		urllib2.install_opener(opener)
	try:		try:
	uu = urllib2.urlopen(		uu = urllib2.urlopen(
	url=url,		url=url,
	data=None,		data=None,
	timeout=10		timeout=10
	)		)
	token = uu.read()		token = uu.read()
	token = token[token.find('csrf_'):]		token = token[token.find('csrf_'):]
	token = token[:token.find("\'")]		token = token[:token.find("\'")]
	return token		return token
	except urllib2.URLError, urllib2.URLError.reason:		except urllib2.URLError, urllib2.URLError.reason:
	print('URLError: %s' % urllib2.URLError.reason)		print('URLError: %s' % urllib2.URLError.reason)
	return False		return False

	def fire_command(url):		def fire_command(url):
	# type: (object) -> object		# type: (object) -> object
	if "@" in url:		if "@" in url:
	token = get_token(BASEURL)		token = get_token(BASEURL)
	data = {'fwcsrf': token}		data = {'fwcsrf': token}
	data = urllib.urlencode(data)		data = urllib.urlencode(data)
	nurl = urlparse.urlsplit(url)		nurl = urlparse.urlsplit(url)
	username = nurl.username		username = nurl.username
	password = nurl.password		password = nurl.password
	url = url.replace(username + ':' + password + '@', '')		url = url.replace(username + ':' + password + '@', '')
	url = url.replace(" ", "%20")		url = url.replace(" ", "%20")
	ssl._create_default_https_context = ssl._create_unverified_context		ssl._create_default_https_context = ssl._create_unverified_context
	p = urllib2.HTTPPasswordMgrWithDefaultRealm()		p = urllib2.HTTPPasswordMgrWithDefaultRealm()
	p.add_password(None, url, username, password)		p.add_password(None, url, username, password)
	handler = urllib2.HTTPBasicAuthHandler(p)		handler = urllib2.HTTPBasicAuthHandler(p)
	opener = urllib2.build_opener(handler)		opener = urllib2.build_opener(handler)
	urllib2.install_opener(opener)		urllib2.install_opener(opener)
	try:		try:
	urllib2.urlopen(		urllib2.urlopen(
	url=url,		url=url,
	data=data,		data=data,
	timeout=10		timeout=10
	)		)
	except urllib2.URLError, urllib2.URLError.reason:		except urllib2.URLError, urllib2.URLError.reason:
	print('URLError: %s' % urllib2.URLError.reason)		print('URLError: %s' % urllib2.URLError.reason)
	return False</nowiki>		return False</nowiki>

Otto123: /* Einzeiler Shell */ Beispiele überarbeitet, Beispiel mit wget hinzugefügt

2020-01-14T13:04:02Z

Einzeiler Shell: Beispiele überarbeitet, Beispiel mit wget hinzugefügt

← Nächstältere Version		Version vom 14. Januar 2020, 15:04 Uhr
Zeile 21:		Zeile 21:
	===Einzeiler Shell===		===Einzeiler Shell===

	~~Mit diesem Code~~		Entweder mit curl oder wget

	:<syntaxhighlight lang="bash">curl -s -D - 'http://localhost:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}'</syntaxhighlight>		:<syntaxhighlight lang="bash">curl -s -D - 'http://localhost:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}'
			wget -qO - --server-response 'http://localhost:8083/fhem?XHR=1' 2>&1 \| awk '/X-FHEM-csrfToken/{print $2}'</syntaxhighlight>

	kann man den ~~aktuellle~~ csrfToken aus dem Header extrahieren und muss ihn nur noch an den Aufruf anhängen.		kann man den aktuellen csrfToken aus dem Header extrahieren und muss ihn nur noch an den Aufruf anhängen.

	Erste ~~(Vorzugs)~~ Variante:		Erste Variante mit curl:

	:<syntaxhighlight lang="bash">curl --data "fwcsrf=$(curl -s -D - 'http://localhost:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}')" http://localhost:8083/fhem?cmd=set%20Office%20on</syntaxhighlight>		:<syntaxhighlight lang="bash">curl --data "fwcsrf=$(curl -s -D - 'http://localhost:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}')" http://localhost:8083/fhem?cmd=set%20Office%20on</syntaxhighlight>

	Oder mit mehr Komfort: Nur Einmal die Angabe des Hostnamen und den FHEM Befehl normal mit Leerzeichen angeben:		Oder mit mehr Komfort (eigentlich ein Mehrzeiler): Nur Einmal die Angabe des Hostnamen und den FHEM Befehl normal mit Leerzeichen angeben:
	:<syntaxhighlight lang="bash">h='Name oder IP:PortNr'; c='FHEM Befehl'; curl --data "fwcsrf=$(curl -s -D - http://$h/fhem?XHR=1 \| awk '/X-FHEM-csrfToken/{print $2}')" http://$h/fhem?cmd=$(echo $c\|sed 's/ /%20/g')</syntaxhighlight>		:<syntaxhighlight lang="bash">h='Name oder IP:PortNr'; c='FHEM Befehl'; curl --data "fwcsrf=$(curl -s -D - http://$h/fhem?XHR=1 \| awk '/X-FHEM-csrfToken/{print $2}')" http://$h/fhem?cmd=$(echo $c\|sed 's/ /%20/g')</syntaxhighlight>

	~~Zweite Variante, in dieser~~ wird cr+lf am Ende ~~des ermittelten csrfTokens abgeschnitten~~:		Ein übersichtlicher Mehrzeiler mit wget. Als Beispiel wird vom localhost:8083 ein "list global" ohne HTML ausgegeben:

			:<syntaxhighlight lang="bash">hosturl="http://localhost:8083"
			cmd=list%20global
			token=$(wget -qO - --server-response "$hosturl/fhem?XHR=1" 2>&1 \| awk '/X-FHEM-csrfToken/{print $2}')
			wget -q -O - "$hosturl/fhem?cmd=$cmd&fwcsrf=$token&XHR=1"</syntaxhighlight>

			Man kann auch noch den token vom cr+lf am Ende befreien:

	:<syntaxhighlight lang="bash">curl "http://fhem.example.org:8083/fhem?cmd=set%20Office%20on&XHR=1&fwcsrf="`curl -s -D - 'http://fhem.example.org:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}' \| tr -d "\r\n"`</syntaxhighlight>		:<syntaxhighlight lang="bash">curl "http://fhem.example.org:8083/fhem?cmd=set%20Office%20on&XHR=1&fwcsrf="`curl -s -D - 'http://fhem.example.org:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}' \| tr -d "\r\n"`</syntaxhighlight>

Otto123: Einleitung geändert und erweitert. Struktur geändert.

2019-10-24T13:25:49Z

Einleitung geändert und erweitert. Struktur geändert.

@@ Zeile 1: / Zeile 1: @@
 {{SEITENTITEL:csrfToken-HowTo}}
 FHEM hat mit der Version 5.8 eine Sicherheitsmaßnahme scharfgeschaltet, den csrfToken.
 Dieser Token wird bei jedem Neustart von FHEM neu gebildet.
-Dieses Feature erhöht die Sicherheit, führt aber dazu, dass man nicht mehr mit einem einfachen http Link auf das [[FHEMWEB]] zugreifen kann.
+Dieses Feature erhöht die Sicherheit (siehe Links ganz unten), führt aber dazu, dass man nicht mehr (wie in älteren Anleitungen beschrieben), mit einem statischen http Link Steuerbefehle an das [[FHEMWEB]] senden kann.
-==Einzeiler==
+'''Beispiel'''
-Was früher so ging:
+Schalte den "Schalter" Office auf on. Das ging früher ohne CsrfToken einfach durch diesen HTML String - egal ob im Browser, in Windows, auf dem Mac, auf der Kommandozeile mit wget usw.
-:<syntaxhighlight lang="html">http://localhost:8083/fhem?cmd=set%20Office%20on</syntaxhighlight>
+Soll ein http: Link zum Steuern von FHEM verwendet werden, gibt es folgende Lösungsansätze:
-muss jetzt etwas ergänzt werden. Mit dem Einzeiler
+Mit diesem Code
 :<syntaxhighlight lang="bash">curl -s -D - 'http://localhost:8083/fhem?XHR=1' | awk '/X-FHEM-csrfToken/{print $2}'</syntaxhighlight>
@@ Zeile 29: / Zeile 38: @@
 :<syntaxhighlight lang="bash">curl "http://fhem.example.org:8083/fhem?cmd=set%20Office%20on&XHR=1&fwcsrf="`curl -s -D - 'http://fhem.example.org:8083/fhem?XHR=1' | awk '/X-FHEM-csrfToken/{print $2}' | tr -d "\r\n"`</syntaxhighlight>
-==Innerhalb FHEM mit Perl==
+===Innerhalb FHEM mit Perl===
 FHEM kennt natürlich seinen Token und man hat einfachen Zugriff mit der Variable $FW_CSRF. Diese Varibale enthält nicht den Token an sich, sondern den kompletten String zum Anhängen an eine URL in der Form: &fwcsrf=csrf_387849633005507
@@ Zeile 36: / Zeile 45: @@
 </syntaxhighlight>
-==Raw Import in der Shell==
+===Raw Import in der Shell===
 Will man ganze Definitionsblöcke von der System Kommandozeile importieren, kann man dieses Script verwenden. Im übergebenen Dateinamen sind Zeilenweise die FHEM Befehle gespeichert. Bei Bedarf kann man auch einen anderen Hostnamen und ein anderes Port angeben. Der Token wird zu Beginn ermittelt. Die Leerzeichen werden für HTTP durch %20 ersetzt.
 :<syntaxhighlight lang="bash">
@@ Zeile 65: / Zeile 74: @@
 </syntaxhighlight>
-==API Web==
+===Python===
 Falls mal jemand aus python (hier für python 2.7) heraus fhem ansteuern möchte
@@ Zeile 157: / Zeile 136: @@
              print('URLError: %s' % urllib2.URLError.reason)
              return False</nowiki>
 ==Links==

Otto123: Abschnitt FHEM Perl eingebaut

2019-04-11T13:40:03Z

Abschnitt FHEM Perl eingebaut

← Nächstältere Version		Version vom 11. April 2019, 15:40 Uhr
Zeile 29:		Zeile 29:
	:<syntaxhighlight lang="bash">curl "http://fhem.example.org:8083/fhem?cmd=set%20Office%20on&XHR=1&fwcsrf="`curl -s -D - 'http://fhem.example.org:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}' \| tr -d "\r\n"`</syntaxhighlight>		:<syntaxhighlight lang="bash">curl "http://fhem.example.org:8083/fhem?cmd=set%20Office%20on&XHR=1&fwcsrf="`curl -s -D - 'http://fhem.example.org:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}' \| tr -d "\r\n"`</syntaxhighlight>

			==Innerhalb FHEM mit Perl==
			FHEM kennt natürlich seinen Token und man hat einfachen Zugriff mit der Variable $FW_CSRF. Diese Varibale enthält nicht den Token an sich, sondern den kompletten String zum Anhängen an eine URL in der Form: &fwcsrf=csrf_387849633005507

			Beispiel (funktioniert auch in der FHEM Kommandozeile)
			:<syntaxhighlight lang="perl">{my $button_test = "<a href='http://localhost:8083/fhem?cmd=set%20Office%20on$FW_CSRF'>test</a>"}
			</syntaxhighlight>

	==Raw Import in der Shell==		==Raw Import in der Shell==

Otto123: Script für "Raw Import" eingefügt

2018-12-14T19:04:45Z

Script für "Raw Import" eingefügt

@@ Zeile 30: / Zeile 30: @@
-Man kann auch in Scripten den token zunächst abspeichern:
+==Raw Import in der Shell==
-:<syntaxhighlight lang="bash">token=$(curl -s -D - 'http://localhost:8083/fhem?XHR=1' | awk '/X-FHEM-csrfToken/{print $2}')
+if [ -z $2 ] ; then
- curl --data "fwcsrf=$token" http://localhost:8083/fhem?cmd=set%20Office%20on</syntaxhighlight>
+     fhemhost=localhost
 ==API Web==

Otto123: /* Einzeiler */

2018-07-08T16:28:39Z

Einzeiler

← Nächstältere Version		Version vom 8. Juli 2018, 18:28 Uhr
Zeile 23:		Zeile 23:

	Oder mit mehr Komfort: Nur Einmal die Angabe des Hostnamen und den FHEM Befehl normal mit Leerzeichen angeben:		Oder mit mehr Komfort: Nur Einmal die Angabe des Hostnamen und den FHEM Befehl normal mit Leerzeichen angeben:
	:<syntaxhighlight lang="bash">h='Name oder IP'; c='FHEM Befehl'; curl --data "fwcsrf=$(curl -s -D - http://$h~~:8083~~/fhem?XHR=1 \| awk '/X-FHEM-csrfToken/{print $2}')" http://$h~~:8083~~/fhem?cmd=$(echo $c\|sed 's/ /%20/g')</syntaxhighlight>		:<syntaxhighlight lang="bash">h='Name oder IP:PortNr'; c='FHEM Befehl'; curl --data "fwcsrf=$(curl -s -D - http://$h/fhem?XHR=1 \| awk '/X-FHEM-csrfToken/{print $2}')" http://$h/fhem?cmd=$(echo $c\|sed 's/ /%20/g')</syntaxhighlight>

	Zweite Variante, in dieser wird cr+lf am Ende des ermittelten csrfTokens abgeschnitten:		Zweite Variante, in dieser wird cr+lf am Ende des ermittelten csrfTokens abgeschnitten:

Otto123: /* Einzeiler */ Vorzugsvariante ergänzt und syntaxhighlight eingeführt

2018-07-08T16:26:56Z

Einzeiler: Vorzugsvariante ergänzt und syntaxhighlight eingeführt

← Nächstältere Version		Version vom 8. Juli 2018, 18:26 Uhr
Zeile 9:		Zeile 9:
	Was früher so ging:		Was früher so ging:

	<~~nowiki~~>http://localhost:8083/fhem?cmd=set%20Office%20on</~~nowiki~~>		:<syntaxhighlight lang="html">http://localhost:8083/fhem?cmd=set%20Office%20on</syntaxhighlight>


	muss jetzt etwas ergänzt werden. Mit dem Einzeiler		muss jetzt etwas ergänzt werden. Mit dem Einzeiler

	<~~nowiki~~>curl -s -D - 'http://localhost:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}'</~~nowiki~~>		:<syntaxhighlight lang="bash">curl -s -D - 'http://localhost:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}'</syntaxhighlight>

	kann man den aktuellle csrfToken aus dem Header extrahieren und muss ihn nur noch an den Aufruf anhängen.		kann man den aktuellle csrfToken aus dem Header extrahieren und muss ihn nur noch an den Aufruf anhängen.
Zeile 20:		Zeile 20:
	Erste (Vorzugs) Variante:		Erste (Vorzugs) Variante:

	<~~nowiki~~>curl --data "fwcsrf=$(curl -s -D - 'http://localhost:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}')" http://localhost:8083/fhem?cmd=set%20Office%20on</~~nowiki~~>		:<syntaxhighlight lang="bash">curl --data "fwcsrf=$(curl -s -D - 'http://localhost:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}')" http://localhost:8083/fhem?cmd=set%20Office%20on</syntaxhighlight>

			Oder mit mehr Komfort: Nur Einmal die Angabe des Hostnamen und den FHEM Befehl normal mit Leerzeichen angeben:
			:<syntaxhighlight lang="bash">h='Name oder IP'; c='FHEM Befehl'; curl --data "fwcsrf=$(curl -s -D - http://$h:8083/fhem?XHR=1 \| awk '/X-FHEM-csrfToken/{print $2}')" http://$h:8083/fhem?cmd=$(echo $c\|sed 's/ /%20/g')</syntaxhighlight>

	Zweite Variante, in dieser wird cr+lf am Ende des ermittelten csrfTokens abgeschnitten:		Zweite Variante, in dieser wird cr+lf am Ende des ermittelten csrfTokens abgeschnitten:

	<~~nowiki~~>curl "http://fhem.example.org:8083/fhem?cmd=set%20Office%20on&XHR=1&fwcsrf="`curl -s -D - 'http://fhem.example.org:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}' \| tr -d "\r\n"`</~~nowiki~~>		:<syntaxhighlight lang="bash">curl "http://fhem.example.org:8083/fhem?cmd=set%20Office%20on&XHR=1&fwcsrf="`curl -s -D - 'http://fhem.example.org:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}' \| tr -d "\r\n"`</syntaxhighlight>


	Man kann auch in Scripten den token zunächst abspeichern:		Man kann auch in Scripten den token zunächst abspeichern:

	<~~nowiki~~>token=$(curl -s -D - 'http://localhost:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}')		:<syntaxhighlight lang="bash">token=$(curl -s -D - 'http://localhost:8083/fhem?XHR=1' \| awk '/X-FHEM-csrfToken/{print $2}')
	curl --data "fwcsrf=$token" http://localhost:8083/fhem?cmd=set%20Office%20on</~~nowiki~~>		curl --data "fwcsrf=$token" http://localhost:8083/fhem?cmd=set%20Office%20on</syntaxhighlight>

	==API Web==		==API Web==