このページで提供する情報は何ですか？

Zoho Creatorにおけるコネクションを確立し、それを認証して他のサードパーティのサービスと連携する方法を、ビルトインおよびカスタムコネクタを使用して理解します。

コネクションを作成する手順

メモ: 既存のPayPal、PayflowPro、および支払いProのバージョンは、2024年9月26日にサポートが終了し、その日以降の支払い取引は処理されません。継続的な支払い処理を確保するためには、最新のバージョンに移行してください。. 詳細はこちら

1. 左側のペインにある'Microservices'に移動し、+ 新しく作成するをクリックします。
   
2. 外部連携の下のPick & 作成 をクリックします。組み込みのコネクターのリストがカードとして表示されます。
   
3. 必要なサービスのコネクターを選択して接続を作成します。
メモ: 必要なサービスが組み込みコネクターのリストにない場合は、カスタムコネクターを作成し、その手順を続けてください。


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

メモ: 以下の認証レベルの一つを選択することができます。選択は、あなたの要件に基づきます。

1. 管理者: このオプションが選択されると、アプリケーションの管理者と超管理者だけが接続を認証する権限を持ちます。一般ユーザーや非管理的な役割の人は接続を認証することはできませんが、管理者の認証を通じてそれらを使用することができます。これにより、接続は管理者接続となります。
   
2. 任意のユーザー: このオプションが選択されると、どの役割のユーザーでもログインして接続を認証することができます。管理者の外部連携とは異なり、これらの外部連携はすべてのログインしたユーザーに対して個人認証を保有し、それを実行するユーザーの認証に基づいて連携を行うことができます。これは、管理者と一般ユーザーの両方が接続の認証を許可する能力を持つことを意味します。これにより、接続はログインユーザー接続となります。ログインユーザー接続は、一部の組み込みコネクターについてのみ作成できます。
5. OAuth2タイプの認証を持つコネクターのクレデンシャルを設定します。接続を作成する前に、以下のようにスコープを選択するよう求められます。すべての処理を選択するか、サービスに行わせたい特定の処理を選択するために特定の処理のみを選択することができます。
   


メモ: すべての処理にアクセスするように認証情報を設定すると、スコープのすべてのタブが選択され状態となります。タブの選択を解除するオプションはありません。 

6. 初期設定により、同じ認証設定がすべての環境で使用中となります。ただし、それぞれの環境で異なる認証設定を使用するというチェックボックスにチェックが入っている場合は除きます。
   
   あなたがユーザーに、異なる環境でアプリケーションを認証するための異なる認証情報の使用を希望している場合、各環境のチェックボックスを選択します。 各環境で異なる認証設定の使い方については以下を参照ください。 こちら

7. 作成および認証ボタンをクリックします。
   
8. 表示されたポップアップに認証情報を入力します。各環境で異なる認証を使用することを選択した場合、認証を適用する環境を選択します。認証をクリックすると、接続が確立され、認証が促されます。
メモ: ターゲットのサービスがサポートする認証種類に依存、第三者のサービスへの認証に必要な資格情報が変わります。
内在コネクターについて、サービスが必要とするパラメーターがあらかじめ設定されています。したがって、外部連携を作成する際には、単に資格情報を提供するだけでよいでしょう。
カスタムコネクタについては、パラメーターを設定 する必要があり、そのパラメーターはサービスにより提供され、カスタムコネクターを作成する際にプロンプトされます。認証種類により、カスタムコネクタの認証における差違が発生します。
9. 認証が必要とされる環境を選択します。 認証をクリックし、選択されたサービスへのアクセスを認証を続行します。
メモ: もし接続作成プロセス中に各実行環境で別々の認証を使用するというチェックボックスを選択しない場合、認証はすべての環境間で一貫性を保ちます。結果的に、すべての実行環境は自動的に初期設定で選択されます。
10. OAuth2の場合、認証をクリックすると、第三者のサービスの認証画面にリダイレクトされます。
    
11. 認証資格情報を入力し、アクセス権限を承認します。それは90秒の制限時間が切れる前に行われなければなりません。
    
    

認証が完了すると、接続はあなたのアプリケーションで使用する準備が整います。例えば、Zoho CreatorフォームからQuickbooksアカウントの売り手タブへデータをプッシュしたいと考えている場合、フォームワークフロー内の統合処理を使用してこれを達成できます。これを行うには、Quickbooks接続を作成し、必要なアカウントの資格情報で認証し、統合操作を設定する際に外部連携項目に供給します。あなたのアプリケーションの他のユーザーも、接続作成時に設定した認証レベルに基づいて接続を認証し使用することができます。

カスタムコネクタの認可における差異

認証は、カスタムコネクタを作成する際に使用される認証タイプにより異なります。以下にいくつかの例を挙げます：

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

注意点

1. 外部連携を作成できるのは管理者のみです。
2. システム外部連携はスーパー管理者、管理者、または開発者によって認証済みにすることができます。
3. ログイン時のユーザー外部連携はC6でのみ確立できます。
4. データソースやスケジューラを作成するには、ログイン時のユーザー外部連携内で単一のアカウントを通じた統合サービスの合理化に必須の主アカウントが必要です。
5. カスタムコネクタを使用した外部連携作成は、特定のシナリオやワークフローのための各操作APIを指定したDelugeURL呼び出しタスクでのみ利用可能です。接続済みのDropboxアカウントからファイルを取得する例については、URL呼び出しタスクを参照してください。
6. アプリケーションで接続が利用されると、それはまたアプリケーションの有効モードと編集モードで表示され、認証されます。有効モードと編集モードでの外部連携へのアクセスについて詳しくはこちらをクリックしてください。
   

関連リンク

1. 外部連携の理解
2. 外部連携の管理
3. 有効モードおよび編集モードの外部連携
4. コネクタの理解