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

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

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

1. 左側ペインでMicroservicesに移動し、+ 新規作成をクリックします。
   
2. 外部連携の下にあるPick & Createをクリックします。組み込みコネクタの一覧がカード形式で表示されます。
   
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 を指定します。接続済みの Dropbox アカウントからファイルを取得する 例については、invoke URL タスクの説明を参照してください。
6. アプリケーションで使用中の接続は、そのアプリケーションの本番モードおよび編集モードからも表示・認証できます。外部連携へ本番モードおよび編集モードからアクセスする方法については、こちらをクリックして参照してください。
   

3. 関連トピック

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