コネクタの理解

コネクタの理解

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

メモ：
  1. 異なるデータセンターでホストされているサービスへの接続では、国境を越えたデータ転送が発生する場合があります。Zoho Creatorではデータを安全に処理しますが、続行する前に、組織のデータ所在地やコンプライアンス要件に適合していることを確認してください。
  2. PayPal、PayflowPro、Payments Proの既存バージョンは2024年9月26日に廃止され、この日以降、決済トランザクションは処理されません。決済処理を継続するには、最新バージョンに移行してください。詳細はこちら

概要

コネクターを使用すると、Zoho Creatorアプリケーションから外部サービスと通信できます。特定のサービスに接続するために必要なプロパティが含まれており、複雑さを軽減して、安全な接続を確立できます。

アプリケーションで決済ワークフローを作成するために、PayPalと接続する必要がある状況を考えてみましょう。従来は、API呼び出しに必要なパラメーターを記述するコードを何行も作成する必要がありました。PayPalではOAuth2認証が使用されているため、トークンの有効期限が切れるたびに、更新トークンを使用してアクセストークンを再生成する必要があります。この一連の処理は、コネクターを使用して自動化できます。

コネクターには、サービスとの接続を作成するために必要なパラメーターを設定します。トークンの有効期限が切れると、トークンは自動的に再生成されます。コネクターを作成すると、そのサービスへの複数の接続の作成に再利用できます。認証パラメーターにはCreatorアカウントの管理者のみがアクセスできるため、安全に管理できます。

Zoho Creatorのコネクターは次のように分類されます。
  1. 組み込みコネクター
  2. カスタムコネクター

組み込みコネクター

Zoho Creatorには、Zoho Creatorアプリケーション向けに事前設定されたコネクターが用意されています。これらのコネクターは、クラウドサービスからREST操作を実行します。事前設定されているため、簡単に使用でき、すばやく接続を作成できます。

Notesメモ：組み込みコネクターを使用して作成した接続は、データソース、ワークフロー内のDelugeスクリプト、および決済ワークフローで使用できます。 
プライベート環境でホストされるコネクター
組み込みコネクターには、ローカル環境でホストされるコネクターが含まれます。これにより、Zoho Creatorから社内ネットワーク内でホストされているサービスやデータベースに接続できます。クラウドベースのコネクターとは異なり、これらはパブリックインターネットを介して通信しません。代わりに、プライベートネットワーク内のマシンにインストールされたDatabridgeを通じてリクエストをルーティングします。

Notesメモ：ローカル環境でホストされるコネクターを使用するには、まずシステム連携でQntrlを設定し、Databridgeに関連付ける必要があります。Databridgeの設定の詳細をご確認ください。

ローカル環境でホストされるコネクターとして、次のデータベースコネクターがサポートされています。

データベース

対応バージョン

MySQL

5.x、8.x

PostgreSQL

14以降

Oracle Database

19c、21c

SQL Server

2019、2022
Notesメモ：新しいデータベースバージョンで必要な場合は、JDBCドライバーを更新または置き換えることができます。ローカル環境でホストされるコネクターは、対象データベーステーブルに自動増分の項目がある場合にのみ動作します。

対応している組み込みコネクターの一覧

Zoho Creatorでは、組織のあらゆるビジネス要件に対応する1,000以上の組み込みコネクターをサポートしています。カテゴリー、対応機能、データセンターの利用可否など、各コネクターの詳細は、Zoho Creatorの組み込みコネクターのページで確認できます。

カスタムコネクター

Notesメモ：この機能はC6でのみ利用できます。

カスタムコネクターを使用すると、Zoho Creatorアプリケーションを、組み込みコネクターでは利用できない他の外部クラウドサービスと連携できます。Basic、APIキー、OAuth2認証に対応したサービス向けに、独自のコネクターを設定できます。


コネクターを作成して接続を確立すると、Zoho Creatorから対象サービスに対してREST操作を実行できます。たとえば、GoogleのREST APIを使用してGoogle ドライブアカウントにアクセスするには、カスタムGoogleコネクターを作成し、接続を確立して接続します。その後、この接続を使用して、接続済みのGoogleアカウントに対して指定した連携を実行できます。

カスタムコネクター作成の流れ



対象サービスからのAPIの取得

カスタムコネクターを作成するには、対象サービスと通信するためのAPIが必要です。これらのAPIには次の種類があります。
  1. 公開 - インターネット上で一般公開されています。たとえば、Slack、Shopify、Dropboxなどです。
  2. 非公開 - 組織またはグループ内で使用するために、自社ネットワークからのみ表示できます。

APIの記述 

認証アクセス付きのAPIを取得したら、カスタムコネクターを作成するためにAPIを記述する必要があります。カスタムコネクターの作成中に、カスタムコネクタービルダーでAPIパラメーターを指定できます。

カスタムコネクターの保護 

コネクターを保護するには、次の標準認証方法のいずれかを使用できます。
  1. 基本認証- この方法では、ユーザー名とパスワードで認証することで、サードパーティAPIに接続できます。
  1. APIキー認証- この方法では、APIキーで認証することで、サードパーティAPIに接続できます。
  1. OAuth1認証- OAuth1では、ユーザーは認証情報を共有せずに、サードパーティアプリケーション内のリソースへのアクセス権限を付与できます。Creatorアプリケーションは、サードパーティアプリケーションから提供されるアクセストークンを使用して、ユーザーのリソースにアクセスできます。OAuth1は、Webベースのアプリケーションとの接続にのみ有効です。
  1. OAuth2認証- OAuth2では、ユーザーはサードパーティAPIのページにリダイレクトされます。そこで、要求トークンとアクセストークンを交換することで、長期的な認証情報やIDを必ずしも公開せずに、保護されたリソースへのアクセスが許可されます。OAuth2には、Creatorアプリケーションがユーザーに特定の権限を要求できるスコープが含まれており、Webベースと非Webベースの両方のアプリケーションとの互換性が高くなっています。
  2. ベアラートークン - この認証タイプでは、安全なベアラートークンで認証することで、サードパーティAPIに接続できます。
  3. AWS - この認証タイプでは、Signature Version 4認証を使用してAWSサービスに接続できます。

アプリでのカスタムコネクターの使用

APIへの接続を作成し、その接続をアプリで使用して、カスタムコネクターで公開した操作を呼び出す必要があります。接続の作成方法については、こちらをクリックしてください。
Notesメモ： カスタムコネクターを使用する接続は、特定のシナリオ／ワークフローで該当するアクションAPIを指定して、Delugeのinvoke URLタスクを使用してのみ呼び出す必要があります。 

関連トピック

  1. カスタムコネクターの作成
  2. カスタムコネクターの管理
  3. 接続の理解
  4. 接続の作成と認証