[SYNDERESIS / API](/de/dokumentation/) BETRIEB


Gehostete Kunden-API · Vertrag geprüft am 7. November 2026



# Sicherheit, Datenschutz und Datenhandhabung


Auf dieser Seite- [Sicherheit, Datenschutz und Datenhandhabung](#security-privacy-and-data-handling)- [Transport und Zugriff](#transport-and-access)

- [Datenflüsse der Anwendung](#application-data-flows)

- [Protokollierung und Beobachtbarkeit](#logging-and-observability)

- [Speicherung und Aufbewahrung](#storage-and-retention)

- [Löschung des Kontos](#account-deletion)

- [Grenzen der Bereitstellung](#deployment-boundaries)

- [Umgang mit Quellen und Antworten](#source-and-answer-handling)


Gestalten Sie den Zugriff, die Protokolle und die Aufbewahrung Ihrer Integration bewusst. Diese Seite beschreibt die geprüften Handler der Kunden-API und trennt deren Anwendungsverhalten von den Vereinbarungen zu Hosting und Modellanbietern.


Lesen Sie den [Datenschutz- und DSGVO-Hinweis](/de/datenschutz/) und holen Sie die für Ihre Bereitstellung relevanten Verarbeitungsbedingungen ein, bevor Sie sensible oder regulierte Informationen senden.



## Transport und Zugriff


Verwenden Sie den kanonischen HTTPS-Endpunkt. Bewahren Sie Kunden-API-Schlüssel in einem serverseitigen Geheimnisspeicher auf. Die Implementierung speichert Hashes von Kunden-API-Schlüsseln und Browser-Anmeldeinformationen; die Schlüsselerstellung gibt den vollständigen Kundenschlüssel einmal zurück.


Die native API wendet no-store-Antwortheader und Anfragekorrelation an. Browsersitzungen verwenden sichere Cookies und CSRF-Kontrollen für Mutationen. Kundenschlüssel verleihen nicht die ausschließlich der Sitzung vorbehaltene Berechtigung, die zum Verwalten aller Kontoschlüssel erforderlich ist.


CORS ist für die dokumentierte Kunden-API nicht aktiviert. Schalten Sie Ihr eigenes authentifiziertes Backend zwischen einen Browser- oder Mobilclient und Synderesis. CORS ist ein Browserverhalten und kein Ersatz für die Autorisierung Ihrer eigenen Benutzer.



## Datenflüsse der Anwendung


| Daten | Geprüftes Anwendungsverhalten | Folge für die Integration |



| API-Anfragenachrichten und Antworttext | Die dokumentierten nativen Completion-Handler übergeben Inhalte an die konfigurierte Generierungsinfrastruktur und erstellen keinen serverseitigen Datensatz des Konversationsverlaufs. | Senden Sie das für jeden Aufruf benötigte Transkript. Ihre eigene Anwendung kann eine eigene Kopie aufbewahren. |

| Abgerufene Passagen | Als Anfragekontext übergeben und bei Antworten/Suche an den Aufrufer zurückgegeben. | Behandeln Sie Passagen als Quellenmaterial; prüfen Sie Quellenangabe und Lizenzierung für die Weiterverbreitung. |

| Tool-Definitionen und Ergebnisse | Vom Aufrufer bereitgestellt und über die Transkript-Schnittstelle durchgereicht. Client-Funktionen werden in Ihrer Anwendung ausgeführt. | Senden Sie das Minimum an nützlichen Daten und setzen Sie Ihre eigenen Funktionsberechtigungen durch. |

| Nutzungs- und Kontingentdatensätze | Konto-ID, Schlüsselpräfix, Endpunkt, Modellzuordnung, Tokenanzahlen, Status sowie Abrechnungs- und Reservierungsmetadaten werden aufgezeichnet. | Zustandslose Konversationsverarbeitung bedeutet nicht, dass keine betrieblichen Datensätze vorhanden sind. |

| Profil- und Schlüsselmetadaten | Aufbewahrt für Kontozugriff, Lebenszyklus und Dienstbetrieb. | Profilabfragen enthalten personenbezogene Daten; schränken Sie sie ein und vermeiden Sie unnötige Protokollierung. |

| Verarbeitung durch Anbieter und Infrastruktur | Geregelt durch die konfigurierte Route und die geltenden Regelungen zu Anbieter und Hosting. | Das Anwendungsverhalten allein legt keine Bedingungen des Anbieters zur Aufbewahrung oder zur Nutzung für das Training fest. |


Der Parameter store aktiviert im dokumentierten Transkript-Handler keine API für gespeicherte Konversationen. Senden Sie kein privates Material in der Annahme, dass store=false Infrastrukturprotokolle oder die Richtlinie eines Anbieters außer Kraft setzt.



## Protokollierung und Beobachtbarkeit


Protokollieren Sie bei Bedarf Anfrage-ID, Endpunkt, HTTP-Status, Latenz, Modellalias und Nutzung. Schwärzen Sie Authorization, X-API-Key, Cookies und alle Anwendungsgeheimnisse. Vermeiden Sie standardmäßig die Aufzeichnung von Prompts, Quellpassagen, Antworten, Tool-Argumenten/-Ergebnissen oder personenbezogenen Profildaten.


Die geprüfte Protokollierung der Anfragevalidierung ist metadatenorientiert. Gesondert aktivierte betriebliche Protokollierung zur Verbesserung von Fragen/Antworten hat andere Folgen für die Aufbewahrung; prüfen Sie die Bereitstellungseinstellungen, statt anzunehmen, dass sie stets deaktiviert ist.


Ihre eigene Überwachung, ein Reverse-Proxy, der SDK-Debugmodus und die Fehlerberichterstattung können zusätzliche Inhaltskopien erzeugen. Prüfen Sie diese Komponenten im Rahmen Ihrer Integration.



## Speicherung und Aufbewahrung


Der veröffentlichte Datenschutzhinweis beschreibt die Aufbewahrung von Konto- und Nutzungsdaten, Inhaltskategorien, die Löschung, Infrastrukturprotokolle und die unabhängige Aufbewahrung beim Anbieter. Er beschreibt Sicherheits- und Infrastrukturprotokolle im Allgemeinen so, dass sie normalerweise nicht länger als 30 Tage aufbewahrt werden, mit genannten Ausnahmen für Vorfälle und rechtliche Gründe. Die Aufbewahrung beim Anbieter und Sicherungen folgen ihren jeweils eigenen Regelungen.


Deuten Sie diesen Richtlinienzeitraum nicht als universelle Grenze von 30 Tagen für jeden Eintrag oder als Datenaufbewahrung von null. Dass die dokumentierten Handler keinen Schreibvorgang für den Konversationsverlauf ausführen, steuert keine Kopien in Ihrer Anwendung oder in vorgelagerten Diensten.


Klären Sie vor dem Produktivbetrieb diese Einzelheiten für den ausgewählten Dienst:


- Rollen als Verantwortlicher und Auftragsverarbeiter sowie die anwendbare Vereinbarung zur Auftragsverarbeitung.

- Unterauftragsverarbeiter für Hosting und Modell sowie Verarbeitungsorte.

- Ob Ein- und Ausgaben beim Anbieter gespeichert oder für das Training verwendet werden können.

- Log-Kategorien, Aufbewahrungsfristen und Ausnahmen bei Vorfällen.

- Aufbewahrung von Sicherungen und Propagierung von Löschungen.

- Zugriffskontrollen, Zugriff für Audits und Regelungen zur Kontaktaufnahme bei Vorfällen.


Dies sind Tatsachen zu Bereitstellung und Vertrag. Der Code allein kann nicht alle davon überprüfen.



## Kontolöschung


Verwenden Sie den Self-Service-Ablauf zur Kontolöschung. Die Implementierung sperrt mit Beginn der Löschung den Zugriff ab und widerruft die Anmeldedaten; die Bereinigung auf entfernten Systemen kann ausstehend bleiben. Der Datenschutzhinweis erläutert verbleibende betriebliche bzw. rechtliche Aufzeichnungen sowie die Aufbewahrung durch Dritte.


Das Löschen eines Synderesis-Kontos löscht keine Kopien, die Sie in Ihrer eigenen Anwendung gespeichert haben, keine exportierten Dateien und keine unabhängig aufbewahrten Aufzeichnungen des Anbieters. Stellen Sie Ihren Nutzern eine klare Beschreibung des eigenen Aufbewahrungs- und Löschprozesses Ihrer Anwendung bereit.



## Grenzen der Bereitstellung


Ein Unternehmen in der EU oder eine Anwendungsfunktion in Frankfurt ist kein Nachweis dafür, dass die gesamte Inferenz, sämtliche Logs und die gesamte Netzwerkverarbeitung in der EU verbleiben. Modellrouten und Vereinbarungen zur privaten Bereitstellung können sich unterscheiden.


Wenn eine Bereitstellung einen bestimmten nachtrainierten Checkpoint, private Infrastruktur, Residenzbeschränkungen, Offline-Betrieb oder eine dedizierte Isolationsgrenze erfordert, holen Sie eine ausdrückliche, verifizierte Vereinbarung ein. Dieser API-Leitfaden gewährt dem gehosteten Standard-Endpunkt diese Eigenschaften nicht.



## Umgang mit Quellen und Antworten


Behandeln Sie Nutzerprompts, abgerufenen Text und Tool-Ergebnisse als nicht vertrauenswürdige Eingaben. Rendern Sie die Modellausgabe sicher, validieren Sie die Tool-Argumente und belassen Sie folgenreiche Entscheidungen unter der angemessenen Autorität von Mensch oder Anwendung.


Die katholische Ausrichtung beschreibt die beabsichtigte Richtung des Modells. Sie garantiert nicht, dass jede Antwort oder jede Quellenangabe korrekt ist. Die nativen Antwortmetadaten beschreiben den abgerufenen Kontext; sie stellen keine vollständig validierte, strukturierte doktrinäre Antwort dar.


[Übersicht](/de/dokumentation/)[API-Referenz →](/de/dokumentation/referenz/)


[Diesen Leitfaden als Markdown lesen](/de/docs/security-and-data.md)
