Jak skonfigurować złącze

Zrozum szczegóły konfiguracji konektora w Tulipie.

W tym artykule dowiesz się* Jak skonfigurować złącze* Co oznacza każde wejście w modalu konfiguracyjnym

Przegląd

Konektory umożliwiają integrację pomiędzy zewnętrznymi systemami i bazami danych. Istnieją dwa rodzaje konektorów, które omówimy w tym artykule: HTTP i SQL.

Zapoznaj się z artykułem "Czym są konektory?", aby wiedzieć, co dokładnie kryje się pod pojęciem konektora.

Jak skonfigurować nowy konektor

Konfiguracja nowego konektora nie wymaga rozległej wiedzy na temat API czy baz danych, ale przydaje się znajomość typów połączeń.

Aby utworzyć złącze, przejdź do strony Connectors w sekcji Apps. Kliknij + Create Connector w prawym górnym rogu. Nadaj nazwę i opis swojemu konektorowi, a następnie wybierz, czy jest to połączenie HTTP czy SQL. Pamiętaj: konektor HTTP integruje się z serwerem API, natomiast konektor SQL łączy się z zewnętrzną bazą danych.

Po kliknięciu przycisku Create na modalu Create Connector, zostaniesz przeniesiony na stronę główną dla tego konkretnego konektora.

Tutaj zauważysz czerwone powiadomienie, że ten konektor jest obecnie offline.

Aby konektor był online, musisz kliknąć przycisk Production & Testing & Development, aby określić serwer, z którym chcesz się połączyć.

Co należy wiedzieć wcześniej

Zanim zaczniesz, warto pamiętać, że zarówno konektory HTTP, jak i SQL posiadają parametry uwierzytelniania, aby upewnić się, że każda osoba zgłaszająca żądanie do punktu końcowego lub bazy danych ma do tego uprawnienia. Środki te zostały wprowadzone w celu ochrony danych i zapewnienia bezpiecznego dostępu.

Poniższe sekcje przedstawiają jak skonfigurować zarówno konektory HTTP jak i SQL.

HTTP

Złącze HTTP rozmawia z serwerami API. Tulip's HTTP Connectors interfejs z większością typów API, w tym REST i SOAP.

Konfiguracja

Aby skonfigurować złącze, musisz mieć pod ręką kilka informacji o serwerze, z którym próbujesz się połączyć. Należą do nich:

• Adres URL hosta (Host URL)
• Czy serwer używa TLS czy nie
• Wszelkie nagłówki lub certyfikaty niezbędne do uwierzytelnienia

Możesz znaleźć te informacje w dokumentacji API serwera, z którym się łączysz. Wymaga to na ogół wyszukania "[nazwa serwera] dokumentacja API".

Rozpakujmy, jak przejść przez tę konfigurację:

Konfiguracja Modal

Running On - Wykonaj żądania dotyczące hosta łącznika. Host Cloud Connector jest dostarczany przez Tulip i wykonuje żądania za pośrednictwem Tulip Cloud. Każdy on-premise connector host, który zarejestrowałeś na swoim koncie, również się pojawi.Host - Adres sieciowy, tj. nazwa hosta lub adres IP, z którym łączy się Tulip.Port - Twój serwer nasłuchuje żądań na określonym porcie sieciowym, który podaje Ci Twój dostawca serwera. Domyślny jest prawie zawsze w porządku.TLS (Transport Layer Security) - Tulip używa TLS do szyfrowania Twojego ruchu podczas łączenia się z serwerem. Jeśli adres url zaczyna się od https, to jest to TLS.

Uwierzytelnianie

