このヘルプページは Creator 6 をご利用のユーザー向けです。旧バージョン（Creator 5）をご利用の場合は、こちらをクリックしてください。ご利用中の Creator のバージョンを確認してください。

1. 接続を作成する手順

メモ: 支払いワークフローは、現在 Zoho 決済の支払いゲートウェイに依存しています。すべての支払いサービスは、［Microservices > Operations > 支払いゲートウェイ］の下に移動されました。既存の PayPal、PayflowPro、Payment Pro のバージョンは 2024 年 9 月 26 日をもってサポート終了となり、この日付以降は支払い取引は処理されません。支払い処理を継続するには、最新バージョンへ移行してください。詳細はこちら

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


4. 接続名は、コネクタを選択すると自動的に作成されます。ボックスをクリックすると編集できます。認可レベルを選択します。
   同じコネクタを使用する外部連携が複数ある場合、命名形式は「<サービス名>[半角スペース]Connection<連番>」となります。
   
   

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

1. 管理者: このオプションを選択すると、アプリケーションの管理者およびスーパー管理者のみが接続を認証できます。一般ユーザーや管理者以外のロールは接続を認証できませんが、管理者が認証した接続を利用できます。この場合、接続は管理者接続となります。
   
2. 任意のユーザー: このオプションを選択すると、ログインしているユーザーであればロールに関係なく接続を認証できます。管理者接続とは異なり、これらの外部連携は、ログインしているすべてのユーザーごとに個別の認可を保持でき、処理を実行するユーザーの認可に基づいて連携を実行します。つまり、管理者と一般ユーザーの両方が接続の認可を付与でき、この接続はログインユーザー接続になります。ログインユーザー接続は、一部の組み込みコネクタに対してのみ作成できます。
5. OAuth2 タイプの認証を使用するコネクタの認証情報を設定する場合、接続を作成する前に、以下のようにスコープの選択を求められます。すべての操作を選択するか、特定の操作のみを選択して、サービスに実行させたい操作だけを指定できます。
   


メモ: 認証情報ですべての操作へのアクセスを有効にすると、スコープ内のすべてのタブが選択されます。タブの選択を解除することはできません。 

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

7. 作成して認証をクリックします。
   
   
8. 続いて表示されるポップアップで、認証情報を入力します。各環境で異なる認可を使用するように選択した場合は、認可を適用する環境を選択します。認証をクリックすると、接続が作成され、認証が求められます。
   
   
メモ:サードパーティサービスの認証に必要な認証情報は、対象サービスがサポートする認証タイプに基づきます。
組み込みコネクタの場合、サービスで必須となるパラメーターはあらかじめ設定されています。外部連携を作成する際は、認証情報を入力するだけでかまいません。
カスタムコネクタの場合は、カスタムコネクタを作成する際に、サービスで必須となるパラメーターを設定する必要があります。設定したパラメーターは、カスタムコネクタで接続を認証する際に項目として表示されます。使用する認証タイプに応じて、カスタムコネクタの認可方法に違いが生じます。
9. 認可を適用する環境を選択します。 認証をクリックし、選択したサービスへのアクセスを認証して続行します。
メモ:接続の作成時に各環境で異なる認可を使用するチェックボックスを選択しなかった場合、認可はすべての環境で共通になります。その結果、初期設定としてすべての環境が自動的に選択されます。
10. OAuth2 の場合、認証をクリックすると、サードパーティサービスの認可ページにリダイレクトされます。
    
11. 認証情報を入力し、90 秒の制限時間内にアクセス権限を承認します。
    
    

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

1。1 カスタムコネクタの認可の違い

カスタムコネクタを作成する際に使用する認証タイプによって、認可方法は異なります。いくつかの例を見てみましょう。

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

2. 注意事項

1. 外部連携は管理者のみが作成できます。
2. システム外部連携は、スーパー管理者、管理者、または開発者が認証できます。
3. ログインユーザー外部連携は C6 でのみ作成できます。
4. データソースや、ログインユーザー外部連携でのスケジューラーを作成する場合、統合されたサービスを 1 つのアカウント経由で利用できるよう、プライマリアカウントの指定が必須です。
5. カスタムコネクターで作成した外部連携は、Deluge の invoke URL タスク内でのみ使用できます。特定のシナリオやワークフローに応じて、該当する操作 API を指定してください。この例では、invoke URL タスクを使用して、接続済みの Dropbox アカウントからファイルを取得する方法を説明しています。
6. アプリケーションで使用中の接続は、そのアプリケーションの本番モードおよび編集モードからも表示および認証できます。外部連携へ本番モードおよび編集モードからアクセスする方法の詳細は、こちらをクリックして参照してください。
   

3. 関連トピック

1. 外部連携について
2. 外部連携の管理
3. 本番モードと編集モードでの接続
4. コネクターについて