コネクターの概要
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
メモ: 従来の PayPal、PayflowPro、Payments Pro 連携は 2024 年 9 月 26 日をもってサポートを終了しており、この日付以降は支払い取引は処理されません。支払い処理を中断なくご利用いただくには、最新バージョンへ移行してください。詳細はこちら
概要
コネクターを使用すると、Zoho Creator アプリケーションとサードパーティサービスを連携できます。コネクターには特定のサービスに接続するために必要なプロパティが含まれており、処理を簡素化して安全な 接続を確立できます。
たとえば、アプリケーション内で支払いワークフローを作成するために PayPal と連携する必要がある状況を考えてみましょう。従来の方法では、API コールに必要なパラメーターを記述するコードを複数行作成する必要があります。PayPal は OAuth2 認証を採用しているため、トークンの有効期限が切れるたびにリフレッシュトークンを使用してアクセストークンを再生成する必要があります。これら一連の処理は、コネクターを使用することで自動化できます。
コネクターには、サービスとの接続を確立するために必要なパラメーターが設定されています。トークンの有効期限が切れると、自動的にトークンを再生成します。コネクターを一度作成すると、そのサービスとの複数の外部連携で再利用できます。また、認可パラメーターは Creator アカウントの管理者のみがアクセスできるため、安全に管理できます。
Zoho Creator では、コネクターは次の種類に分類されます:
組み込みコネクター
Zoho Creator には、Zoho Creator アプリケーションにあらかじめ設定されているコネクターが用意されています。これらのコネクターは、クラウドサービスに対して REST 操作を実行します。事前に設定されているため、簡単に利用でき、接続を作成してすばやく有効化できます。
メモ: 組み込みコネクターで作成した外部連携は、データソース、Deluge スクリプト（ワークフロー内）、および支払いワークフローで使用できます。
サポートされている組み込みコネクター一覧
Zoho Creator では、組織の一般的な業務要件を網羅する 1000 以上の組み込みコネクターをサポートしています。各コネクターのカテゴリ、サポートされる機能、データセンターでの提供状況などの詳細は、Zoho Creator の組み込みコネクターページで確認できます。
カスタムコネクター
メモ: この機能は C6 でのみ利用できます。
カスタムコネクターを使用すると、Zoho Creator アプリケーションを、組み込みコネクターに含まれていないその他のサードパーティクラウドサービスと連携できます。 基本認証や API キー、OAuth2 認証を使用するサービス向けに、独自のコネクターを設定できます。
コネクターを作成して接続を確立すると、Zoho Creator から対象サービスに対して REST 操作を実行するために利用できます。たとえば、Google の REST API を使用して Google Drive アカウントにアクセスするには、Google 用のカスタムコネクターを作成し、接続を確立して連携し、その接続を使用して、接続済みの Google アカウントに対して必要な連携処理を実行できます。
カスタムコネクター作成の流れ
対象サービスから API を取得する
カスタムコネクターを作成するには、対象サービスと通信するための API が必要です。これらの API は次のいずれかです。
- 公開 API - インターネット上で一般公開されているもの。例: Slack、Shopify、Dropbox など。
- 非公開 API - 組織やグループ内で利用するため、自社ネットワーク内からのみ参照できるもの。
API を定義する
認証付きで API を取得したら、カスタムコネクターを作成するために、その内容を定義する必要があります。カスタムコネクターの作成時に、カスタムコネクタービルダーで API パラメーターを指定できます。
カスタムコネクターを保護する
コネクターの保護には、次の標準的な認証方式のいずれかを使用できます。
- 基本認証 - ユーザー名とパスワードで認証し、サードパーティ API への接続を行う方式です。
- API キー認証 - API キーで認証し、サードパーティ API への接続を行う方式です。
- OAuth1 認証 - OAuth1 では、ユーザーは認証情報を共有することなく、サードパーティアプリケーションに自分のリソースへのアクセス権限を付与します。Creator アプリケーションは、サードパーティアプリケーションから提供されるアクセストークンを使用して、ユーザーのリソースにアクセスできます。OAuth1 は、Web ベースのアプリケーションとの連携に適しています。
- OAuth2 認証 - OAuth2 では、ユーザーはサードパーティ API のページにリダイレクトされ、アクセストークンとリクエストトークンを交換することで、長期的な認証情報や本人情報を開示せずに保護されたリソースへのアクセスを許可します。OAuth2 にはスコープがあり、Creator アプリケーションはユーザーから特定の権限を要求できます。また、Web ベース／非 Web ベースの両方のアプリケーションと高い互換性があります。
- Bearer トークン - この認証タイプでは、安全な Bearer トークンを使用してサードパーティ API に接続します。
- AWS - この認証タイプでは、署名バージョン 4 認証を使用して AWS サービスに接続します。
アプリでカスタムコネクターを使用する
メモ: カスタムコネクターを使用した外部連携は、特定のシナリオやワークフローにおいて、対象の操作 API を指定した Deluge の invoke URL タスクからのみ呼び出す必要があります。