このページの内容

Zoho Creatorで、コネクションを作成し、認証を行って、標準およびカスタムコネクターを使用し、他のサードパーティサービスと連携する方法について説明します。

コネクション作成の手順

メモ: 支払いワークフローは現在、Zoho決済が提供する決済サービスに依存しています。すべての支払いサービスは「Microservices > Operations > 決済サービス」に移動されました。PayPal、PayflowPro、Payments Proの既存バージョンは2024年9月26日をもってサポート終了となり、この日付以降は支払い取引の処理は行われません。支払い処理を中断なくご利用いただくために、最新バージョンへの移行をお願いします。詳細はこちら

1. 左側のペインからMicroservicesに移動し、+新しく作成するをクリックします。
   
2. 外部連携の下にあるPick & 作成をクリックします。組み込みコネクターの一覧がカード形式で表示されます。
   
3. コネクション作成に必要なサービスのコネクターを選択します。
メモ:必要なサービスが組み込みコネクターの一覧にない場合は、カスタムコネクターを作成し、続行してください。


4. Connection 名前はコネクター選択時に自動作成されます。編集したい場合は箱をクリックしてください。認証レベルを選択します。
   同じコネクターで複数の外部連携がある場合、命名形式は次のようになります：<サービス-名前> [スペース] Connection .

メモ: 要件に応じて、次の認可レベルのいずれかを選択できます。

1. Administrator: このオプションを選択すると、アプリケーションの管理者およびスーパ管理者のみが接続の認証を行う権限を持ちます。一般ユーザーや管理者以外のロールは接続の認証はできませんが、管理者の認証を通じて利用することができ、接続は管理者用接続となります。
   
2. Any ユーザー: このオプションを選択した場合、ログインしているユーザーであれば役割に関係なく接続の認証が可能です。管理者用外部連携とは異なり、これらの外部連携はログインしている各ユーザーごとに個別認証が可能となり、実行したユーザーの認可に基づいて連携を行います。つまり、管理者と一般ユーザーの両方が接続の認証を付与でき、接続はログインユーザー用接続となります。ログインユーザー外部連携は一部のビルトインコネクタでのみ作成可能です。
5. OAuth2タイプ認証のコネクター用認証情報を設定する際、接続を作成する前にスコープの選択が求められます（下図参照）。すべて処理を選択するか、特定処理のみを選択してサービスが実行する処理を指定できます。
   


メモ: 認証情報ですべて処理へのアクセスを有効にした場合、スコープ内のすべてのタブが選択された状態になります。タブの選択解除はできません。 

6. 初期設定では、すべての環境で同じ認可が使用されますが、各環境で異なる認可を使用するのチェックボックスをオンにすると、設定が変更されます。 
   
   ユーザーに各環境で異なる認証情報を使ってアプリケーションを認証させたい場合は、チェックボックスを選択してください。クリックこちらで、各環境ごとに異なる認可を使用する方法についてご覧いただけます。。
   
   

7. 「作成および認証」をクリックします。
   
   
8. 表示されたポップアップに認可情報を入力してください。各環境で異なる認可を使用する場合は、認可を申請する環境を選択してください。「認証」をクリックすると、接続が作成され、認証を求められます。
   
   
メモ:サードパーティサービスの認証に必要な認証情報は、対象サービスがサポートしている認証種別に基づいています。
ビルトインコネクターの場合、サービスで必要なパラメーターは事前に設定されています。外部連携を作成する際は、ご自身の認証情報を入力するだけで構いません。
カスタムコネクターの場合は、カスタムコネクター作成時にサービスで必要なパラメーターを設定 する必要があります。設定したパラメーターは、カスタムコネクターによる接続認証時に項目として表示されます。利用中の認証種別に応じて、カスタムコネクターの認証方法に違いが生じます。
9. 認証申請が必要な環境を選択します。 認証をクリックし、続けて選択したサービスへの認証アクセスを進めてください。
メモ:接続作成時に各環境ごとに異なる認証を使用のチェックボックスを選択しない場合、認証はすべての環境で同じ内容となります。そのため、すべての環境が初期設定で自動的に選択されます。
10. OAuth2の場合、認証をクリックすると、サードパーティサービスの認証ページにリダイレクトされます。
    
11. 認証情報を入力し、90秒の制限時間内にアクセス権限を承認してください。
    
    

認証完了後、接続はアプリケーション内で使用可能となります。例えば、Zoho Creatorの項目「仕入先名」からQuickBooksアカウントの販売者タブへ、フォーム送信のたびにデータをプッシュしたい場合、フォームのワークフローにおける連携処理を用いて実現できます。その際は、QuickBooks接続を作成し、該当アカウントの認証情報で認証し、連携操作の設定時に外部連携項目へ指定してください。他のアプリケーションユーザーも、接続作成時に設定した認可レベルに基づき、認証および接続の利用が可能です。

カスタムコネクターの認証方法の違い

カスタムコネクター作成時に利用する認証種別によって、認証方法が異なります。いくつかの例を見てみましょう。

1. 基本 authenticationタイプのサービスであるAtlassianは、接続を確立するためにユーザー名とパスワードが必要です。Atlassianの場合、ユーザー名はメールアドレス、パスワードは認証トークンとなります。これらはカスタムコネクター作成時にパラメーターとして設定します。設定したパラメーターは、接続の認可時にユーザーから認証情報を取得する項目として表示されます。各環境ごとに異なる認証を使用する場合は、続くポップアップで環境を選択してください。
   
   
   
2. APIキー authenticationタイプのサービスである開く Weatherは、接続の確立にAPIキーが必要です。基本コネクターと同様に、カスタムコネクター作成時に設定する必要があります。
   
3. OAuth1 authenticationサービスのTrelloでは、接続認可レベルの選択が必要です。
   
   
1. 各環境ごとに異なる認証を使用する場合は、続くポップアップで環境を選択してください。「認証」をクリックすると、サービス（Trello）の認可ページにリダイレクトされ、要求されている権限へのアクセス許可が必要になります。
4. OAuth2 authenticationサービスのDropboxでは、接続認可レベルの選択が必要です。
   
   
1. 各環境ごとに異なる認証を使用する場合は、続くポップアップで環境を選択してください。「認証」をクリックすると、サービス（Dropbox）の認可ページにリダイレクトされ、要求されている権限へのアクセス許可が必要になります。
   

ご注意いただきたいポイント

1. 外部連携の作成は管理者のみ可能です。
2. System 外部連携は、スーパー管理者、管理者、または開発者によって認証できます。
3. Logged-in ユーザー 外部連携は、C6でのみ作成可能です。
4. データソースやlogged-in ユーザー 外部連携でスケジューラを作成する場合、統合されたサービスを単一のアカウントで管理するため、プライマリーアカウントの入力が必須です。
5. カスタムコネクタを使用して作成した外部連携は、Delugeのinvoke URLタスクでのみ利用でき、特定のシナリオやワークフローに応じて該当する操作APIを指定します。こちらの例を参考に、接続済みDropboxアカウントからファイルを取得するinvoke URLタスクの使い方をご確認ください。
6. アプリケーションで外部連携が使用されている場合、有効モードおよび編集モードで表示や認証も可能です。こちらをクリックすると、有効モード・編集モードでの外部連携のアクセス方法について詳しくご覧いただけます。
   

関連リンク

1. 外部連携について理解する
2. 外部連携の管理
3. 有効モード・編集モードでのConnection
4. コネクタについて理解する