Sicherheit und täglicher Betrieb - Notion
Geltungsbereiche und Vererbung
Die Notion-Konfiguration hat zwei Ebenen: Konto und Projekt - genau dieselbe Form wie bei Jira. Ein Projekt ohne eigenes Token erbt das Token des Kontos, behält aber seine eigene Datenbank, denn genau dafür gibt es die Konfiguration pro Projekt: Verschiedene Projekte desselben Kontos können bei einem gemeinsamen Integrationstoken an unterschiedliche Datenbanken berichten. Das interne Konto von Dock fällt zusätzlich auf die Plattformkonfiguration zurück, wenn es keine eigene hat - Abonnenten sehen sie nie.
Wer Zugriff hat
Die Notion-Bildschirme verlangen dieselbe Berechtigung wie Jira - die Projektverwaltung. Eine eigene Berechtigung nur für die Integration gibt es nicht, denn das Verbinden oder Trennen von Notion gehört zur Projektverwaltung.
Das Integrationstoken und sein Schutz
Das Token liegt in DockRay verschlüsselt und kehrt nie ins Formular zurück - ein leeres Feld beim Speichern bedeutet „aktuelles Token behalten", nicht „löschen". Anders als bei Jira gibt es hier keinen zweiten Faktor wie eine E-Mail-Adresse: Das Integrationstoken ist das einzige Geheimnis, sein Schutz läuft also auf eine Sache hinaus - es verlässt nie das DockRay-Panel und die eigene Integrationskonfiguration in Notion.
Eigenschaftsnamen gehören dem Kunden
DockRay speichert die Eigenschaftsnamen der Datenbank nicht - es liest das Schema live, im Moment der Seitenerstellung, und nimmt die erste Eigenschaft vom Typ title, people und status. Ein einfaches Umbenennen in Notion (z. B. „Person" zu „Zugewiesen an") stört deshalb nichts - DockRay sucht nach einem Typ, nicht nach einem Label. Es geht erst kaputt, wenn die Eigenschaft dieses Typs gelöscht oder ihr Typ geändert wird, denn dann findet DockRay einfach kein Feld mehr, das vorher da war.
Was an Notion geht - und was nie
Der Seiteninhalt folgt derselben Grenze wie bei Jira: In die Beschreibung geht der relevante Ausschnitt des Stacktrace ein (die eigenen Frames der Client-Anwendung, oder bei deren Fehlen die Spitze des Stacks), nie die Werte lokaler Variablen, Anfrage-Header, Benutzerdaten oder die Query-String. Eine einzige Stelle im DockRay-Code entscheidet das für beide Integrationen zugleich, damit diese zwei Grenzen bei der ersten Korrektur nicht auseinanderdriften.
Zwei harte Grenzen von Notion
Notion akzeptiert höchstens hundert Blöcke in einer einzigen Anfrage zum Erstellen einer Seite und höchstens zweitausend Zeichen in einem einzigen Textfragment - die Überschreitung einer der beiden endet mit einer 400-Antwort und keiner Seite. DockRay setzt die zweite Grenze selbst durch, indem es einen langen Codeblock in Stücke von zweitausend Zeichen zerlegt, und begrenzt den Seiteninhalt auf hundert Blöcke, wobei vom Ende der Liste her gekürzt wird. Bei einem sehr langen Stacktrace und einer umfangreichen Faktenliste kann das bedeuten, dass der abschließende Absatz mit dem Link zu DockRay nicht mehr in die Grenze passt - der nächste Artikel behandelt das.
Token rotieren und Teammitglieder, die gehen
Das Integrationstoken ist an keine bestimmte Person gebunden - es gehört der Integration selbst, innerhalb des Notion-Workspace. Verlässt die Person, die es erzeugt hat, das Team, arbeitet die Integration weiter: der Workspace, nicht die Person, besitzt das Token. Willst du es trotzdem ungültig machen, lösche oder trenne die Integration in den Notion-Einstellungen und erstelle eine neue - dann musst du ihr jede Datenbank erneut freigeben, denn der Zugriff auf Datenbanken überträgt sich nicht automatisch auf eine neue Integration.