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

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

メモ:

1. 異なるデータセンターにホストされているサービスへのコネクションでは、国境を越えたデータ転送が発生する場合があります。Zoho Creator ではデータを安全に取り扱いますが、続行する前に、お客様の組織のデータ所在地およびコンプライアンス要件に合致していることを確認してください。
   
2. 決済ワークフローは、現在 Zoho Checkout を基盤としたペイメントゲートウェイに依存しています。すべての決済サービスは、［Microservices > Operations > Payment Gateways］の下に移動されました。既存バージョンの PayPal、PayflowPro、Payments Pro は 2024 年 9 月 26 日をもって非推奨となり、この日以降は決済トランザクションは処理されません。決済処理を継続するには、最新バージョンへ移行してください。 詳細はこちら

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


4. 続いて表示されるポップアップで、Connection Nameは、選択したコネクターに基づいて自動生成されます。この名前は、入力ボックス内をクリックして編集できます。
   
1. 同じコネクターを使用するコネクションが複数ある場合、名前の形式は <サービス名>［半角スペース］Connection <連番> となります。たとえば、Twilio コネクションが複数ある場合、新しいコネクション名は Twilio Connection 1 となります。
   

5. ［Authorization Access］で、このコネクションをどのように認可するかを選択します。
   

1. Administrators only: アプリケーションの管理者、開発者、スーパー管理者 のみがコネクションを認可できます。一般ユーザーなどの非管理者ロールはコネクションを認可できませんが、管理者による認可を通じてコネクションを利用できます。この場合、コネクションは管理者コネクションとなります。  
2. All logged-in users: ロールに関係なく、ログインしている任意のユーザーがコネクションを認可できます。管理者コネクションとは異なり、これらのコネクションはログインしている各ユーザーごとに個別の認可情報を保持し、そのコネクションを実行するユーザーの認可に基づいて連携を行います。つまり、管理者と一般ユーザーのどちらもコネクションを認可でき、このコネクションは ログインユーザーコネクションとなります。 
6. ［Connection Mode］で、コネクションの認可方法を定義します。
   
1. Quick connect (Zoho 管理の OAuth 資格情報) - 既定の Zoho 管理 OAuth 資格情報です。
   
2. Custom(独自の OAuth 資格情報を使用) - 独自の資格情報を使用してコネクションを管理できます。
   

• 登録済みのサードパーティOAuthアプリから取得したクライアント認証情報、クライアントID、およびクライアントシークレットを入力します。
  

• 既存の認証情報があり、新しい認証情報を作成したい場合は、ドロップダウンから［新規追加］を選択します。システムによって生成されたクライアント認証情報が割り当てられます。
  
• 既存のOAuth認証情報を再利用したい場合で、その認証情報がすでに複数の接続でコネクタにマッピングされている場合は、 ［クライアント認証情報］ドロップダウンから1つ選択します。
  




メモ: 接続の作成中に既存の認証情報を更新することはできません。クライアント認証情報を更新するには、接続の詳細ページに移動する必要があります。 認証情報の値が重複していないことを確認してください。
クライアントIDに使用できる特殊文字は、次の文字のみです： * _ - @ / ! : | & ~ \ + 。また、50文字を超えることはできません。

• Zoho Creator 用に表示されているコールバックURL（リダイレクトURL）をコピーし、サードパーティのOAuthアプリを登録してクライアントIDとクライアントシークレットを生成する際に必ずこのURLを使用してください。
  
7. 接続を作成する前に、詳細設定ドロップダウンで必要なスコープを選択します。 すべてのタブへのアクセスを許可するには［すべてのアクション］を、特定のアクションのみを選択するには［特定のアクションのみ］を選択します。 デフォルトでは、［すべてのアクション］オプションが選択されています。
   

メモ: ［詳細設定］で、接続の認証情報を使用して［すべてのアクション］へのアクセスを有効にすることを選択した場合、その接続に関連するすべてのアクションがデフォルトで有効になり、選択解除することはできません。

クライアント認証情報（カスタム）の場合は、Zoho Creator で選択したアクションが、サードパーティサービス側で設定されているアクションと一致していることを確認してください。

8. ［作成して認証］をクリックします。
   
1. デフォルトでは、「各環境で異なる認証を使用する」チェックボックスをオンにしない限り、すべての環境で同じ認証が使用されます。既定では、すべての環境で認証は共通です。
   
   
2. 異なる環境ごとに、ユーザーに異なる認証情報でアプリケーションを認可させる必要がある場合は、このチェックボックスをオンにします。詳しくは、各環境で異なる認証を使用する方法をご覧ください。
   
1. 認証を適用する環境を選択します。［認証］をクリックすると、接続が作成され、認証を求める画面が表示されます。
   
メモ:サードパーティサービスの認証に必要な認証情報は、対象サービスがサポートする認証タイプに基づきます。
組み込みコネクタの場合、サービスで必要なパラメーターはあらかじめ設定されています。接続を作成する際は、認証情報を入力するだけでかまいません。
カスタムコネクタの場合は、カスタムコネクタを作成する際に、そのサービスで必要となるパラメーターを設定 する必要があります。設定したパラメーターは、カスタムコネクタを使用して接続を認証する際に入力フィールドとして表示されます。使用する認証タイプに応じて、カスタムコネクタの認証方法に違いが生じます。
9. OAuth2 の場合、［認証］をクリックすると、サードパーティサービスの認証ページにリダイレクトされます。
   
10. 認証情報を入力し、90秒の制限時間内にアクセス権限を承認してください。
    
    

認証が完了すると、接続はアプリケーションで使用できる状態になります。たとえば、フォーム送信のたびに Zoho Creator の「仕入先名」項目のデータを Quickbooks アカウントの「仕入先」タブに連携したい場合は、フォームワークフローの連携アクションを使用して実現できます。そのためには、Quickbooks 接続を作成し、目的のアカウントの認証情報で認証したうえで、連携アクションを設定する際に接続項目にその接続を指定します。アプリケーションの他のユーザーも、接続作成時に設定した認証レベルに応じて、この接続を認証して利用できます。

1.1 カスタムコネクタの認証の違い

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

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

2. 注意事項

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

3. 関連トピック

1. 接続について理解する
2. 接続を管理する
3. ライブモードと編集モードでの接続
4. コネクタについて理解する