Przejdź do głównej zawartości

Tworzenie połączenia i zarządzanie nim

Połączenie to zapisana konfiguracja, która umożliwia PlaidCloud dostęp do systemu zewnętrznego — bazy danych, jeziora danych, systemu ERP, interfejsu REST API, usługi w chmurze lub dostawcy Git. Kroki przepływu pracy odwołują się do połączenia po nazwie, dzięki czemu szczegóły punktu końcowego i poświadczenia są przechowywane w jednym miejscu i używane ponownie w każdym kroku i projekcie, który ich potrzebuje.

Połączeniami zarządza się w sekcji Tools > Connections.

  1. Otwórz Tools > Connections
  2. Kliknij New Connection na pasku narzędzi i wybierz z menu system, z którym chcesz się połączyć
  3. Wypełnij formularz połączenia (karty i pola różnią się w zależności od typu — zobacz Formularz połączenia poniżej)
  4. Kliknij Create, aby zapisać

Nowe połączenie pojawi się na liście jako należące do Ciebie.

Połączenia Acumatica, Bill.com, Dynamics, Eclipse, HFM/FCCS, NetSuite, Workday i Workday Financials są zapisywane jako połączenia REST, a w kolumnie Typ na liście widnieje własny typ usługi. Każde otwiera się we własnym formularzu do tworzenia, edytowania i wybierania w krokach. Nagłówki, uwierzytelnianie i stronicowanie znajdują się w Edit REST settings, do którego przechodzi się z menu prawego przycisku myszy (zobacz Edytowanie połączenia).

Większość połączeń otwiera formularz z wieloma kartami. Dokładny zestaw kart zależy od typu, ale zwykle zobaczysz:

  • Konfiguracja połączenia (lub Szczegóły połączenia dla REST) — Name połączenia, opcjonalne Memo, host/port/baza danych (lub host/typ uwierzytelniania dla REST), przełącznik Usage (Active) oraz Security Model. W połączeniu z bazą danych poświadczenia znajdują się tutaj w grupie Dane uwierzytelniające, a w połączeniu REST mają własną kartę Uwierzytelnianie.
  • Konfiguracja SSL — Use SSL oraz tryb SSL i opcjonalne certyfikaty klienta/główne dla połączenia szyfrowanego.
  • Konfiguracja SSH — Use SSH oraz host bastionowy, port, użytkownik i klucz do tunelowania połączenia przez host przesiadkowy SSH.

Hasła, tokeny i inne pola poświadczeń są tylko do zapisu: po ponownym otwarciu zapisanego połączenia są puste, a pozostawienie ich pustych podczas zapisu zachowuje przechowywany sekret. Wpisz wartość ponownie tylko wtedy, gdy chcesz ją zmienić. Dotyczy to klucza API połączenia REST, sekretu klienta OAuth i tokenu odświeżania OAuth. Poświadczenia wielowierszowe — prywatny certyfikat NetSuite, certyfikat i klucz prywatny Anaplan, klucz API Postman, adres URL przychodzącego webhooka Slack lub Teams — są tylko do zapisu w ten sam sposób i są maskowane podczas wpisywania lub wklejania. Zamiennik składający się wyłącznie ze spacji jest odrzucany zamiast zapisywany w miejsce przechowywanego poświadczenia; wyczyść pole, aby zachować zapisaną wartość. Klucz klienta SSL i klucz prywatny SSH połączenia SQL lub Git również są tylko do zapisu, ale pozostają widoczne podczas ich wpisywania. Każde inne pole pokazuje rzeczywistą zapisaną wartość wszędzie, gdzie wyświetlane jest połączenie, w edytorze i przez API, w tym pola, które z nazwy wyglądają na wrażliwe (flaga tylko do odczytu bazy danych, identyfikator konta, schemat, nazwa hosta) — maskowane lub ukrywane są wyłącznie rzeczywiste poświadczenia.

W REST API i MCP pole poświadczeń podlega tej samej regule co w edytorze: wyślij pusty ciąg, a PlaidCloud zachowa przechowywaną wartość; wyślij null, aby ją wyczyścić. Każde pole niebędące poświadczeniem nadal jest czyszczone, gdy wyślesz je puste.

Pola wymagane są sprawdzane podczas zapisu; jeśli czegoś brakuje, formularz przełącza się na kartę zawierającą pierwsze nieprawidłowe pole i je oznacza.

Security Model połączenia określa, kto w obszarze roboczym może z niego korzystać:

Opcja Kto może korzystać z połączenia
Prywatne (tylko właściciele) Tylko właściciele.
Tylko wybrani członkowie Właściciele oraz jawna lista członków.
Tylko wybrane grupy zabezpieczeń Właściciele oraz członkowie wskazanych grup zabezpieczeń.
Wszyscy członkowie obszaru roboczego Wszyscy w obszarze roboczym.

Po wybraniu Specific Members Only lub Specific Security Groups Only przyznaj dostęp z menu Actions na liście — Members dla Specific Members Only lub Groups dla Specific Security Groups Only, a także Agents i Owners; każda z tych opcji otwiera listę kontrolną z filtrem, na której zaznaczasz, kto ma dostęp (zobacz Przypisywanie za pomocą selektora). Dostęp można tam zmienić tylko jako właściciel połączenia lub administrator obszaru roboczego. Każda inna osoba, która może edytować połączenia, może je otworzyć, aby zobaczyć, kto ma dostęp, na liście tylko do odczytu z osobami już przypisanymi. Administrator obszaru roboczego może zmienić dostęp do połączenia, którego nie jest właścicielem, aby przekazać je dalej, gdy jego właściciele odeszli.

