⚙️ 🤖 Folgen aus zentonic-mix per API abholen (Bearer-Token, import episode) #171

Closed
opened 2026-11-16 15:09:31 +01:00 by holm · 5 comments
Owner
Dimension Bewertung Einschätzung
Aufwand ███░░░░░░░ Niedrig–mittel — Token holen, Liste lesen, Zip laden, import episode, Rückmeldung
Nutzen █████████░ Sehr hoch — fertige Folge aus dem Mix ohne Zip-Herumtragen
Sicherheit ██████░░░░ Client-Secret aus pass, nur Bearer-Token über HTTPS
Dringlichkeit █████░░░░░ Mittel — Mix-Seite kommt mit zentonic-mix v0.7.0

Auftrag (Holm 2026-11-16)

  • „5a“ Publisher-Übergabe automatisieren; „6“ „kein ssh, kein scp … web (api? token? sonstwas?) der weg der immer und überall geht“; „7a“ Keycloak-Service-Account je Maschine.
  • Mix-Seite: zentonic-mix#17 (Übergabe), zentonic-mix#23 (Maschinenzugang). Antrag c2604-zentonic-mix:0009.

Schnittstelle (zentonic-mix, ab v0.7.0)

  1. Token: Client-Credentials an https://<keycloak>/realms/zentonic-studio/protocol/openid-connect/token, Client zentonic-mix-abholen (Secret in pass, Pfad meldet v00-wsm25-hosting, Antrag c2604-zentonic-mix:0008).
  2. GET https://mix.studio.demo.podcast.zentonic.org/api/handover mit Authorization: Bearer <token> → [{slug, rev, at, size, sha256, zip}].
  3. Zip laden (zip relativ zur Mix-URL), sha256 prüfen, zpub import episode <zip> <tenant>.
  4. Ergebnis: POST /api/handover/<slug>/done {tenant, at} bzw. POST /api/handover/<slug>/error {message}.

Bitte (euer Werkzeug, eure Entscheidung)

Abruf als Teil von zpub (z. B. zpub import mix <tenant> oder zpub import episode --from-mix …) oder eigenes Skript — Name, Aufruf und wo die Mix-URL/der pass-Pfad konfiguriert wird, bestimmt ihr.

Abnahme

  • Eine im Mix übergebene Folge landet per Befehl im Tenant, Mix zeigt „abgeholt“

🤖 angelegt von Claude claude2604 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `███░░░░░░░` | Niedrig–mittel — Token holen, Liste lesen, Zip laden, `import episode`, Rückmeldung | | Nutzen | `█████████░` | Sehr hoch — fertige Folge aus dem Mix ohne Zip-Herumtragen | | Sicherheit | `██████░░░░` | Client-Secret aus pass, nur Bearer-Token über HTTPS | | Dringlichkeit | `█████░░░░░` | Mittel — Mix-Seite kommt mit zentonic-mix v0.7.0 | ## Auftrag (Holm 2026-11-16) - „5a“ Publisher-Übergabe automatisieren; „6“ „kein ssh, kein scp … web (api? token? sonstwas?) der weg der immer und überall geht“; „7a“ Keycloak-Service-Account je Maschine. - Mix-Seite: [zentonic-mix#17](https://forgejo.mueller.network/holm.tools.secret/zentonic-mix/issues/17) (Übergabe), [zentonic-mix#23](https://forgejo.mueller.network/holm.tools.secret/zentonic-mix/issues/23) (Maschinenzugang). Antrag c2604-zentonic-mix:0009. ## Schnittstelle (zentonic-mix, ab v0.7.0) 1. Token: Client-Credentials an `https://<keycloak>/realms/zentonic-studio/protocol/openid-connect/token`, Client `zentonic-mix-abholen` (Secret in pass, Pfad meldet v00-wsm25-hosting, Antrag c2604-zentonic-mix:0008). 2. `GET https://mix.studio.demo.podcast.zentonic.org/api/handover` mit `Authorization: Bearer <token>` → `[{slug, rev, at, size, sha256, zip}]`. 3. Zip laden (`zip` relativ zur Mix-URL), sha256 prüfen, `zpub import episode <zip> <tenant>`. 4. Ergebnis: `POST /api/handover/<slug>/done` `{tenant, at}` bzw. `POST /api/handover/<slug>/error` `{message}`. ## Bitte (euer Werkzeug, eure Entscheidung) Abruf als Teil von `zpub` (z. B. `zpub import mix <tenant>` oder `zpub import episode --from-mix …`) oder eigenes Skript — Name, Aufruf und wo die Mix-URL/der pass-Pfad konfiguriert wird, bestimmt ihr. ## Abnahme - [ ] Eine im Mix übergebene Folge landet per Befehl im Tenant, Mix zeigt „abgeholt“ > 🤖 angelegt von Claude claude2604 (API/Token holm)
Author
Owner

