Zum Hauptinhalt springen

Staffbase-API-Token

Staffbase kennt deine Widgets erst, wenn sie registriert sind. Normalerweise passiert das im Browser mit deiner Staffbase-Anmeldung, sobald du im Widget Builder etwas änderst.

Änderungen ohne Browser-Sitzung bleiben dabei liegen: über den MCP-Server, im KI-Assistenten oder durch JASP. Mit einem hinterlegten Staffbase-API-Token registriert der Widget Builder sie selbst. Der Token ist optional; ohne ihn klickst du nach solchen Änderungen im Dashboard auf „Widgets neu registrieren“.

Token erstellen​

  1. Öffne im Staffbase Studio Einstellungen → API-Zugriff.
  2. Erstelle einen Token mit der Zugriffsstufe Administrativ.
  3. Beschränke ihn nach Möglichkeit auf die IP-Adressen des Widget Builders.
  4. Kopiere den Token.

Bisher ist nur die Stufe „Administrativ“ getestet. Ein solcher Token kann auch Nutzer, Gruppen, Spaces, Seiten und Beiträge deiner Instanz lesen. Der Widget Builder nutzt ihn nur, um deine Widgets zu registrieren.

Token hinterlegen​

  1. Öffne im Widget Builder Einstellungen → Technik / IT → Staffbase-API-Token → Token verwalten.
  2. Füge den Token ein und klicke auf Token speichern.

Der Widget Builder prüft den Token sofort gegen deine Staffbase-Instanz. Lehnt Staffbase ihn ab oder gehört er zu einer anderen Instanz, wird nichts gespeichert. Gespeichert wird der Token verschlüsselt; danach zeigt die Seite nur noch seine ersten 7 Zeichen und unter Status, ob Staffbase ihn zuletzt angenommen hat.

Ändert sich die Staffbase-Adresse deines Kontos, löscht der Widget Builder den Token automatisch.

Was der Widget Builder mit dem Token macht​

Unter Verwendung legst du fest, wofür der Token eingesetzt wird:

SchalterWirkung
Nach Änderungen über den MCP-ServerRegistrierung nach Anlegen, Ändern, Löschen und Importieren über MCP-Tools
Nach Änderungen im KI-AssistentenRegistrierung, wenn der KI-Assistent ein Widget anlegt, ändert oder löscht
Nach Änderungen an Standard-WidgetsRegistrierung nach Aktivierung von Standard-Widgets durch JASP und nach einer Lizenzänderung
Suche in AuswahlfeldernSuche nach Gruppen, Nutzern, Kanälen, Seiten und Spaces (siehe unten)

Der Widget Builder aktualisiert nur eine bestehende Registrierung. Die erste Registrierung machst du einmal im Dashboard mit deiner Staffbase-Anmeldung.

Außerdem sucht der Widget Builder mit dem Token nach Gruppen, Nutzern, Kanälen, Seiten und Spaces, wenn du bei Berechtigungen, bei der Freigabe von Datentabellen oder in Einstellungsfeldern suchst. Die Antwort enthält nur ID, Name und Profilbild. Ohne Token oder mit ausgeschaltetem Schalter Suche in Auswahlfeldern nutzt die Suche deine eigene Staffbase-Anmeldung. Suchen werden nicht protokolliert.

Datenquellen, API-Verbindungen und Widget-Layouts erhalten den Token nie.

Protokoll​

Das Protokoll zeigt jede Registrierung und jede Änderung am Token der letzten 90 Tage: Zeitpunkt, Auslöser, Ergebnis und die Antwort von Staffbase. Bei Änderungen in den Einstellungen steht dort der Name der Person. Statusabfragen und der Token selbst werden nicht protokolliert.

Wenn etwas nicht klappt​

  • „Staffbase lehnt den hinterlegten Token ab“: Der Token wurde im Staffbase Studio gelöscht oder hat seine Rechte verloren. Hinterlege einen neuen.
  • „Noch nicht registriert“: Registriere die Widgets einmal im Dashboard mit deiner Staffbase-Anmeldung.
  • Token nicht mehr lesbar: Nach einem Wechsel des Schlüssels BACKUP_ENCRYPTION_KEY (Standalone) kann der Widget Builder gespeicherte Tokens nicht mehr entschlüsseln. Hinterlege den Token dann erneut.