PhpIPAM MAC-Adressen per arp ermitteln und hinzufügen - Versionsgeschichte

BLinz: /* Aufruf */

2025-05-19T09:55:55Z

Aufruf

← Nächstältere Version		Version vom 19. Mai 2025, 11:55 Uhr
Zeile 208:		Zeile 208:
	sollte zunächst eine Liste der erreichbaren IP-Adressen ausgeben,<br>		sollte zunächst eine Liste der erreichbaren IP-Adressen ausgeben,<br>
	im Anschluss werden die Adressen zugeordnet:<br>		im Anschluss werden die Adressen zugeordnet:<br>
			[INFO] fping subnet 192.168.128.0/24
			192.168.128.1
			192.168.128.2
			192.168.128.201
			192.168.128.220
			[INFO] Fetching subnet id
			[INFO] Found ip:192.168.128.2 mac:bc:24:11:5b:0f:62
			[INFO] no update required for mac
			[INFO] Found ip:192.168.128.1 mac:bc:24:11:2b:69:83
			[INFO] no update required for mac
			[INFO] Found ip:192.168.128.31 mac:bc:24:11:ff:87:31
			[INFO] Updated id:285 ip:192.168.128.31 mac:bc:24:11:ff:87:31
			[INFO] Found ip:192.168.128.220 mac:bc:24:11:6b:1f:60
			[INFO] no update required for mac
			[INFO] Found interface:vmbr1 ip:192.168.128.201 mac:aa:58:cf:7f:a1:85 index:1/2
			[INFO] address not in phpipam database: 192.168.128.201
			[INFO] Found interface:vmbr1 ip:fe80::f8a3:83ff:fe93:b1b4 mac:aa:58:cf:7f:a1:85 index:2/2
			[INFO] address not in phpipam database: fe80::f8a3:83ff:fe93:b1b4
			[INFO] Script finished!
			<br>
			Jetzt könntet Ihr das Skript regelmäßig als '''cronjob''' laufen lassen.<br>
			<br>
			----
			==Kommentare==
			<comments />

BLinz: /* Das geänderte Skript */

2025-05-19T09:54:27Z

Das geänderte Skript

← Nächstältere Version		Version vom 19. Mai 2025, 11:54 Uhr
Zeile 44:		Zeile 44:
	INVALIDTAGS=("99")		INVALIDTAGS=("99")

	echo "[INFO] fping subnet"		echo "[INFO] fping subnet ${SUBNET}"
	fping -4 -a -q -g ${SUBNET}		fping -4 -a -q -g ${SUBNET}

Zeile 117:		Zeile 117:

	if [ "${mac}" = "<incomplete>" ]; then		if [ "${mac}" = "<incomplete>" ]; then
			# we silently skip these
			continue
			fi

			if [ "${mac}" = "<unvollständig>" ]; then
	# we silently skip these		# we silently skip these
	continue		continue

BLinz: /* Das geänderte Skript */

2025-05-19T09:50:30Z

Das geänderte Skript

← Nächstältere Version		Version vom 19. Mai 2025, 11:50 Uhr
Zeile 18:		Zeile 18:
	----		----

			==Voraussetzungen==
			Folgende Pakete müssen installiert sein:<br>
			apt install fping jq net-tools
			<br>
			----
	==Das geänderte Skript==		==Das geänderte Skript==
	nano phpipam-update-mac-from-arp_V1.1.sh		nano phpipam-update-mac-from-arp_V1.1.sh

BLinz: /* Aufruf */

2025-05-19T09:49:46Z

Aufruf

← Nächstältere Version		Version vom 19. Mai 2025, 11:49 Uhr
Zeile 195:		Zeile 195:
	----		----
	==Aufruf==		==Aufruf==
			./phpipam-update-mac-from-arp_V1.1.sh
			sollte zunächst eine Liste der erreichbaren IP-Adressen ausgeben,<br>
			im Anschluss werden die Adressen zugeordnet:<br>

BLinz: /* Konfiguration */

2025-05-19T09:38:51Z

Konfiguration

