Как настроить коннектор

Разберитесь в деталях настройки коннектора в Tulip.

В этой статье вы узнаете* Как настроить коннектор* Что означает каждый вход в конфигурационном модале

Обзор

Коннекторы позволяют осуществлять интеграцию между внешними системами и базами данных. Существует два типа коннекторов, которые мы рассмотрим в этой статье, - HTTP и SQL.

Ознакомьтесь со статьей "Что такое коннекторы?", чтобы точно знать, какие понятия и детали включает в себя коннектор.

Как настроить новый коннектор

Настройка нового коннектора не требует глубоких знаний об API или базах данных, однако знакомство с типами соединений будет полезным.

Чтобы создать коннектор, перейдите на страницу Connectors в разделе Apps. В правом верхнем углу нажмите кнопку + Создать коннектор. Назовите и опишите коннектор, а затем выберите тип соединения - HTTP или SQL. Помните: HTTP-коннектор подключается к API-серверу, а SQL-коннектор - к внешней базе данных.

После нажатия кнопки Create в модальном окне Create Connector вы попадаете на домашнюю страницу данного коннектора.

Здесь вы увидите красное уведомление о том, что данный коннектор в настоящее время находится в автономном режиме.

Для того чтобы коннектор перешел в режим онлайн, необходимо нажать кнопку Production & Testing & Development и указать сервер, к которому необходимо подключиться.

Что нужно знать заранее

Прежде чем приступить к работе, необходимо отметить, что как HTTP-, так и SQL-коннекторы имеют параметры аутентификации, позволяющие убедиться в том, что все, кто делает запрос к конечной точке или базе данных, имеют на это разрешение. Эти меры применяются для защиты данных и обеспечения безопасного доступа.

В следующих разделах описано, как настроить HTTP- и SQL-коннекторы.

HTTP

HTTP-коннектор взаимодействует с серверами API. HTTP-коннекторы Tulip взаимодействуют с большинством типов API, включая REST и SOAP.

Настройка

Для настройки коннектора необходимо иметь под рукой несколько сведений о сервере, к которому вы пытаетесь подключиться. К ним относятся:

• URL-адрес хоста
• Использует ли сервер TLS
• Любой заголовок или Cert, необходимый для аутентификации.

Эту информацию можно найти в документации по API сервера, к которому осуществляется подключение. Обычно для этого требуется выполнить поиск по запросу "[имя сервера] API documentation".

Давайте разберемся, как выполнить эту конфигурацию:

Модальная конфигурация

Running On - Выполнять запросы к хосту коннектора. Хост Cloud Connector предоставляется компанией Tulip и выполняет запросы через Tulip Cloud. Любой локальный хост коннектора, который вы зарегистрировали в своей учетной записи, также будет отображаться.Хост - Сетевой адрес, т.е. имя хоста или IP-адрес, к которому подключается Tulip.Порт - Ваш сервер принимает запросы на определенном сетевом порту, который предоставляет вам ваш серверный провайдер. Почти всегда подходит значение по умолчанию.TLS (Transport Layer Security) - Tulip использует TLS для шифрования вашего трафика при подключении к серверу. Если url начинается с https, то это TLS.

Аутентификация

Headers - обеспечивает аутентификацию происхождения данных, целостность данных и защиту от повторного воспроизведения.Certs (Certificates) - сертификат сервера посылается клиенту в начале сеанса и используется клиентом для аутентификации сервера.

Для HTTP-коннекторов доступны следующие типы аутентификации:

No Auth - аутентификация не требуется, либо аутентификация осуществляется в других заголовках запроса, например x-auth-token.Basic Auth - базовая аутентификация, используется имя пользователя и пароль.OAuth 2 (Bearer token) - токены Bearer Tokens являются преобладающим типом используемых токенов доступа, они состоят из непрозрачной строки, которая не должна иметь значения для использующих ее клиентов.OAuth 2 (Operator) - обычно используется для клиентов, которым требуется доступ к ограниченному набору ресурсов от имени пользователя. Например, мобильное приложение, которому требуется доступ к контактам или событиям календаря пользователя. Данная роль предоставляет клиенту доступ только к определенному подмножеству ресурсов, и пользователь должен явно предоставить клиенту разрешение на доступ к этим ресурсам.OAuth 2 (Admin) - используется для клиентов, которым требуется доступ к более широкому кругу ресурсов или административных функций. Эта роль предоставляет клиенту широкий доступ к учетной записи и ресурсам пользователя. Например, клиент с доступом OAuth 2 (Admin) может управлять настройками учетной записи пользователя, создавать или удалять ресурсы, а также выполнять другие административные задачи.OAuth 1.0 - предыдущая версия OAuth, которая в основном работает с веб-процессами.

:::(Info) (ПРИМЕЧАНИЕ) Заголовки и сертификаты можно настроить позднее. Заголовки также могут быть настроены в функции коннектора:

Более подробную информацию о HTTP-коннекторах можно найти в статье An Overview of HTTP Connectors.

SQL

Коннектор SQL обеспечивает взаимодействие с внешними базами данных. Настройка коннектора достаточно проста, но для того, чтобы сделать ее быстрой и беспроблемной, необходимо иметь под рукой несколько сведений.

Настройка

Для настройки SQL-коннектора вам потребуется следующая информация:
* Тип базы данных SQL * URL-адрес сервера * Использует ли сервер TLS * Ваше имя пользователя и пароль для аутентификации.

Давайте разберемся, как выполнить эту настройку:

Модальная конфигурация

Running On - Выполнение запросов к хосту коннектора. Хост Cloud Connector предоставляется компанией Tulip и выполняет запросы через Tulip Cloud. Любой локальный хост коннектора, зарегистрированный в вашей учетной записи, также будет отображаться.Type - Тип базы данных SQL, к которой вы хотите подключиться. Выберите Microsoft SQL Server, MySQL, PostgreSQL или OracleDB.Сервер - Сетевой адрес, имя хоста или IP-адрес, к которому подключается Tulip.Порт - Ваш сервер принимает запросы на определенном сетевом порту, который предоставляет поставщик сервера.SSL (Secure Sockets Layer) - Используется для шифрования соединений между клиентскими приложениями и экземплярами сервераБаза данных - Имя вашей базы данныхПользователь - Имя пользователя для базы данныхПароль - Пароль для базы данных.

Аутентификация

Процесс аутентификации для SQL требует ввода имени пользователя и пароля для базы данных, к которой вы хотите подключиться.

Более подробную информацию о коннекторах SQL можно найти в разделе [An Overview of SQL Connectors].

Запуск коннектора в работу

После того как все поля введены правильно, нажмите кнопку Test в правой нижней части окна Configuration Modal. Коннектору потребуется несколько секунд для проверки и сертификации соединения с сервером. Если в процессе конфигурирования была введена точная информация, статус изменится на Online.

Если коннектор по-прежнему отображается в режиме offline, просмотрите введенную информацию и убедитесь в ее правильности.

Дополнительную информацию можно найти в нашем руководстве по устранению неисправностей коннекторов.

Дополнительное чтение

• Введение в узлы коннекторов Tulip

Вы нашли то, что искали?

Вы также можете зайти на community.tulip.co, чтобы задать свой вопрос или узнать, сталкивались ли другие с подобным вопросом!