Tworzenie połączeń i zarządzanie nimi

Połączenie to zapisana konfiguracja, która pozwala PlaidCloud dotrzeć do systemu zewnętrznego — bazy danych, jeziora danych, ERP, REST API, usługi chmurowej lub dostawcy Git. Kroki przepływu pracy odwołują się do połączenia po nazwie, więc szczegóły punktu końcowego i poświadczenia znajdują się w jednym miejscu i są używane we wszystkich krokach i projektach, które ich potrzebują.

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

Tworzenie połączenia

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 pojawia się na liście jako należące do Ciebie.

Notatka

Lista typów połączeń i pól wymaganych dla każdego z nich znajduje się w dokumentacji referencyjnej konektorów. Dla usługi bez dedykowanego konektora użyj Generic REST Connection.

Formularz połączenia

Większość połączeń otwiera formularz z wieloma kartami. Dokładne karty zależą 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; 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 hosta pośredniczącego 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 przy zapisie zachowuje przechowywany sekret. Wpisz wartość ponownie tylko wtedy, gdy chcesz ją zmienić. Dotyczy to klucza API połączenia REST, klucza tajnego 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 taki sam sposób i są maskowane podczas wpisywania lub wklejania. Zamiennik składający się wyłącznie ze spacji jest odrzucany, zamiast nadpisać przechowywane poświadczenie; wyczyść pole, aby zachować zapisaną wartość. Klucz klienta SSL oraz klucz prywatny SSH połączenia SQL lub Git też są tylko do zapisu, ale pozostają widoczne podczas ich wpisywania. Każde inne pole pokazuje swoją rzeczywistą zapisaną wartość wszędzie tam, 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 jest wyłącznie rzeczywiste poświadczenie.

Przez REST API i MCP pole poświadczenia podlega tej samej regule co edytor: 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.

Wymagane pola są walidowane przy zapisie; jeśli czegoś brakuje, formularz przełącza się na kartę zawierającą pierwsze nieprawidłowe pole i je oznacza.

Model zabezpieczeń

Security Model w połączeniu kontroluje, kto w obszarze roboczym może go używać:

Opcja	Kto może używać 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 listy — Members dla Specific Members Only lub Groups dla Specific Security Groups Only, a także Agents i Owners, każda z tych opcji otwiera selektor z dwiema listami do dodawania i usuwania dostępu. Dostęp może tam zmieniać tylko 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, bez jego zmiany. 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.

Środowiska

Połączenie może przechowywać inną konfigurację dla każdego środowiska (na przykład host deweloperski i produkcyjny pod jedną nazwą połączenia). Selektor środowiska na pasku narzędzi wybiera, której konfiguracji środowiska używasz do przeglądania i edycji.

• New Environment — dodaje środowisko połączenia
• Edit Environment — zmienia nazwę wybranego środowiska
• Delete Environment — usuwa wybrane środowisko

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

Notatka

Zapisanie konfiguracji scala ją z przechowywaną dla tego środowiska, więc puste sekrety tylko do zapisu nigdy nie są nadpisywane pustymi wartościami.

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

Edytowanie połączenia

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

Testowanie połączenia

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 za pomocą wprowadzonych poświadczeń i zgłasza sukces (wraz z wersją osiągniętego serwera) 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.
• Generic REST Connection ma kartę Testing, która wysyła doraźne żądanie przez zapisane połączenie.

Zapisz połączenie przed testowaniem — testy działają na zapisanej konfiguracji.

Notatka

Testuj połączenie pojawia się dla danego rodzaju połączenia, gdy jego edytor to oferuje — obecnie dla wymienionych wyżej typów baz danych oraz TM1, Oracle Essbase, HFM/FCCS, Salesforce i Anaplan. Inne połączenia REST, takie jak NetSuite, jeszcze go nie mają — przetestuj je, wysyłając małe żądanie z kroku przepływu pracy (dla NetSuite zobacz Połączenie z NetSuite).

Klonowanie, usuwanie i śledzenie użycia

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

Uwaga

Edit, Clone i Delete są dostępne tylko dla połączeń, których jesteś właścicielem. Jeśli te akcje są wyszarzone dla wybranego wiersza, nie jesteś właścicielem — poproś właściciela o wprowadzenie zmiany lub o dodanie Cię przez Owners.

Powiązane

• Dokumentacja referencyjna konektorów — pełny katalog obsługiwanych systemów i ich pól.
• Klonowanie połączenia
• Źródła Singer