← Nächstältere Version		Version vom 19. Mai 2025, 11:38 Uhr
Zeile 194:		Zeile 194:
	<br>		<br>
	----		----
			==Aufruf==

BLinz: /* Das geänderte Skript */

2025-05-19T09:38:32Z

Das geänderte Skript

← Nächstältere Version		Version vom 19. Mai 2025, 11:38 Uhr
Zeile 27:		Zeile 27:
	# Modified 2025-05-19 by Bernhard Linz => https://znil.net/index.php?title=PhpIPAM_MAC-Adressen_per_arp_ermitteln_und_hinzuf%C3%BCgen		# Modified 2025-05-19 by Bernhard Linz => https://znil.net/index.php?title=PhpIPAM_MAC-Adressen_per_arp_ermitteln_und_hinzuf%C3%BCgen
	# Changes V1.1:		# Changes V1.1:
	# - Remove USER and PASSWORD Authentification, use TOKEN instead		# - Remove USER and PASSWORD Authentification, use TOKEN instead (with App security "SSL with App code token")
	# - Add fping before checking MAC-Adresses to fill up ARP-Cache		# - Add fping before checking MAC-Adresses to fill up ARP-Cache
			# - Skip faulty MACs also on german OS withot error message

	URL='https://phpipam.znil.local/api'		URL='https://phpipam.znil.local/api'
	APP='ARP-CronJob'		APP='ARP-CronJob'
	~~#USER='user'~~
	~~#PASS='passwort'~~
	TOKEN='dI4iAJlvuo9z78xlCUt5N4ubmy1FPyoL'		TOKEN='dI4iAJlvuo9z78xlCUt5N4ubmy1FPyoL'

	SUBNET='192.168.0.0/22'		SUBNET='192.168.0.0/22'
	INTERFACE='ens33'		INTERFACE='ens33'
	INVALIDTAGS=("3" "4")		# INVALIDTAGS=("3" "4")
			INVALIDTAGS=("99")
	~~#echo "[INFO] Fetching token"~~
	~~#TOKEN~~=$(~~curl -X POST --user ${USER}:${PASS} ${URL}/${APP}/user/ -s \| jq --raw-output .data.token)~~
	~~#if [~~ "$?" ~~!= "0" ]; then~~
	~~# echo "[FAIL] Error fetching token from PHPIPAM" 1>&2~~
	~~# exit 1~~
	~~#fi~~
	~~#if [ -z "${TOKEN}" ]; then~~
	~~# echo "[FAIL] Didn't receive valid token from PHPIPAM" 1>&2~~
	~~# exit 1~~
	~~#fi~~

	~~#echo "[INFO] Fetching token expiry (token test)"~~
	~~#EXPIRES=$(curl -X GET --header "token: ${TOKEN}" ${URL}/${APP}/user/ -s \| jq --raw-output .data.expires)~~
	~~#if [ "$?" != "0" ]; then~~
	~~# echo "[FAIL] Error fetching token expiry from PHPIPAM" 1>&2~~
	~~# exit 1~~
	~~#fi~~
	~~#if [ -z "${EXPIRES}" ]; then~~
	~~# echo "[FAIL] Didn't receive valid token expiry from PHPIPAM" 1>&2~~
	~~# exit 1~~
	~~#fi~~
	echo "[INFO] fping subnet"		echo "[INFO] fping subnet"
	fping -4 -a -q -g ${SUBNET}		fping -4 -a -q -g ${SUBNET}
Zeile 182:		Zeile 160:
	fi		fi

			echo "[INFO] Script finished!"

	~~#JSON=$(curl -X DELETE --header "token: ${TOKEN}" ${URL}/${APP}/user/ -s)~~
	~~#if [ "$?" != "0" ]; then~~
	# echo "[~~FAIL~~] ~~Error removing token" 1>&2~~
	~~# exit 1~~
	~~#fi~~
	~~#RESULT=$(echo ${JSON} \| jq --raw-output .success)~~
	~~#if [ "${RESULT}"~~ !~~= "true" ]; then~~
	~~# echo "[FAIL] API returned error when attempting to remove token: ${JSON}"~~
	~~# exit 1~~
	~~#fi~~
	~~#echo "[INFO] Removed token~~"
	</source>		</source>
	Und noch ausführbar machen:<br>		Und noch ausführbar machen:<br>

