PKR-Lab

018 iOS-App: Klartext-HTTP mit Bearer-Token zu `carplay-api` und WoL-Agent, ATS-Ausnahme für `homeserver`

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/7-security-incidents/018-ios-app-klartext-http-mit-bearer-token.md

018 iOS-App: Klartext-HTTP mit Bearer-Token zu carplay-api und WoL-Agent, ATS-Ausnahme für homeserver

Beschreibung

Die App spricht http://carplay-api.prod.homeserver und http://100.123.214.4:9102 an und deaktiviert dafür die App Transport Security für die Domain homeserver (NSExceptionAllowsInsecureHTTPLoads: true, inklusive Subdomains). Das Bearer-Token von carplay-api (Zugriff auf Dashboard, Wake/Shutdown der Worker) und das WoL-Agent-Token laufen damit im Klartext. Über Tailscale sind sie durch WireGuard geschützt, im Heim-WLAN nicht. Die Klasse MTLSDelegate führt trotz des Namens nur performDefaultHandling aus: kein Client-Zertifikat, kein Pinning. Positiv: Tokens liegen im Keychain mit kSecAttrAccessibleWhenUnlockedThisDeviceOnly.

Nachweis

$ sed -n 33,37p capulus-ios/project.yml
        NSAppTransportSecurity:
          NSExceptionDomains:
            homeserver:
              NSIncludesSubdomains: true
              NSExceptionAllowsInsecureHTTPLoads: true

$ grep -n 'URL(string' capulus-ios/HomeserverDashboard/Utilities/Constants.swift
4:    static let apiBaseURL = URL(string: "http://carplay-api.prod.homeserver")!
6:    static let wolAgentBaseURL = URL(string: "http://100.123.214.4:9102")!

Risiko / Angriffsszenario

Ein Angreifer im selben WLAN schneidet das Bearer-Token mit und kann damit Dashboard-Daten lesen und Worker abschalten oder aufwecken. Ohne Zertifikats-Pinning würde auch ein MITM mit fremder CA nur dann auffallen, wenn die Systemprüfung aktiv ist.

Empfohlene Behebung

  1. carplay-api.prod.homeserver in die SAN-Liste des internen Zertifikats aufnehmen (cert-manager, siehe capulus-core/d-sicherheit/d0040-internal-tls.md), Ingress mit TLS-Eintrag versehen.
  2. Constants.swift auf https://… umstellen, den WoL-Agent ebenfalls hinter HTTPS legen.
  3. Die ATS-Ausnahme aus project.yml entfernen, Root-CA als Konfigurationsprofil auf dem iPhone installieren.
  4. Optional Pinning auf die Root-CA im URLSessionDelegate (SecTrustSetAnchorCertificates).

Rollback

ATS-Ausnahme und die HTTP-URLs wiederherstellen, App neu bauen.

Verifikation

curl -sI --cacert homeserver-root-ca.pem https://carplay-api.prod.homeserver/health
curl -sI http://carplay-api.prod.homeserver/health

HTTPS liefert 200, HTTP wird abgewiesen bzw. umgeleitet. In der App Dashboard laden und eine Aktion auslösen; im Charles/mitmproxy-Test darf kein Klartext-Token sichtbar sein.

Risiko der Behebung

Mittel: Die App funktioniert erst wieder, wenn die interne Root-CA auf dem iPhone installiert und der Hostname im Zertifikat enthalten ist.

Nachtrag zu 011 (2026-10-17)

Bei der Umstellung des power-agent kam von der App keine einzige Anfrage bei carplay-api an (weder Dashboard-Abruf noch Helligkeit). Die App spricht http://carplay-api.prod.homeserver an, der Traefik leitet HTTP seit 2026-09-13 global per 301/308 auf HTTPS um (curl http://carplay-api.prod.homeserver/health liefert 301, ein PUT 308). Ob die App dem Redirect folgen kann, hängt davon ab, ob das iPhone der internen Root-CA vertraut. Die Anfragen, die carplay-api protokolliert, kamen nur von den Health-Checks des kubelet und von Testaufrufen. Das spricht dafür, dass die App seit der Umleitung nicht mehr mit carplay-api spricht. Zu prüfen: Zeigt die App einen Verbindungsfehler? Die Behebung dieses Incidents (HTTPS mit passendem Zertifikat, Root-CA auf dem iPhone) löst auch das.

