läuft...

README.md

@@ -0,0 +1,129 @@
+# ING Kontostandsabfrage für ioBroker
+
+## Zweck
+
+Dieses Python-Skript ruft den aktuellen Kontostand eines ING-Kontos per FinTS ab und schreibt den Wert automatisch in einen ioBroker-Datenpunkt über die Simple-API.
+
+## Systemumgebung
+
+- Betriebssystem: Debian Linux
+- Benutzer: `banking`
+- Ausführungsort: VM `Applikationen`
+- Bank: ING Deutschland
+- Übertragung: HTTP Simple-API an ioBroker
+
+## Verzeichnisstruktur
+
+```text
+/home/banking/
+├── .ing.conf
+├── bin/
+│   └── balance.py
+└── logs/
+    └── balance.log
+```
+
+## Konfigurationsdatei
+
+Datei:
+
+```text
+/home/banking/.ing.conf
+```
+
+Inhalt:
+
+```ini
+# ING
+ING_USER=1234567890
+ING_PIN=geheimepin
+ING_IBAN=DE00123456789012345678
+
+# ioBroker
+IOBROKER_HOST=10.0.1.122
+IOBROKER_PORT=8087
+IOBROKER_DP=javascript.0.Finanzen.ING.Kontostand
+```
+
+## Berechtigungen
+
+```bash
+chmod 700 /home/banking
+chmod 700 /home/banking/bin
+chmod 700 /home/banking/bin/balance.py
+chmod 700 /home/banking/logs
+chmod 600 /home/banking/.ing.conf
+```
+
+## Installation
+
+Python-Abhängigkeit installieren:
+
+```bash
+python3 -m pip install --user --break-system-packages fints
+```
+
+Prüfen:
+
+```bash
+python3 -c "from fints.client import FinTS3PinTanClient; print('OK')"
+```
+
+## Manuelle Ausführung
+
+```bash
+python3 /home/banking/bin/balance.py
+```
+
+Bei erfolgreicher Ausführung erfolgt keine Konsolenausgabe.
+
+Der aktuelle Kontostand wird direkt in den konfigurierten ioBroker-Datenpunkt geschrieben.
+
+## Logging
+
+Fehler werden protokolliert in:
+
+```text
+/home/banking/logs/balance.log
+```
+
+Logdatei anzeigen:
+
+```bash
+tail -f /home/banking/logs/balance.log
+```
+
+## Cronjob
+
+Ausführung Montag bis Samstag alle 4 Stunden:
+
+```cron
+0 */4 * * 1-6 /usr/bin/python3 /home/banking/bin/balance.py
+```
+
+Cronjob bearbeiten:
+
+```bash
+crontab -e
+```
+
+Cronjobs anzeigen:
+
+```bash
+crontab -l
+```
+
+## Sicherheit
+
+- Zugangsdaten werden nicht im Skript gespeichert.
+- Die Konfiguration liegt ausschließlich in `/home/banking/.ing.conf`.
+- Die Datei ist nur für den Benutzer `banking` lesbar.
+- Die ING-Zugangsdaten werden nicht auf dem ioBroker-System gespeichert.
+- Die Kommunikation erfolgt ausschließlich zwischen der VM `Applikationen`, der ING und dem lokalen ioBroker-Server.
+
+## Hinweise
+
+- Für die ING wird FinTS verwendet.
+- FinTS-Server: `https://fints.ing.de/fints/`
+- Der ioBroker-Datenpunkt sollte vom Typ `number` sein.
+- Die ING kann aufgrund regulatorischer Vorgaben eine regelmäßige Anmeldung im normalen Online-Banking verlangen.