⚙️ 🤖 Mastodon: Toot-Vorlage pro Folge, optionales Post-Script und Token-Generator #100

Closed
opened 2026-11-02 23:12:56 +01:00 by holm · 1 comment
Owner
Dimension Bewertung Einschätzung
Aufwand █████░░░░░ Mittel: Vorlage, Post-Script, OAuth-Token-Generator
Nutzen ███████░░░ Hoch: Thread pro Folge ohne Handarbeit (#92)
Bruchhäufigkeit ██░░░░░░░░ –
Nachhaltigkeit ███████░░░ Hoch
Dringlichkeit ███░░░░░░░ Niedrig-mittel, nach #92
Sicherheit ██████░░░░ Token mit Schreibrecht auf das Podcast-Konto

Teil 2 zu #92 (Mastodon-Kommentare). #92 zeigt die Antworten an; dieses Issue erzeugt den Toot.

Entscheid Holm (2026-11-02, Frage 4 → „4ab“)

  1. Vorlage (Standardweg): Ein Script erzeugt pro Folge einen fertigen Toot-Text zum Copy-Paste von Hand: Folgen-Nummer, Titel, Link zur Folgenseite, Hashtags (aus tags), Cover mit Bildbeschreibung (Alt-Text). Danach trägt man die Toot-URL in episode.md ein (mastodon = "…").
  2. Optional per Script: Ein separates Script postet den Toot über die Mastodon-API (Bild-Upload mit Alt-Text, dann Status) und schreibt die Toot-URL in episode.md. Der Build kann es aufrufen (Opt-in), muss aber nicht. Ohne Token läuft der Build unverändert.
  3. Secrets liegen im Tenant (lokal, gitignored), nicht im Deploy-Pfad und nicht im Publisher-Repo. Datei mit Rechten 0600; nie getrackt, außer per git-crypt.
  4. Token-Generator: Ein Script fragt Instanz und Benutzer ab, registriert eine App (POST /api/v1/apps, nur nötige Scopes, z. B. write:statuses write:media) und gibt einen Autorisierungs-Link aus. Nach dem Login fügt man den Code ein, das Script tauscht ihn gegen ein Token (POST /oauth/token) und legt es in der Tenant-Secret-Datei ab. Fallback, falls der OOB-Flow auf der Instanz nicht geht: Anleitung „Einstellungen → Entwicklung → Neue Anwendung → Token kopieren“.

Anforderungen

  • Das Token erscheint nie in der Ausgabe (kein echo, kein Log). Gültigkeit nur wertfrei prüfen (HTTP-Code gegen verify_credentials, Body verwerfen).
  • Ob die Instanz den OOB-Redirect (urn:ietf:wg:oauth:2.0:oob) unterstützt, wird gegen die aktuelle Mastodon-Doku/Instanz geprüft, nicht angenommen.
  • Fehlt das Token, bricht das Post-Script laut ab (kein stilles Überspringen); der Build-Aufruf bleibt Opt-in.
  • Doppel-Post-Schutz: ist mastodon in episode.md schon gesetzt, wird nicht erneut gepostet.

🤖 angelegt von Claude v00 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `█████░░░░░` | Mittel: Vorlage, Post-Script, OAuth-Token-Generator | | Nutzen | `███████░░░` | Hoch: Thread pro Folge ohne Handarbeit (#92) | | Bruchhäufigkeit | `██░░░░░░░░` | – | | Nachhaltigkeit | `███████░░░` | Hoch | | Dringlichkeit | `███░░░░░░░` | Niedrig-mittel, nach #92 | | Sicherheit | `██████░░░░` | Token mit Schreibrecht auf das Podcast-Konto | Teil 2 zu #92 (Mastodon-Kommentare). #92 zeigt die Antworten an; dieses Issue erzeugt den Toot. ## Entscheid Holm (2026-11-02, Frage 4 → „4ab“) 1. **Vorlage (Standardweg):** Ein Script erzeugt pro Folge einen fertigen Toot-Text zum Copy-Paste von Hand: Folgen-Nummer, Titel, Link zur Folgenseite, Hashtags (aus `tags`), Cover mit Bildbeschreibung (Alt-Text). Danach trägt man die Toot-URL in `episode.md` ein (`mastodon = "…"`). 2. **Optional per Script:** Ein separates Script postet den Toot über die Mastodon-API (Bild-Upload mit Alt-Text, dann Status) und schreibt die Toot-URL in `episode.md`. Der Build *kann* es aufrufen (Opt-in), muss aber nicht. Ohne Token läuft der Build unverändert. 3. **Secrets liegen im Tenant** (lokal, gitignored), nicht im Deploy-Pfad und nicht im Publisher-Repo. Datei mit Rechten 0600; nie getrackt, außer per git-crypt. 4. **Token-Generator:** Ein Script fragt Instanz und Benutzer ab, registriert eine App (`POST /api/v1/apps`, nur nötige Scopes, z. B. `write:statuses write:media`) und gibt einen Autorisierungs-Link aus. Nach dem Login fügt man den Code ein, das Script tauscht ihn gegen ein Token (`POST /oauth/token`) und legt es in der Tenant-Secret-Datei ab. Fallback, falls der OOB-Flow auf der Instanz nicht geht: Anleitung „Einstellungen → Entwicklung → Neue Anwendung → Token kopieren“. ## Anforderungen - Das Token erscheint nie in der Ausgabe (kein echo, kein Log). Gültigkeit nur wertfrei prüfen (HTTP-Code gegen `verify_credentials`, Body verwerfen). - Ob die Instanz den OOB-Redirect (`urn:ietf:wg:oauth:2.0:oob`) unterstützt, wird gegen die aktuelle Mastodon-Doku/Instanz geprüft, nicht angenommen. - Fehlt das Token, bricht das Post-Script laut ab (kein stilles Überspringen); der Build-Aufruf bleibt Opt-in. - Doppel-Post-Schutz: ist `mastodon` in `episode.md` schon gesetzt, wird nicht erneut gepostet. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

Abgenommen und gemergt (81766f8; Worker df85286). scripts/mastodon-toot.sh (Vorlage), mastodon-post.sh (Opt-in per ZT_MASTODON_POST="<slug> …", Doppel-Post-Schutz), mastodon-token.sh (OOB-Flow + --manual-Fallback), Token in <tenant>/*.secret.toml 0600, nie in argv (curl -K /dev/fd/…, /proc-Cmdline geprüft), nie in Ausgaben. OOB-Beleg: docs.joinmastodon.org /methods/apps und /methods/oauth (urn:ietf:wg:oauth:2.0:oob). Nicht live getestet: echte App-Registrierung/Post (bewusst offline).

🤖 angelegt von Claude v00 (API/Token holm)

Abgenommen und gemergt (81766f8; Worker df85286). `scripts/mastodon-toot.sh` (Vorlage), `mastodon-post.sh` (Opt-in per `ZT_MASTODON_POST="<slug> …"`, Doppel-Post-Schutz), `mastodon-token.sh` (OOB-Flow + `--manual`-Fallback), Token in `<tenant>/*.secret.toml` 0600, nie in argv (`curl -K /dev/fd/…`, /proc-Cmdline geprüft), nie in Ausgaben. OOB-Beleg: docs.joinmastodon.org /methods/apps und /methods/oauth (urn:ietf:wg:oauth:2.0:oob). Nicht live getestet: echte App-Registrierung/Post (bewusst offline). > 🤖 angelegt von Claude v00 (API/Token holm)
holm closed this issue 2026-11-02 23:44:44 +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#100
No description provided.