Behebung (2026-10-18)

Fix.

Nachweis.

Test Ergebnis
curl --cacert pki/homeserver-root-ca.pem https://carplay-api.prod.homeserver/health 200, ssl_verify_result=0
curl http://carplay-api.prod.homeserver/health 301 nach https://…
Zertifikat SAN enthält carplay-api.prod.homeserver, Aussteller Homeserver Root CA, gültig bis 2027-01-09 (cert-manager erneuert)
Kurzlink-Dienste (nextcloud, immich, vault, paperless, n8n, wiki, zammad) per HTTPS mit Root-CA alle 200 oder 302, Prüfung bestanden
grep -rn 'http://' ios --include=*.swift nur noch wolAgentBaseURL
grep -n NSAppTransportSecurity capulus-ios/project.yml leer, YAML parst, Info.plist-Eigenschaften unverändert bis auf den entfernten Block
carplay-api nach der Änderung Pod 1/1 Running, /health 200, keine neuen Fehler im Log (keine Cluster-Änderung)
WoL-Agent: Zertifikat openssl verify -CAfile pki/homeserver-root-ca.pem -verify_ip 100.123.214.4 OK, Aussteller Homeserver Root CA, SAN nur IP:100.123.214.4, Server-EKU
WoL-Agent live (https://100.123.214.4:9102/wol mit Root-CA) ohne Token 401, mit falschem Token 401, Klartext-HTTP abgewiesen (Verbindung ohne Antwort), TLS 1.3 mit Verification: OK
Lokaler Test mit Wegwerf-CA 401/400/200, Klartext auf TLS-Port abgewiesen, hängender Client blockiert nichts, TLS 1.2 und 1.3 gehen, TLS 1.1 nicht, ohne TLS_CERT weiter HTTP
Pi nach der Umschaltung Agent active, NRestarts=0, lauscht nur auf 100.123.214.4:9102, Kiosk (Chromium-Prozess unverändert), Heartbeat und getty aktiv, systemctl --failed leer

Geänderte Dateien.

Rollback. WoL-Agent: banana_pi_kiosk_wol_agent_tls_enabled: false und Rollenlauf, oder von Hand in /etc/banana-pi-wol-agent/config.env die Zeilen TLS_CERT und TLS_KEY entfernen und systemctl restart banana-pi-wol-agent (der Agent spricht dann wieder HTTP; die Sicherungskopien vom 2026-10-18 sind nach der Prüfung gelöscht). App: Die zwei Swift-Dateien auf http:// zurücksetzen, den ATS-Block aus dem Abschnitt „Nachweis“ oben in project.yml wiederherstellen, cd ios && xcodegen generate, App neu bauen. Auf dem Server gibt es nichts zurückzunehmen. Die Rückkehr zu http:// hilft nicht gegen einen Zertifikatsfehler, denn Traefik leitet auf HTTPS um.

Offen.

Nachtrag: Pinning (2026-10-18)

Auf Wunsch umgesetzt (Punkt 4 der Empfehlung): MTLSDelegate prüft Hosts auf .homeserver und 100.123.214.4 nur gegen die eingebettete Root-CA (SecTrustSetAnchorCertificates plus SecTrustSetAnchorCertificatesOnly), project.yml bindet pki/homeserver-root-ca.pem als Resource ins Bundle ein. Andere Hosts bleiben bei der Systemprüfung. Fehlt die Datei im Bundle, scheitern die gepinnten Anfragen (fail closed).

Nachweis. swiftc -parse (Swift 6.0 im Container) meldet keine Syntaxfehler; die Typprüfung und der Lauf sind in dieser Linux-Umgebung nicht möglich (kein Security-Framework).

Du testest: cd ios && xcodegen generate, bauen, starten. Dashboard lädt, Helligkeit, „Aufwecken“. Gegenprobe: auf dem iPhone das CA-Profil entfernen (oder Vertrauen abschalten): die App muss trotzdem laden, Safari zeigt für https://carplay-api.prod.homeserver dann eine Warnung. Schlägt alles fehl, prüfen, ob homeserver-root-ca.pem unter Build Phases → Copy Bundle Resources steht.

Rollback. MTLSDelegate.swift und project.yml per git revert; die App prüft dann wieder gegen den Gerätespeicher.