Bevor ein Bot oder Overlay mit deinem Kanal arbeiten darf, zeigt Twitch eine Liste: „Diese App möchte …“. Die meisten klicken auf Autorisieren, ohne zu lesen. Dabei steht dort genau, was das Werkzeug in deinem Namen tun darf. Hier lernst du, die Liste zu lesen.
Was ein Scope ist
Ein Werkzeug bekommt von Twitch nie dein Passwort, sondern ein Token: einen Schlüssel, der nur bestimmte Dinge aufschließt. Welche das sind, legen die Scopes fest. Jeder Scope ist eine einzelne Erlaubnis, etwa „Chat lesen“ oder „Abonnenten sehen“. Was nicht freigegeben ist, kann das Werkzeug nicht, auch wenn es das gern würde.
Die Scopes folgen einem Muster: Erst kommt der Bereich (channel, moderator, user, chat …), dann meist read für Lesen oder manage für Verwalten. Allein dieses eine Wort sagt schon viel über das Risiko.
Die wichtigsten Scopes für Streamer
| Scope | Erlaubt | Typisch für |
|---|---|---|
chat:read, chat:edit | Chat lesen und Nachrichten schreiben | Chatbots |
moderator:read:chatters | Liste der Personen im Chat sehen | Watchtime, Giveaways |
moderator:read:followers | Follower eines Kanals sehen | Follower-Prüfung, Alerts |
channel:read:subscriptions | Abonnenten und ihre Stufe sehen | Abo-Boni, Alerts |
bits:read | Bits-Ranglisten und -Ereignisse sehen | Alerts, Danke-Nachrichten |
channel:read:redemptions | Kanalpunkte-Belohnungen und Einlösungen sehen | Wunschlisten, Overlays |
channel:manage:redemptions | Belohnungen anlegen, ändern und Einlösungen erledigen oder erstatten | Werkzeuge, die Belohnungen selbst verwalten |
channel:manage:moderators | Moderatoren ernennen und entfernen | Bot macht sich selbst zum Mod |
channel:manage:broadcast | Titel, Kategorie und weitere Sendeeinstellungen ändern | Titel-Automatik |
user:read:email | E-Mail-Adresse des Kontos sehen | Kundenkonto beim Anbieter |
Lesen ist harmlos, Verwalten nicht
Ein read-Scope lässt ein Werkzeug zusehen. Im schlimmsten Fall erfährt es Dinge, die es nicht wissen müsste. Ein manage-Scope lässt es handeln: Moderatoren ernennen, Titel ändern, Belohnungen löschen. Gerät so ein Token in falsche Hände, kann jemand in deinem Kanal Dinge tun, die man sieht.
Frag dich bei jedem manage-Scope: Braucht das Werkzeug das wirklich für die Funktion, die ich nutzen will? Ein Overlay, das nur Alerts zeigt, braucht nichts zu verwalten.
Ein seriöses Werkzeug fragt nur nach dem, was es nutzt – und erklärt, wofür. Ein Login, mit dem sich Zuschauer nur ausweisen, kommt sogar ganz ohne Scopes aus: Unser Zuschauer-Login fordert keinen einzigen an.
Beispiel: Den Titel ändern, ohne den Titel-Scope zu verlangen
Ein 24/7-Stream soll im Titel zeigen, welches Video gerade läuft. Der direkte Weg wäre channel:manage:broadcast – und damit das Recht, auch Kategorie und weitere Sendeeinstellungen zu ändern. Wir fordern diesen Scope bewusst nicht an. Stattdessen sagt unser Bot das Video im Chat an, und StreamElements, das ohnehin mit dem Kanal verbunden ist, setzt daraus den Titel. Wie das geht, steht im Ratgeber zu den StreamElements-Userlevels.
Das Muster lässt sich übertragen: Wenn ein schon verbundenes Werkzeug eine Aufgabe übernehmen kann, muss ein zweites nicht dieselbe mächtige Freigabe bekommen.
Wie lange eine Freigabe gilt
- Zugriffstokens laufen ab. Werkzeuge erneuern sie mit einem Refresh-Token, ohne dass du dich neu anmelden musst.
- Refresh-Tokens werden ungültig, wenn du dein Twitch-Passwort änderst oder die App trennst. Bei Apps ohne eigenen Server (öffentliche Clients) laufen sie zusätzlich nach 30 Tagen ab.
- Werkzeuge müssen Tokens prüfen. Twitch verlangt, dass Apps ihre Tokens beim Start und danach stündlich gegen den Validierungsdienst prüfen. So merken sie schnell, wenn du eine Freigabe zurückgenommen hast.
- Werkzeuge sollten Tokens zurückgeben. Twitch bietet einen Widerrufsdienst und empfiehlt, ein Token zu widerrufen, sobald es nicht mehr gebraucht wird.
Eine Freigabe zurücknehmen
In deinen Twitch-Einstellungen unter Verbindungen stehen alle Apps, denen du Zugriff gegeben hast. Mit Trennen nimmst du die Freigabe zurück; das Refresh-Token der App wird damit ungültig. Mach das für jedes Werkzeug, das du nicht mehr nutzt. Taucht dort eine App auf, die du nicht kennst, trenne sie und ändere zur Sicherheit dein Passwort.
Warnzeichen
- Ein Werkzeug fragt nach deinem Twitch-Passwort. Seriöse Werkzeuge leiten dich immer zur Anmeldeseite von Twitch.
- Du sollst ein Token in den Chat oder in ein Formular kopieren, ohne dass klar ist, wo es gespeichert wird.
- Die Liste ist viel länger als die Funktion. Ein Song-Request-Bot mit Moderatoren- und Titelrechten ist kein gutes Zeichen.
- Keine Erklärung. Wer nicht sagt, wofür er einen Scope braucht, hat es sich meist nicht überlegt.
Checkliste vor dem Autorisieren
- Bin ich im Browser mit dem richtigen Twitch-Konto angemeldet?
- Passt jeder Scope zu einer Funktion, die ich wirklich nutze?
- Welche
manage-Scopes sind dabei, und brauche ich sie? - Erklärt der Anbieter, wofür er die Rechte nutzt und wie er Tokens speichert?
- Unter Verbindungen alte Apps getrennt?