Zusatz: Basis-URL einstellbar (LAN)

Holm 2026-11-16 (über v00-wsm25-hosting, req 0106): „wir können als parameter bauen: ‚liegen in LAN‘, so dass die dinger dann direkt lokale ips nutzen statt ins netz hoch und wieder runter zu laden“.

Bitte die Mix-Basis-URL im Abruf einstellbar machen: Standard https://mix.studio.demo.podcast.zentonic.org, im Hausnetz die Direktadresse von docker24 (oauth2-proxy ohne TLS, nur LAN; URL meldet v00-wsm25-hosting). Gleiche Routen, gleicher Bearer-Token. Der Keycloak-Token-Endpunkt bleibt die öffentliche URL.

🤖 angelegt von Claude claude2604 (API/Token holm)

## Zusatz: Basis-URL einstellbar (LAN) Holm 2026-11-16 (über v00-wsm25-hosting, req 0106): „wir können als parameter bauen: ‚liegen in LAN‘, so dass die dinger dann direkt lokale ips nutzen statt ins netz hoch und wieder runter zu laden“. Bitte die Mix-Basis-URL im Abruf einstellbar machen: Standard `https://mix.studio.demo.podcast.zentonic.org`, im Hausnetz die Direktadresse von docker24 (oauth2-proxy ohne TLS, nur LAN; URL meldet v00-wsm25-hosting). Gleiche Routen, gleicher Bearer-Token. Der Keycloak-Token-Endpunkt bleibt die öffentliche URL. > 🤖 angelegt von Claude claude2604 (API/Token holm)
Author
Owner

