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

1. 接続の作成手順

メモ。

1. 異なるデータセンターでホストされているサービスへの接続では、国境を越えたデータ転送が発生する場合があります。Zoho Creatorではデータを安全に処理しますが、続行する前に、組織のデータレジデンシーやコンプライアンス要件に適合していることを確認してください。
   
2. 支払いワークフローは現在、Zoho Checkoutを利用した決済ゲートウェイに基づいています。すべての決済サービスは、［マイクロサービス］→［操作］→［決済ゲートウェイ］に移動されました。PayPal、PayflowPro、Payments Proの既存バージョンは2024年9月26日に廃止され、この日以降、決済取引は処理されません。決済処理を継続するには、最新バージョンに移行してください。 詳細はこちら
   
3. ローカルでホストされているコネクターを使用して作成された接続には、設定済みのデータブリッジが必要です。このような接続を作成する前に、Qntrlがシステム連携で設定され、有効なデータブリッジに関連付けられていることを確認してください。有効なデータブリッジがないと、接続を作成または認証できません。

1. 左ペインの［マイクロサービス］に移動し、［+新規作成］をクリックします。
   
2. 接続の下にある［選択して作成］をクリックします。標準コネクターの一覧がカードとして表示されます。
   
3. 接続を作成する対象サービスのコネクターを選択します。
   

メモ。



標準コネクターの一覧に必要なサービスがない場合は、カスタムコネクターを作成して先に進むことができます。


コネクター一覧ページの［フィルター］オプションを使用して、一覧を絞り込めます。パブリックホスト型やプライベートホスト型など、コネクターの種類でフィルターできます。たとえば、データブリッジを使用して動作するコネクターのみを表示するには、プライベートホスト型を選択します。

4. 次に表示されるポップアップでは、［接続名］が、選択したコネクターに基づいて自動生成されます。入力ボックス内をクリックすると、編集できます。
   
1. 同じコネクターの接続が複数ある場合、命名形式は <service-name> [space] Connection <sequence>. です。たとえば、Twilio接続が複数ある場合、新しい接続は Twilio Connection 1.
   

5. 接続の認証方法を［認証アクセス］で選択します。
   

1. ［管理者のみ］：管理者、開発者、特権管理者 は、アプリケーションで接続を認証する権限を持ちます。一般ユーザーや管理者以外の役割は接続を認証できませんが、管理者による認証を通じて利用できます。この場合、接続は管理者接続になります。 
2. ［ログイン中のすべてのユーザー］：ログイン中のユーザーであれば、役割に関係なく接続を認証できます。管理者接続とは異なり、これらの接続ではログイン中の各ユーザーごとに個別の認証を保持でき、実行したユーザーの認証に基づいて連携を実行できます。つまり、管理者と一般ユーザーのどちらも接続を認証できます。この場合、接続は ログインユーザー接続になります。 
6. 接続の認証方法を定義するため、［接続モード］を選択します。
   
1. クイック接続（Zoho管理のOAuth認証情報） - これは、デフォルトのZoho管理OAuth認証情報です。
   
2. カスタム（独自のOAuth認証情報を使用） - 独自の認証情報を使用して接続を管理できます。
   

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

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




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

• Zoho Creator用に提供されているコールバックURL（リダイレクトURL）をコピーし、クライアントIDとクライアントシークレットを生成するためにサードパーティOAuthアプリを登録する際に使用されるようにします。
  
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では、接続の認証レベルを選択する必要があります。
   
   
1. ［各環境で異なる認証を使用する］を選択した場合は、続いて表示されるポップアップで環境を選択します。その後、［認証］をクリックすると、サービス（Trello）の認証ページにリダイレクトされます。そこで、要求された権限へのアクセスを許可する必要があります。
   
4. OAuth2認証のサービスであるDropboxでは、接続の認証レベルを選択する必要があります。
   
   
1. ［各環境で異なる認証を使用する］を選択した場合は、続いて表示されるポップアップで環境を選択します。［認証］をクリックすると、サービス（Dropbox）の認証ページにリダイレクトされます。そこで、要求された権限へのアクセスを許可する必要があります。
   

2. 注意点

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

3. 関連トピック

1. 接続の概要
2. 接続の管理
3. 公開モードと編集モードでの接続
4. コネクターの概要