Erste Schritte
Setup-Checkliste
Bitte diese Schritte in Reihenfolge durchführen. Jeder Schritt hat ein Erwartetes Ergebnis, damit du das Setup verifizieren kannst (wichtig für App-Store Review).
0) Voraussetzungen
- iPhone und Agent müssen
https://apn.no-logs.de erreichen können.
- Das Agent Web UI muss vom iPhone-Browser erreichbar sein.
Hinweis: Wenn Hostnames im Container nicht auflösbar sind (z.B. manche .local Setups), nutze eine IP-Adresse oder einen DNS-Namen, der im Container auflösbar ist.
1) TrueNAS API-Key erstellen
- In der TrueNAS UI einen API-Key erstellen.
- API-Key kopieren und sicher aufbewahren.
Erwartetes Ergebnis: Du hast einen TrueNAS API-Key, den du gleich in der iOS App einfügst.
2) Server-Profil in der iOS App anlegen
- NAS Guard auf iOS öffnen.
- Server-Profil mit TrueNAS URL und API-Key anlegen.
Erwartetes Ergebnis: Das Server-Profil ist gespeichert und auswählbar.
3) Agent installieren (TrueNAS SCALE Custom App YAML)
- Agent über TrueNAS Edit App YAML installieren/aktualisieren.
- Siehe Copy/Paste Anleitung: Agent installieren (TrueNAS SCALE).
Erwartetes Ergebnis: App-Status ist Running und das Agent Web UI lässt sich im Browser öffnen.
4) Pairing-Code in iOS erzeugen
- In NAS Guard iOS dein Server-Profil öffnen.
- Agent Pairing-Code erzeugen.
Erwartetes Ergebnis: Die iOS App zeigt einen Pairing-Code und eine Ablaufzeit.
5) Pairing-Code im Agent Web UI eingeben
- Agent Web UI im Browser öffnen.
- Pairing-Code eingeben und Pair drücken.
- iOS App kurz geöffnet lassen, damit sie die TrueNAS-Konfiguration hochladen kann.
Erwartetes Ergebnis: Der Agent zeigt „paired“ und startet die Verbindung zu TrueNAS.
6) TLS / Zertifikat-Pinning (TOFU)
Wenn dein TrueNAS ein selbstsigniertes Zertifikat nutzt, kann der Agent den Zertifikat-Fingerprint "pinnen" (Trust On First Use). Siehe TLS / Zertifikat-Pin.