BLinz: /* Konfiguration */

2025-05-19T09:33:21Z

Konfiguration

← Nächstältere Version		Version vom 19. Mai 2025, 11:33 Uhr
Zeile 224:		Zeile 224:
	2: <span style="background:yellow">ens33</span>: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000		2: <span style="background:yellow">ens33</span>: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
	in diesem Fall also {{code\|ens33}}. Da kann auch so etwas wie {{code\|enp1s0}}, {{code\|vmbr0}} oder {{code\|eth0}} stehen.<br>		in diesem Fall also {{code\|ens33}}. Da kann auch so etwas wie {{code\|enp1s0}}, {{code\|vmbr0}} oder {{code\|eth0}} stehen.<br>
	{{code\|INVALIDTAGS=("3" "4")}} sorgt dafür, das er die MAC-Adresse bei Adressen vom Typ '''reserved''' oder '''DHCP''' nicht ändert.<br>		{{code\|<nowiki>INVALIDTAGS=("3" "4")</nowiki>}} sorgt dafür, das er die MAC-Adresse bei Adressen vom Typ '''reserved''' oder '''DHCP''' nicht ändert.<br>
	Wenn Ihr das nicht wollt, tragt da z.B. {{code\|INVALIDTAGS=("99")}} ein.<br>		Wenn Ihr das nicht wollt, tragt da z.B. {{code\|<nowiki>INVALIDTAGS=("99")</nowiki>}} ein.<br>
	<br>		<br>
	----		----

BLinz: /* Das geänderte Skript */

2025-05-19T09:31:24Z

Das geänderte Skript

← Nächstältere Version		Version vom 19. Mai 2025, 11:31 Uhr
Zeile 196:		Zeile 196:
	#echo "[INFO] Removed token"		#echo "[INFO] Removed token"
	</source>		</source>
			Und noch ausführbar machen:<br>
			chmod +x phpipam-update-mac-from-arp_V1.1.sh
	<br>		<br>
	----		----

	==Konfiguration==		==Konfiguration==
	URL='<nowiki>https://phpipam.znil.local/api</nowiki>'		URL='<nowiki>https://phpipam.znil.local/api</nowiki>'

BLinz: /* Konfiguration */

2025-05-19T09:30:49Z

Konfiguration

@@ Zeile 199: / Zeile 199: @@
 ----
 ==Konfiguration==
-  URL='https://phpipam.znil.local/api'
+  URL='<nowiki>https://phpipam.znil.local/api</nowiki>'
   APP='ARP-CronJob'
   TOKEN='dI4iAJlvuo9z78xlCUt5N4ubmy1FPyoL'
@@ Zeile 206: / Zeile 206: @@
   INVALIDTAGS=("3" "4")
 Bei der {{code|URL}} setzt Ihr den Aufruf zu eurer '''phpIPAM''' Installation ein.<br>

BLinz: /* Vorwort */

2025-05-19T08:58:59Z

Vorwort

← Nächstältere Version		Version vom 19. Mai 2025, 10:58 Uhr
Zeile 15:		Zeile 15:
	* Ich lasse vorher einen {{code\|fping}} über den Bereich laufen damit der ARP-Cache auch frisch gefüllt ist.		* Ich lasse vorher einen {{code\|fping}} über den Bereich laufen damit der ARP-Cache auch frisch gefüllt ist.
	<br>		<br>
			{{Hinweis\|<br><br>Das Skript kann natürlich nur MAC-Adressen von Systemen ermitteln die im gleichen IP-Adressbereich liegen wie die das System von dem aus es ausgeführt wird.<br>Das Skript muss aber auch nicht unbedingt auf dem gleichen Host wie '''phpIPAM''' laufen}}
	----		----

	==Das geänderte Skript==		==Das geänderte Skript==
	nano phpipam-update-mac-from-arp_V1.1.sh		nano phpipam-update-mac-from-arp_V1.1.sh