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:
@@ -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:
|
||||
|
||||

|
||||
|
||||
Der Typ wird pro Zeile aus *Text*, *Zahl* oder *Ja/Nein* gewaehlt:
|
||||
|
||||

|
||||
|
||||
### 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 |
|
||||
|
||||
Reference in New Issue
Block a user