Każdy, kto może korzystać z połączenia, może je otworzyć i zobaczyć jego ustawienia oraz przeglądać repozytoria, gałęzie i pliki połączenia Git. Hasła, tokeny i klucze połączenia nigdy nie są zwracane osobie, niezależnie od jej uprawnień: w REST API i MCP są zwracane zamaskowane, a w REST jako __redacted__, a w MCP jako <redacted>. Otrzymują je tylko konta usługowe: agenci PlaidLink oraz własne konto usługowe projektu, z którego korzystają program uruchamiający przepływy pracy i kod uruchamiany przez przepływ pracy, na przykład funkcja zdefiniowana przez użytkownika. Logowanie osoby nigdy ich nie otrzymuje. Odesłanie __redacted__ bez zmian zachowuje zapisaną wartość.

Zmiana miejsca, do którego połączenie wysyła swoje poświadczenia, na przykład jego hosta lub adresu URL tokenu, wymaga ponownego wprowadzenia tych poświadczeń. W przeciwnym razie zapisanie zmiany kończy się komunikatem wskazującym poświadczenia do ponownego wprowadzenia, a test zmienionych ustawień jest odrzucany w ten sam sposób.

Podczas przeglądania połączenia Git z adresem URL serwera innym niż zapisany wprowadź token dla tego serwera.

Połączenie może przechowywać inną konfigurację dla każdego środowiska (na przykład hosta deweloperskiego i produkcyjnego pod jedną nazwą połączenia). Selektor środowiska na pasku narzędzi wybiera, konfigurację którego środowiska przeglądasz i edytujesz.

  • New Environment — dodaje środowisko połączenia
  • Edit Environment — zmienia nazwę wybranego środowiska
  • Delete Environment — usuwa wybrane środowisko, gdy nie używa go żaden projekt, żaden krok nie ma go jako stałego środowiska i żaden agent go nie obsługuje. W przeciwnym razie komunikat podaje, co jeszcze go używa. Środowiska domyślnego nie można usunąć.

Kolumna Available na liście pokazuje, czy wybrane połączenie jest skonfigurowane dla wybranego środowiska.

Środowiska są współdzielone z agentami PlaidLink, więc środowisko projektu może przełączać agenta, który uruchamia jego zdalne kroki, a także połączenia, z których odczytuje. Zobacz Środowiska agentów.

  1. Zaznacz połączenie na liście
  2. Kliknij Edit na pasku narzędzi (lub kliknij wiersz prawym przyciskiem myszy)
  3. Zmień pola i kliknij Update

W przypadku połączenia Acumatica, Bill.com, Dynamics, Eclipse, HFM/FCCS, NetSuite, Workday lub Workday Financials Edit otwiera formularz właściwy dla tej usługi. Aby zmienić nagłówki, uwierzytelnianie lub stronicowanie bazowego połączenia REST, kliknij połączenie prawym przyciskiem myszy i wybierz Edit REST settings.

Sposób testowania zależy od typu:

  • Połączenia z bazami danych — Databricks, Snowflake, PostgreSQL i Redshift — mają w edytorze przycisk Testuj połączenie. Otwiera on połączenie z wprowadzonymi poświadczeniami i zgłasza powodzenie (wraz z wersją serwera, z którym nawiązano połączenie) lub przyczynę niepowodzenia, bez zamykania edytora, dzięki czemu możesz poprawić i ponowić próbę na miejscu.
  • Połączenia z bazami danych z SSH udostępniają też test tunelu SSH na karcie SSH Config.
  • Ogólne połączenie REST ma kartę Testing, która wysyła doraźne żądanie przez zapisane połączenie.

Zapisz połączenie przed testem — testy są wykonywane względem przechowywanej konfiguracji.

Adresy, do których połączenie nie może się odwoływać

Dział zatytułowany „Adresy, do których połączenie nie może się odwoływać”

Połączenie nie może wskazywać adresu pętli zwrotnej, adresu link-local ani adresu metadanych chmury. PlaidCloud sprawdza adres, na który rozwiązuje się nazwa hosta, podczas testowania połączenia i gdy używa go krok, a adres, który nie spełnia wymagań, kończy się błędem z nazwą hosta i adresem, na który został rozwiązany. Adresy w Twojej sieci prywatnej nie są objęte tym ograniczeniem.

  • Klonuj — duplikuje konfigurację połączenia jako podstawę nowego. Zobacz Klonowanie połączenia.
  • Usuń — usuwa wybrane połączenie z paska narzędzi (zostaniesz poproszony o potwierdzenie).
  • Gdzie używane… — wyświetla kroki przepływu pracy, które odwołują się do połączenia, aby można było zobaczyć skutki przed jego edycją lub usunięciem.

To samo dotyczy REST API, JSON-RPC oraz asystenta AI lub MCP: zmiana ustawień połączenia wymaga, abyś był jego właścicielem, albo administratorem obszaru roboczego w przypadku połączenia bez właściciela. Włączanie, wyłączanie, blokowanie i odblokowywanie połączenia wymaga właściciela lub administratora obszaru roboczego. Żądanie wskazujące kilka połączeń jest stosowane tylko wtedy, gdy możesz zmienić każde z nich.