SYNDERESIS / API EKSPLOATACJA
Hostowane API dla klientów · Kontrakt przejrzany 7 listopada 2026
Bezpieczeństwo, prywatność i postępowanie z danymi
Na tej stronie
Zadbaj, aby dostęp, logi i retencja twojej integracji były przemyślane. Ta strona opisuje przejrzane handlery API dla klientów i oddziela ich zachowanie aplikacyjne od ustaleń dotyczących hostingu i dostawców modeli.
Przeczytaj informację o prywatności i RODO i uzyskaj warunki przetwarzania mające zastosowanie do Twojego wdrożenia, zanim prześlesz informacje wrażliwe lub objęte regulacjami.
Transport i dostęp
Używaj kanonicznego punktu końcowego HTTPS. Przechowuj klucze API klienta w serwerowym magazynie sekretów. Implementacja przechowuje hashe kluczy API klienta i danych uwierzytelniających przeglądarki; utworzenie klucza zwraca pełny klucz klienta jednokrotnie.
Natywne API stosuje nagłówki odpowiedzi no-store oraz korelację żądań. Sesje przeglądarki używają bezpiecznych plików cookie i kontroli CSRF dla mutacji. Klucze klienta nie nadają uprawnienia zastrzeżonego wyłącznie dla sesji, które jest potrzebne do zarządzania wszystkimi kluczami konta.
CORS nie jest włączony dla udokumentowanego API klienta. Umieść własny uwierzytelniony backend między klientem przeglądarkowym lub mobilnym a Synderesis. CORS jest zachowaniem przeglądarki, a nie zastępstwem autoryzacji własnych użytkowników.
Przepływy danych aplikacji
| Dane | Przejrzane zachowanie aplikacji | Konsekwencja dla integracji |
|---|---|---|
| Komunikaty żądań API i tekst odpowiedzi | Udokumentowane natywne handlery completion przekazują treść do skonfigurowanej infrastruktury generowania i nie tworzą serwerowego rekordu historii rozmowy. | Wyślij transkrypt potrzebny dla każdego wywołania. Własna aplikacja może zachować własną kopię. |
| Pobrane fragmenty | Przekazywane jako kontekst żądania oraz, dla odpowiedzi/wyszukiwania, zwracane do wywołującego. | Traktuj fragmenty jako materiał źródłowy; zweryfikuj atrybucję i licencjonowanie pod kątem dalszego rozpowszechniania. |
| Definicje narzędzi i wyniki | Dostarczane przez wywołującego i przekazywane przez interfejs transkryptu. Funkcje klienckie są wykonywane w Twojej aplikacji. | Wyślij minimum użytecznych danych i egzekwuj własne uprawnienia funkcji. |
| Rekordy użycia i limitów | Rejestrowane są identyfikator konta, prefiks klucza, punkt końcowy, przypisanie modelu, liczby tokenów, status oraz metadane rozliczeń i rezerwacji. | Bezstanowa obsługa rozmowy nie oznacza, że nie istnieją żadne rekordy operacyjne. |
| Metadane profilu i klucza | Przechowywane na potrzeby dostępu do konta, cyklu życia i działania usługi. | Odczyty profilu zawierają dane osobowe; ogranicz je i unikaj zbędnego rejestrowania. |
| Przetwarzanie przez dostawcę i infrastrukturę | Regulowane przez skonfigurowaną trasę oraz obowiązujące ustalenia dotyczące dostawcy i hostingu. | Samo zachowanie aplikacji nie ustanawia warunków dostawcy dotyczących przechowywania ani wykorzystania do treningu. |
Parametr store nie włącza w udokumentowanym handlerze transkryptu API zapisanej rozmowy. Nie wysyłaj materiału prywatnego przy założeniu, że store=false unieważnia dzienniki infrastruktury albo politykę dostawcy.
Rejestrowanie i obserwowalność
W razie potrzeby rejestruj identyfikator żądania, punkt końcowy, status HTTP, latencję, alias modelu i użycie. Zamaskuj Authorization, X-API-Key, pliki cookie oraz wszelkie sekrety aplikacji. Domyślnie unikaj zapisywania promptów, fragmentów źródłowych, odpowiedzi, argumentów/wyników narzędzi lub danych osobowych profilu.
Przejrzane rejestrowanie walidacji żądań jest zorientowane na metadane. Osobno włączone operacyjne rejestrowanie na potrzeby ulepszania pytań/odpowiedzi ma inne konsekwencje retencji; sprawdź ustawienia wdrożenia, zamiast zakładać, że jest ono zawsze wyłączone.
Własne monitorowanie, reverse proxy, tryb debugowania SDK i raportowanie błędów mogą tworzyć dodatkowe kopie treści. Przejrzyj te komponenty w ramach swojej integracji.
Przechowywanie i retencja
Opublikowana informacja o prywatności opisuje retencję danych konta i użycia, kategorie treści, usuwanie, dzienniki infrastruktury oraz niezależną retencję u dostawcy. Ogólnie opisuje ona dzienniki bezpieczeństwa i infrastruktury jako zwykle przechowywane nie dłużej niż 30 dni, ze wskazanymi wyjątkami dotyczącymi incydentów i podstaw prawnych. Retencja u dostawcy i kopie zapasowe podlegają ich odrębnym ustaleniom.
Nie interpretuj tego okresu z polityki jako uniwersalny limit 30 dni dla każdego elementu ani jako zerowe przechowywanie danych. Brak zapisu historii rozmowy w udokumentowanych handlerach nie kontroluje kopii w Twojej aplikacji ani w usługach nadrzędnych.
Przed uruchomieniem produkcyjnym ustal te szczegóły dla wybranej usługi:
- Role administratora i podmiotu przetwarzającego oraz umowa powierzenia przetwarzania mająca zastosowanie.
- Podprocesorzy hostingu i modelu oraz lokalizacje przetwarzania.
- Czy dane wejściowe i wyjściowe dostawcy mogą być przechowywane lub wykorzystywane do treningu.
- Kategorie logów, okresy przechowywania i wyjątki dotyczące incydentów.
- Przechowywanie kopii zapasowych i propagacja usunięć.
- Kontrole dostępu, dostęp audytowy i ustalenia dotyczące kontaktu w razie incydentu.
To fakty dotyczące wdrożenia i umowy. Sam kod nie może zweryfikować ich wszystkich.
Usunięcie konta
Użyj samoobsługowego procesu usuwania konta. Implementacja z chwilą rozpoczęcia usuwania odcina dostęp i unieważnia dane uwierzytelniające; zdalne prace porządkowe mogą pozostać w toku. Informacja o prywatności wyjaśnia pozostałe zapisy operacyjne i prawne oraz przechowywanie przez podmioty trzecie.
Usunięcie konta Synderesis nie usuwa kopii zapisanych we własnej aplikacji, wyeksportowanych plików ani niezależnie przechowywanych zapisów dostawcy. Przekaż swoim użytkownikom jasny opis własnego procesu przechowywania i usuwania w aplikacji.
Granice wdrożenia
Firma z UE lub funkcja aplikacji we Frankfurcie nie jest dowodem na to, że cała inferencja, wszystkie logi i całe przetwarzanie sieciowe pozostają w UE. Trasy modeli oraz ustalenia dotyczące prywatnego wdrożenia mogą się różnić.
W przypadku wdrożenia, które wymaga określonego checkpointu poddanego ponownemu treningowi, prywatnej infrastruktury, ograniczeń rezydencji, działania offline lub dedykowanej granicy izolacji, uzyskaj wyraźne, zweryfikowane uzgodnienie. Ten przewodnik API nie przyznaje tych właściwości standardowemu hostowanemu punktowi końcowemu.
Obsługa źródeł i odpowiedzi
Traktuj prompty użytkownika, pobrany tekst i wyniki narzędzi jako niezaufane dane wejściowe. Bezpiecznie renderuj wyjście modelu, waliduj argumenty narzędzi i pozostaw decyzje o istotnych skutkach pod odpowiednią władzą człowieka lub aplikacji.
Katolickie ukierunkowanie opisuje zamierzony kierunek modelu. Nie gwarantuje ono, że każda odpowiedź lub każde cytowanie jest poprawne. Natywne metadane odpowiedzi opisują pobrany kontekst; nie ustanawiają one w pełni zweryfikowanej, ustrukturyzowanej odpowiedzi doktrynalnej.