コネクタの設定方法

Tulipでコネクタを構成する詳細を理解してください。

この記事では、*コネクタの構成方法*構成モーダルの各入力の意味について学びます。

概要

コネクタは、外部システムとデータベース間の統合を可能にします。この記事で説明するコネクタにはHTTPと SQLの2種類があります。

コネクタがどのような概念と詳細を包含するかを正確に知るために、"コネクタとは何か"の記事をチェックしてください。

新しいコネクタの設定方法

新しいコネクタを設定するのに、API やデータベースに関する広範な知識は必要ありませんが、接続タイプに精通していることは役立ちます。

コネクタを作成するには、Apps の下のConnectorsページに移動します。右上の**［+ Create Connector**］をクリックします。コネクタに名前を付けて説明を付け、HTTP接続かSQL接続かを選択します。覚えておいてください：HTTPコネクタはAPIサーバに統合し、SQLコネクタは外部データベースに接続します。

**Create Connector］**モーダルで［**Create］**ボタンをクリックすると、そのコネクタのホームページに移動します。

ここで、このコネクタが現在オフラインであることを示す赤い通知が表示されます。

コネクタをオンラインにするには、［Production & Testing & Development］ボタンをクリックして、接続するサーバを指定する必要があります。

事前に知っておくべきこと

作業を開始する前に、HTTP コネクタと SQL コネクタの両方に認証パラメータがあり、エンドポイントまたはデータベースへのリクエストを行うすべての人にその権限があることを確認することが重要です。これらの措置は、データを保護し、安全なアクセスを保証するために設けられています。

以下のセクションでは、HTTP と SQL コネクタの両方を設定する方法を説明します。

HTTP

HTTPコネクタはAPIサーバと通信します。TulipのHTTPコネクタは、RESTやSOAPを含むほとんどのタイプのAPIとインターフェイスします。

設定

コネクタを設定するには、接続しようとしているサーバに関するいくつかの情報を用意しておく必要があります。これらには以下が含まれます：

• ホストURL
• サーバがTLSを使用しているかどうか
• 認証に必要なヘッダやCert

これらの情報は、接続先のサーバーのAPIドキュメントで見つけることができる。一般的には、"[サーバー名] API documentation "を検索する必要がある。

では、この設定方法を紐解いていこう：

設定モード

Running On- コネクタホストへのリクエストを行います。Cloud ConnectorホストはTulipによって提供され、Tulip Cloud経由でリクエストを行います。ホスト- Tulipが接続するネットワーク・アドレス（ホスト名またはIPアドレス）です。ポート- サーバーは、サーバー・プロバイダが提供する特定のネットワーク・ポートでリクエストをリッスンします。TLS (Transport Layer Security)- TulipはTLSを使用して、サーバーに接続する際のトラフィックを暗号化します。httpsで始まるURLはTLSです。

認証

証明書 (Certificate) - サーバー証明書は、セッション開始時にサーバーからクライアントに送信され、クライアントがサーバーを認証するために使用します。証明書 (Certificates)- サーバー証明書は、セッション開始時にサーバーからクライアントに送信され、クライアントがサーバーを認証するために使用します。

HTTP コネクタでは、以下の認証タイプを使用できます：

No Auth- 認証不要、または x-auth-token のような他のリクエストヘッダ内で認証を行います。Basic Auth- 基本認証で、ユーザー名とパスワードを共有します。OAuth 2 (Bearer token)- ベアラートークンは、主に使用されるアクセストークンのタイプで、不透明な文字列で構成され、それを使用するクライアントが意味を持つことは意図されていません。OAuth 2 (Operator)- 一般的に、ユーザーに代わって限られたリソースへのアクセスを必要とするクライアントに使用されます。例えば、ユーザーの連絡先やカレンダーイベントへのアクセスを必要とするモバイルアプリなどです。このロールは、クライアントに特定のリソースのサブセットのみへのアクセスを許可します。OAuth 2 (Admin)- より広範なリソースや管理機能へのアクセスを必要とするクライアントに使用されます。このロールは、クライアントにユーザのアカウントとリソースへの広範なアクセスを許可します。例えば、OAuth 2 (Admin) アクセス権を持つクライアントは、ユーザーのアカウント設定の管理、リソースの作成または削除、その他の管理タスクを実行することができます。OAuth 1.0- 主にウェブワークフローを処理する OAuth の旧バージョン。

:::(Info) (注）ヘッダーと証明書は後で設定できます。ヘッダーはコネクター機能で設定することもできます：

HTTP コネクタの詳細については、「HTTP コネクタの概要」を参照してください。

SQL

SQL コネクタは、外部データベースと通信します。コネクタのセットアップは非常に簡単ですが、迅速かつシームレスに行うにはいくつかの情報が必要です。

セットアップ

SQLコネクタを設定するには、以下の情報が必要です：
* SQLデータベースの種類 * サーバーのURL * サーバーがTLSを使用しているかどうか * 認証用のユーザー名とパスワード

それでは、この設定方法を紐解いていきましょう：

構成モーダル

Running On- コネクタホストへのリクエストを行います。Cloud ConnectorホストはTulipによって提供され、Tulip Cloud経由でリクエストを行います。アカウントに登録されているオンプレミスのコネクタホストも表示されます。Type- 接続するSQLデータベースのタイプ。Microsoft SQL Server、MySQL、PostgreSQL、OracleDBのいずれかを選択します。サーバー- Tulipが接続するネットワークアドレス（ホスト名またはIPアドレス）。ポート- サーバーは、サーバープロバイダーが提供する特定のネットワークポートでリクエストをリッスンします。SSL（Secure Sockets Layer）- クライアントアプリケーションとサーバーを実行するインスタンス間の接続を暗号化するために使用します。データベース- データベースの名前。ユーザー- データベースのユーザー名。パスワード- データベースのパスワード。

認証

SQL の認証プロセスには、接続するデータベースのユーザー名とパスワードのログイン認証情報が必要です。

SQL コネクタの詳細については、[SQL コネクタの概要]を参照してください。

コネクタのオンライン化

すべてのフィールドを正しく入力したら、Configuration Modal の右下にあるTestボタンをクリックします。コネクタはサーバへの接続をテストし認証するために数秒かかります。構成中に正確な情報を入力すると、ステータスがオンラインに変わります。

コネクタがまだオフラインと表示される場合は、入力した情報を確認し、正しいことを確認してください。

詳細については、「コネクタのトラブルシューティング」ガイドも参照してください。

その他の情報

• Tulipコネクタホスト入門

お探しのものは見つかりましたか？

community.tulip.coで質問を投稿したり、他の人が同じような質問に直面していないか確認することもできます！