Mix-Seite und Zugang stehen — Abruf kann gebaut werden

  • zentonic-mix v0.7.0+ live mit GET /api/handover, GET /api/projects/<slug>/episode.zip (eingefroren, size/sha256 passen), POST /api/handover/<slug>/done|error (Doku: docs/api.md „Übergabe an den Publisher (#17)“, mit curl-Beispiel).
  • Zugang (v00-wsm25-hosting, resp 0008): Client zentonic-mix-abholen, Secret im pass-Maschinen-Store keycloak/zentonic-mix-abholen_26-11_c1b1 (nur Pfad), Token-URL https://id.nerdraum.de/realms/zentonic-studio/protocol/openid-connect/token (client_credentials), Token 300 s.
  • Basis-URL: öffentlich https://mix.studio.demo.podcast.zentonic.org, im LAN http://10.42.25.110:8470 (ohne TLS, nur Hausnetz).
  • Gemessen am echten Stack: Bearer /api/handover → 200.

🤖 angelegt von Claude claude2604 (API/Token holm)

## Mix-Seite und Zugang stehen — Abruf kann gebaut werden - zentonic-mix v0.7.0+ live mit `GET /api/handover`, `GET /api/projects/<slug>/episode.zip` (eingefroren, `size`/`sha256` passen), `POST /api/handover/<slug>/done|error` (Doku: `docs/api.md` „Übergabe an den Publisher (#17)“, mit curl-Beispiel). - Zugang (v00-wsm25-hosting, resp 0008): Client `zentonic-mix-abholen`, Secret im pass-Maschinen-Store `keycloak/zentonic-mix-abholen_26-11_c1b1` (nur Pfad), Token-URL `https://id.nerdraum.de/realms/zentonic-studio/protocol/openid-connect/token` (`client_credentials`), Token 300 s. - Basis-URL: öffentlich `https://mix.studio.demo.podcast.zentonic.org`, im LAN `http://10.42.25.110:8470` (ohne TLS, nur Hausnetz). - Gemessen am echten Stack: Bearer `/api/handover` → 200. > 🤖 angelegt von Claude claude2604 (API/Token holm)
Author
Owner

zpub import mix auf dev (04a56ad, Merge nach dev)

  • Aufruf: zpub import mix [--list] [--dry-run] [--slug <slug>] <tenant>; Doku docs/import.md „Folgen aus zentonic-mix abholen“.
  • Konfiguration: Env (ZPUB_MIX_URL, ZPUB_MIX_TOKEN_URL, ZPUB_MIX_CLIENT, ZPUB_MIX_PASS, ZPUB_MIX_STORE) vor [mix] in deploy.local.toml vor Default. LAN: ZPUB_MIX_URL=http://10.42.25.110:8470.
  • Secret per stdin an curl, Token per Header-FD — 0× in argv/Ausgabe (Test zählt).
  • Offline-Test scripts/check/import-mix-test.sh: alle Prüfungen ✓ (nachgemessen im Merge-Stand), u. a. sha256-Fehler → error ohne Import, Erfolg → done mit rev, schon vorhanden → Exit 3 + error, 302 → „nicht autorisiert“.
  • Live nur lesend (--list, sample_project): öffentlich und LAN je Token ✓, 0 bereite Übergaben, nichts an den Mix gesendet.

Offen für die Abnahme: erste echte Übergabe im Mix (Download → Import → done) und Auslieferung mit dem nächsten Release.

🤖 angelegt von Claude claude2604 (API/Token holm)

## `zpub import mix` auf dev (04a56ad, Merge nach dev) - Aufruf: `zpub import mix [--list] [--dry-run] [--slug <slug>] <tenant>`; Doku `docs/import.md` „Folgen aus zentonic-mix abholen“. - Konfiguration: Env (`ZPUB_MIX_URL`, `ZPUB_MIX_TOKEN_URL`, `ZPUB_MIX_CLIENT`, `ZPUB_MIX_PASS`, `ZPUB_MIX_STORE`) vor `[mix]` in `deploy.local.toml` vor Default. LAN: `ZPUB_MIX_URL=http://10.42.25.110:8470`. - Secret per stdin an curl, Token per Header-FD — 0× in argv/Ausgabe (Test zählt). - Offline-Test `scripts/check/import-mix-test.sh`: alle Prüfungen ✓ (nachgemessen im Merge-Stand), u. a. sha256-Fehler → error ohne Import, Erfolg → done mit `rev`, schon vorhanden → Exit 3 + error, 302 → „nicht autorisiert“. - Live nur lesend (`--list`, sample_project): öffentlich und LAN je Token ✓, 0 bereite Übergaben, nichts an den Mix gesendet. Offen für die Abnahme: erste echte Übergabe im Mix (Download → Import → done) und Auslieferung mit dem nächsten Release. > 🤖 angelegt von Claude claude2604 (API/Token holm)
Author
Owner

Abnahme am echten Mix ✓

Test-Übergabe nice-test-171 (Klon von „nice2026“, rev 2, 197 925 779 Bytes) von zentonic-mix, Lauf 14:30 über die LAN-URL in einen Wegwerf-Tenant (Kopie von sample_project, nicht veröffentlicht):

  • --list: 1 bereite Übergabe
  • --slug nice-test-171: geladen, Größe + sha256 stimmen → import episode → episodes/nice-test-171/ (episode.md + audio/nice-test-171.wav) → „Mix: done gemeldet“, Exit 0, 9 s
  • danach --list über die öffentliche URL: 0 bereite Übergaben (Mix führt die Folge als abgeholt)

Code: 04a56ad (dev). Auslieferung auf Holms Gerät mit rc.44.

🤖 angelegt von Claude claude2604 (API/Token holm)

## Abnahme am echten Mix ✓ Test-Übergabe `nice-test-171` (Klon von „nice2026“, rev 2, 197 925 779 Bytes) von zentonic-mix, Lauf 14:30 über die LAN-URL in einen Wegwerf-Tenant (Kopie von sample_project, nicht veröffentlicht): - `--list`: 1 bereite Übergabe - `--slug nice-test-171`: geladen, Größe + sha256 stimmen → `import episode` → `episodes/nice-test-171/` (episode.md + audio/nice-test-171.wav) → „Mix: done gemeldet“, Exit 0, 9 s - danach `--list` über die öffentliche URL: 0 bereite Übergaben (Mix führt die Folge als abgeholt) Code: 04a56ad (dev). Auslieferung auf Holms Gerät mit rc.44. > 🤖 angelegt von Claude claude2604 (API/Token holm)
Author
Owner

Ausgeliefert: v1.0.0-rc.44 (Tag signiert, Forgejo-Prerelease, main), HOME=/home/holm toolctl sync zentonic-publisher → /home/holm/bin/zpub --version = zpub 1.0.0-rc.44. Abnahme am echten Mix siehe Kommentar davor.

🤖 angelegt von Claude claude2604 (API/Token holm)

Ausgeliefert: v1.0.0-rc.44 (Tag signiert, Forgejo-Prerelease, main), `HOME=/home/holm toolctl sync zentonic-publisher` → `/home/holm/bin/zpub --version` = `zpub 1.0.0-rc.44`. Abnahme am echten Mix siehe Kommentar davor. > 🤖 angelegt von Claude claude2604 (API/Token holm)
holm closed this issue 2026-11-17 14:32:31 +01:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Zentonic/zentonic-publisher#171
No description provided.