{Certs (****{{glossary.Header}}s ) - Certyfikat serwera jest wysyłany z serwera do klienta na początku sesji i jest używany przez klienta do uwierzytelnienia serwera.

Dla konektorów HTTP dostępne są następujące typy uwierzytelniania:

No Auth - Uwierzytelnianie nie jest potrzebne lub uwierzytelnianie odbywa się w ramach innych nagłówków żądania, takich jak x-auth-token.Basic Auth - Podstawowe uwierzytelnianie, udostępnia nazwę użytkownika i hasło.OAuth 2 (Bearer token) - Tokeny Bearer są dominującym typem używanegotokena dostępu, składają się z nieprzejrzystego ciągu znaków, niezamierzonego, aby mieć znaczenie dla klientów, którzy go używają.OAuth 2 (Operator) - Zazwyczaj używany dla klientów, którzy wymagają dostępu do ograniczonego zestawu zasobów w imieniu użytkownika. Na przykład aplikacja mobilna, która wymaga dostępu do kontaktów użytkownika lub wydarzeń kalendarza. Ta rola przyznaje klientowi dostęp tylko do określonego podzbioru zasobów, a użytkownik musi wyraźnie przyznać klientowi pozwolenie na dostęp do tych zasobów.OAuth 2 (Admin) - Używana dla klientów, którzy wymagają dostępu do szerszego zakresu zasobów lub funkcji administracyjnych. Ta rola przyznaje klientowi szeroki dostęp do konta użytkownika i zasobów. Na przykład klient z dostępem OAuth 2 (Admin) może być w stanie zarządzać ustawieniami konta użytkownika, tworzyć lub usuwać zasoby lub wykonywać inne zadania administracyjne.OAuth 1.0 - Poprzednia wersja OAuth, która głównie obsługuje przepływy pracy w sieci.

:::(Info) (UWAGA) Nagłówki i certyfikaty można skonfigurować w późniejszym czasie. Nagłówki można również skonfigurować w funkcji złącza :::

Aby dowiedzieć się więcej o złączach HTTP, sprawdź An Overview of HTTP Connectors.

SQL

Złącze SQL komunikuje się z zewnętrznymi bazami danych. Konfiguracja konektora jest dość prosta, ale musisz mieć pod ręką kilka informacji, które sprawią, że będzie ona szybka i bezproblemowa.

Konfiguracja

Aby skonfigurować konektor SQL, należy podać następujące informacje:
* Typ bazy danych SQL * Adres URL serwera * Czy serwer używa TLS * Twoja nazwa użytkownika i hasło do uwierzytelnienia.

Rozpakujmy, jak poruszać się po tej konfiguracji:

Modal Konfiguracja.

Running On - Wykonaj żądania dotyczące hosta łącznika. Host Cloud Connector jest dostarczany przez Tulip i wykonuje żądania za pośrednictwem Tulip Cloud. Pojawi się również każdy on-premise connector host, który jest zarejestrowany na Twoim koncie.Type - Typ bazy danych SQL, z którą chcesz się połączyć. Wybierz pomiędzy Microsoft SQL Server, MySQL, PostgreSQL lub OracleDB.Serwer - Adres sieciowy, nazwa hosta lub adres IP, z którym łączy się Tulip.Port - Twój serwer nasłuchuje żądań na określonym porcie sieciowym, który został podany przez dostawcę serwera.SSL (Secure Sockets Layer) - Używany do szyfrowania połączeń pomiędzy Twoimi aplikacjamiklienckimi a instancjami serweraBaza danych - Nazwa Twojej bazy danychUżytkownik - Nazwa użytkownika dla bazy danychHasło - Hasło dla bazy danych

Autentykacja

Proces autentykacji dla SQL wymaga podania nazwy użytkownika i hasła dla bazy danych, do której chcesz się podłączyć.

Aby uzyskać więcej informacji na temat konektorów SQL sprawdź [Przegląd konektorów SQL].

Uruchomienie konektora online

Po poprawnym wypełnieniu wszystkich pól kliknij przycisk Test w prawym dolnym rogu okna konfiguracji. Konektor potrzebuje kilku sekund na przetestowanie i certyfikację połączenia z serwerem. Jeśli podczas konfiguracji wprowadzisz dokładne informacje, status zmieni się na Online.

Jeśli złącze nadal jest w trybie offline, przejrzyj wprowadzone informacje i upewnij się, że są poprawne.

Możesz również sprawdzić nasz przewodnik Troubleshooting Connectors, aby uzyskać więcej informacji.

Dalsze lektury

• Wprowadzenie do Tulip Connector Hosts

Czy znalazłeś to, czego szukałeś?

Możesz również udać się na stronę community.tulip.co, aby zadać swoje pytanie lub sprawdzić, czy inni spotkali się z podobnym pytaniem!