Sekrety i klucze API
Sekrety to zaszyfrowany sejf firmy na klucze API i tokeny używane przez obiegi. Obieg zna tylko nazwę sekretu, wartość zostaje na serwerze, a sekret może wyjść wyłącznie przez HTTPS na hosty, które wskażesz.
Na tej stronie
Jak działa sejfDodawanie sekretuUżycie sekretu w obieguZmiana i usuwanieUprawnieniaBitee AIGdy obieg łączy się z zewnętrznym systemem (CRM, kurier, system księgowy, własne API), potrzebuje klucza. Klucza nie wpisuj w akcję obiegu: zapisz go w Sekretach i odwołaj się do niego nazwą, np. {{secret:CRM_TOKEN}}. Dzięki temu klucz nie leży jawnie w definicji obiegu, w jego historii, w dzienniku zdarzeń, w kolejce zadań ani w tym, co widzi Bitee AI.
Jak działa sejf#
| Cecha | Co to znaczy w praktyce |
|---|---|
| Tylko zapis | Po zapisaniu nikt nie odczyta wartości, także administrator. Panel pokazuje jedynie końcówkę długich kluczy (np. …b202), żeby rozpoznać, który to klucz. Wartość można tylko zastąpić nową |
| Szyfrowanie | Wartość jest szyfrowana kluczem platformy (AES-256-GCM) przed zapisem do bazy |
| Przypięcie do hostów | Każdy sekret ma listę hostów, na które wolno go wysłać. Obieg, który spróbuje wysłać go gdzie indziej, zatrzyma się z błędem, nawet jeśli ktoś podmieni adres w akcji |
| Tylko HTTPS | Sekret nigdy nie wychodzi zwykłym http:// |
| Bez śladów | Wartość nie trafia do historii obiegu, dziennika zdarzeń, kolejki, komunikatów błędów ani do Bitee AI. Jeśli zewnętrzne API odeśle klucz w odpowiedzi, jest on wycinany, zanim odpowiedź trafi do zmiennych |
| Osobno dla każdej firmy | Sekrety jednej firmy są niewidoczne dla innych firm na platformie |
Dodawanie sekretu#
- Kliknij Dodaj sekret.
- Nazwa (referencja w obiegu): wielkie litery, cyfry i podkreślnik, zaczyna się od litery, np.
CRM_TOKEN,KURIER_API_KEY. Pod polem od razu widzisz gotową referencję, np.{{secret:CRM_TOKEN}}. Nazwy nie da się później zmienić, bo odwołują się do niej obiegi. - Wartość: wklej klucz z systemu zewnętrznego. Pole odrzuca spacje na początku i końcu oraz znaki nowej linii, bo to prawie zawsze błąd wklejenia.
- Hosty, na które wolno wysłać sekret: jeden na linię, bez
https://i bez ścieżki, np.api.mojcrm.plalbo*.kurier-przyklad.pldla wszystkich subdomen. Zbyt szerokie wzorce (np.*.com.pl) są odrzucane. - Opis (opcjonalnie): do czego służy klucz, np. „Token API konta produkcyjnego”.
- Kliknij Zapisz.
Użycie sekretu w obiegu#
Sekret wstawiasz w akcji Wywołanie REST API na dwa sposoby:
- Wybór z listy: przy polu wartości (np. Token w zakładce Auth) kliknij przycisk
(x)i wybierz kategorię Sekrety firmy. Lista pokazuje nazwy sekretów i hosty, na które wolno je wysłać. - Wpisanie referencji: w nagłówku, parametrze adresu albo treści wpisz
{{secret:NAZWA}}, np. nagłówekAuthorizationz wartościąBearer {{secret:CRM_TOKEN}}.
| Gdzie w akcji | Dozwolone | Uwagi |
|---|---|---|
| Zakładka Auth (Bearer, Basic, klucz API) | tak | Najprostsza droga. Prefiks Bearer dokleja system |
| Headers (nagłówki) | tak | Np. X-Api-Key: {{secret:KURIER_API_KEY}} |
| Params (parametry adresu) | tak | Wartość jest kodowana do adresu |
| Body (treść JSON) | tak | Wartość jest poprawnie escapowana w JSON |
| Host albo ścieżka adresu | nie | Sekret zmieniałby adres docelowy, więc obieg go odrzuci |
Zmiana i usuwanie#
- Zmień zastępuje wartość nową (rotacja klucza). Obiegi działają dalej bez edycji, bo odwołują się do nazwy. Możesz też poprawić hosty i opis.
- Ikona kosza usuwa sekret. Obiegi, które go używają, zatrzymają się z błędem „sekret nie istnieje”. Wartości nie da się odzyskać.
- Lista pokazuje ostatnią zmianę wartości i ostatnie użycie przez obieg, dzięki czemu łatwo znaleźć klucze, których nic już nie używa.
Uprawnienia#
Dostęp nadajesz w rolach i uprawnieniach na module Integracje → Sekrety i klucze API: widoczność i odczyt listy, dodawanie, zmiana, usuwanie. Moduł pojawia się w menu dopiero, gdy rola ma do niego prawo widoczności. Osoba, która tylko buduje obiegi, nie potrzebuje dostępu do Sekretów: lista nazw w edytorze obiegu jest dostępna z samym prawem do obiegów, a wartości i tak nikt nie widzi.
Bitee AI#
Asystent Bitee AI wie, jak działa sejf. Zapytany o integrację z kluczem API, pokieruje do Integracje → Sekrety i podpowie referencję {{secret:NAZWA}}. Budując obieg w edytorze, sprawdza nazwy dostępnych sekretów (bez wartości) i wstawia je do akcji REST. Nie poprosi o wklejenie klucza do czatu.
Klucz zapisujesz raz w Sekretach, z listą hostów. W obiegu używasz nazwy: z listy „Sekrety firmy” albo jako {{secret:NAZWA}}. Wartości nie widzi nikt, nie trafia do logów ani do AI i wychodzi tylko przez HTTPS na wskazane hosty.