Daten, die über den Connector fließen
Hier siehst du, welche Daten zwischen TEISENDA und der verbundenen Anwendung fließen und welche Protokolle dabei entstehen.
Auf dieser Seite
Das erhält die Anwendung über den Connector
- den Namen TEISENDA, ein Symbol und die Adresse der Doku, mit denen sich der Connector vorstellt
- die Anweisungen des Connectors
- den Katalog der Tools
- aus
whoamideinen Namen und zu jedem Space der Verbindung die Space-ID, den Namen, die Angabe, ob er gesperrt ist, und seine Produkte - das Ergebnis jedes Tool-Aufrufs
Das Ergebnis eines Hosting-Tools beginnt mit dem Space
Hosting-Ergebnisse nennen zuerst den Space und eine Meldung in deiner Kontosprache, bei nicht unterstützter Sprache auf Deutsch. Danach folgen Daten mit englischen Feldnamen als JSON. Ein Space ist ein gemeinsamer Arbeitsbereich in der App.
whoamiantwortet mit einem einzelnen Textblock, der JSON enthält, ohne die Zeile für den Space und ohne strukturierten Teil.- Den Inhalt einer Datei, die die Anwendung mit
hosting_read_fileliest, gibt TEISENDA nur in einem eigenen Block heraus, der gerahmt und als Daten gekennzeichnet ist; je Aufruf sind es höchstens 40.000 Zeichen. hosting_get_visibilitynennt nur die Zahl der ausgewählten Personen und Teams, nie die Namen anderer Mitglieder. Die englischen Fehlercodes des Hosting-Knotens stehen nie in einem Ergebnis.- Eine Ablehnung ist ein Satz in der Sprache deines Kontos oder, wenn der Connector ablehnt, ein fester englischer Satz. Manchmal kommt nur ein HTTP-Status. Die Fälle stehen unter Fehler beim Connector beheben.
Das ist, was der Connector liefert. Was du in der Unterhaltung liest, formuliert die Anwendung.
Das erhält TEISENDA von der Anwendung
TEISENDA erhält die Argumente des Tool-Aufrufs sowie Nutzer, Verbindung und Anfragenummer.
Mehrere Protokolle halten etwas über die Nutzung fest
Details im Projektprotokoll und Fehlermeldungen der App können einzelne Werte aus Tool-Argumenten enthalten. Die Nummer einer Anfrage ist beim Connector und im Protokoll des Projekts dieselbe; über sie lässt sich ein Aufruf in beiden wiederfinden.
| Protokoll | Wer führt es | Was steht darin |
|---|---|---|
| Anmeldungen | Connector | Zu jeder Anmeldung, jedem Widerruf und jeder Abmeldung der Nutzer. Bei einer Anmeldung auch der Name der Anwendung und der Host, zu dem sie zurückgekehrt ist. |
| Tool-Aufrufe | Connector | Toolname, Nutzer, Anfragenummer und Zeitpunkt; bei Fehlern können weitere Zeilen mit Fehlertexten der App folgen. Diese können einzelne Daten wie eine Space-ID enthalten. whoami erzeugt keinen solchen Eintrag. Widerrufe werden mit Zustand der Anmeldung, Anwendungskennung und gegebenenfalls Nutzer protokolliert. |
| Zugriffe | Webserver des Connectors | IP-Adresse, Zeitpunkt, Methode und vollständige Adresse samt Parametern, HTTP-Status, Antwortgröße, verweisende Seite und anfragendes Programm. Ein weiteres Feld kann die Anwendungskennung bei HTTP-Basic-Anmeldung enthalten. Die IP gehört bei Tool-Aufrufen zum Anbieter, bei der Anmeldung zum Browser. |
| Protokoll des Projekts | App | Änderungen mit Space, Projekt, Konto, Kanal, Anfragenummer, Vorgang, Detail und Zeitpunkt. Details können einzelne Argumentwerte enthalten, aber keine Dateinamen oder Dateiinhalte. Reines Lesen sowie Schreiben und Löschen von Dateien erzeugen keinen Eintrag; das Anlegen eines Entwurfs und entfernte ältere Versionen werden vermerkt. |
| Versionen und Verbindungen | App | Eine Version behält den Kanal, das Konto und die Nummer der Anfrage, mit denen sie entstanden ist. Eine Verbindung behält den Zeitpunkt der letzten Nutzung. |
| Fehlerausgabe | App | Nur Fehler: Bricht ein Tool ab, steht eine Zeile mit dem Namen des Tools, der Nummer der Anfrage und dem Fehler, der Werte aus den Argumenten enthalten kann. |
| Fehler von Hintergrundjobs | App-Datenbank | Scheitert ein Hintergrundjob, wird seine Fehlermeldung gespeichert. |
Bei der Anmeldung werden auch die Parameter der Anmelde- und Rückkehradresse protokolliert, darunter der Einmalcode der App. Der Webserver protokolliert keine Anfrage- oder Antwortkörper, Tokens, Cookies oder die Kopfzeile Authorization. Tool-Argumente und Ergebnisse stehen nicht als vollständige Inhalte im Dienstjournal; Fehlertexte können jedoch einzelne Werte enthalten.
Diese Fristen gelten für die Protokolle
- Anmeldeprotokoll: Einträge, die älter als zwölf Monate sind, werden beim Beginn einer neuen Anmeldung gelöscht.
- Serviceprotokoll des Connectors mit Tool-Aufrufen und Widerrufen: höchstens drei Monate; bei Erreichen der Größenbegrenzung früher. Die zusätzliche Kopie im Systemprotokoll bleibt durch die wöchentliche Rotation rund vier bis fünf Wochen erhalten.
- Zugriffsprotokoll des Webservers vor dem Connector: 14 Tagesdateien plus die laufende Datei. Die tägliche Rotation löscht Einträge nach 14 bis 15 Tagen. Diese Frist gilt nicht für die Fehlerprotokolle des Webservers.
Das Projektprotokoll hat keine feste Aufbewahrungsfrist: Seine Einträge bleiben bis zur Löschung des Space erhalten, auch wenn das Projekt vorher gelöscht wird.
Bei einer Kontolöschung wird die Zuordnung zur handelnden Person im Eintrag entfernt. Eine Konto-ID in den Details eines früheren Freigabeeintrags bleibt jedoch erhalten.
Für die Ausgabe der App, ihres Connector-Listeners und der Hintergrundjobs gibt es keine Frist in Tagen. Je Container rotiert die Protokolldatei beim Erreichen von 10 MB; ältere Ausgabe wird dabei entfernt. Auch das Entfernen des Containers löscht seine Ausgabe. Ein neuer Deploy allein löscht sie nicht: Angehaltene Vorgänger behalten ihre Protokolle bis zu ihrer Entfernung.
Fehlermeldungen von Hintergrundjobs bleiben zusätzlich ohne automatische Löschregel in der Datenbank. Die Löschung eines Space entfernt diese Einträge nicht.
Das hält TEISENDA zu jeder Verbindung fest
- den Namen, den die Anwendung angegeben hat, unverändert und von TEISENDA nie überprüft
- den Host, zu dem die Anmeldung zurückgekehrt ist
- den Zeitpunkt des Verbindens und den der letzten Nutzung
- ihre Spaces und ob sie auch für Spaces gilt, in die du später kommst
Die letzte Nutzung umfasst auch abgelehnte Anfragen und ändert sich höchstens einmal in fünf Minuten. Sie ist kein Nachweis, dass ein Tool ausgeführt wurde.
Die Datenschutzerklärung steht auf der Website
Die Datenschutzerklärung von TEISENDA findest du unter teisenda.com/datenschutz.