feat(android): Cockpit-App und Android-Agent per MDM ausrollen

Beide Apps lesen ihre Verbindungsdaten aus der App-Konfiguration des MDM
(Android Managed Configuration). Sind host und token gesetzt, verbindet sich
die App ohne QR-Code; die MDM-Werte haben Vorrang vor der Eingabe am Geraet.

- Cockpit (com.ariacockpit): host, token, port, tls; natives Modul
  MdmConfig, gelesen beim Start in rvs.loadConfig()
- Agent (de.hackersoft.ariaagent): zusaetzlich name, control, reply_mode;
  gelesen beim App-Start und nach dem Booten
- README: Abschnitt "Ausrollen per MDM" mit Screenshots unter docs/images/mdm/

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-15 15:59:49 +01:00
co-authored by Claude Opus 5.5
parent 5cb2f71c41
commit 5912e47e32
15 changed files with 300 additions and 2 deletions
+60 -1
View File
@@ -97,7 +97,7 @@ ARIA hat zwei Rollen:
| Compute-Node(s) (STT/TTS/LLM) | 1..n GPU-Rechner | `cd xtts && cp .env.example .env && docker compose up -d` |
| Satellit(en) 🛰️ (optional) | Fremdes Netz (Büro …) | `cd satellite && cp .env.example .env && docker compose up -d --build` |
| Host-Agent(en) 💻 (optional) | Direkt auf einem Rechner | `cd host-agent && ./build.sh` → Binary + `.env` auf den Rechner, starten (Details unten & in [`host-agent/README.md`](host-agent/README.md)) |
| Android-Agent 📱📺 (optional) | Handy, Tablet, Fire TV | `cd host-agent/android && ./build.sh` → APK, oder per Satellit via ADB ausrollen (Details unten) |
| Android-Agent 📱📺 (optional) | Handy, Tablet, Fire TV | `cd host-agent/android && ./build.sh` → APK, oder per Satellit via ADB bzw. per MDM ausrollen (Details unten) |
| Android App | Stefans Handy | APK installieren (Auto-Update via RVS) |
> Compute-Nodes sind optional: ohne sie faellt STT auf lokales Whisper (CPU,
@@ -1267,6 +1267,65 @@ vorgeschlagen; nur wenn es keinen gibt, kommt der automatisch generierte.
---
## Ausrollen per MDM 📲 — Cockpit-App und Android-Agent
Beide Android-Apps lassen sich ueber ein MDM verteilen. Die Zugangsdaten gibt
das MDM als **App-Konfiguration** (Android „Managed Configuration") mit — am
Geraet muss niemand einen QR-Code scannen oder etwas eintippen.
Im MDM pro App den **Paketnamen** eintragen und darunter die Werte als
Schluessel / Typ / Wert:
![MDM: App-Konfiguration mit Paketname, Schluessel, Typ und Wert](docs/images/mdm/mdm-app-konfiguration.png)
Der Typ wird pro Zeile aus *Text*, *Zahl* oder *Ja/Nein* gewaehlt:
![MDM: Auswahl des Typs (Text, Zahl, Ja/Nein)](docs/images/mdm/mdm-typ-auswahl.png)
### Cockpit-App — Paketname `com.ariacockpit`
| Schluessel | Typ | Wert | Pflicht |
|------------|-----|------|---------|
| `host` | Text | RVS-Hostname, z.B. `aria-rvs.example.de` (= `RVS_HOST`) | ja |
| `token` | Text | Pairing-Token (= `RVS_TOKEN`, derselbe wie im QR-Code) | ja |
| `port` | Zahl | `443` (= `RVS_PORT`) | nein, Standard 443 |
| `tls` | Ja/Nein | Ja (= `RVS_TLS`) | nein, Standard Ja |
### Android-Agent — Paketname `de.hackersoft.ariaagent`
| Schluessel | Typ | Wert | Pflicht |
|------------|-----|------|---------|
| `host` | Text | RVS-Hostname (= `RVS_HOST`) | ja |
| `token` | Text | Pairing-Token (= `RVS_TOKEN`) | ja |
| `port` | Zahl | `443` | nein, Standard 443 |
| `tls` | Ja/Nein | Ja | nein, Standard Ja |
| `name` | Text | Geraetename, so erscheint er in der Diagnostic | nein, sonst der Modellname |
| `control` | Ja/Nein | Ja = ARIA darf das Geraet steuern (tippen, wischen, Apps starten) | nein, Standard Nein |
| `reply_mode` | Text | `overlay` (Einblendung) oder `speech` (Sprache) | nein, Standard `overlay` |
### Was dabei passiert
- **Nur mit `host` UND `token`** uebernimmt die App die Werte. Fehlt einer der
beiden, bleibt alles wie bisher (QR-Code bzw. Eingabe am Geraet).
- **Das MDM hat Vorrang.** Eine Aenderung im MDM (z.B. neuer Token) ueberschreibt
die Werte am Geraet. Beim Agenten bleiben nicht gesetzte Schluessel auf ihrem
bisherigen Wert.
- **Wann gelesen wird:** Cockpit beim App-Start, der Agent beim App-Start und
nach einem Neustart des Geraets. Eine Aenderung im MDM greift also erst danach.
- **Was das MDM nicht erledigen kann:** Beim Agenten muessen die
Bedienungshilfe (fuer `control`), die Einblendung ueber anderen Apps und die
Bildschirm-Aufnahme weiterhin einmal am Geraet erlaubt werden — Android laesst
diese Spezialberechtigungen nicht per App-Konfiguration zu. Cockpit fragt
Mikrofon, Benachrichtigungen usw. wie gewohnt beim ersten Start.
- Der **Token ist ein Zugangsschluessel**: Wer ihn kennt, landet im selben
RVS-Room. Im MDM nur fuer Admins sichtbar ablegen.
Welche Schluessel es gibt, steht in `res/xml/app_restrictions.xml` der
jeweiligen App (`android/android/app/...` bzw. `host-agent/android/app/...`);
ein MDM, das die Liste selbst ausliest, zeigt sie dort auch mit Beschreibung an.
---
## Docker Volumes
| Volume / Bind | Pfad im Container | Zweck |