1. コネクションの表示方法

2. コネクションを表示する

メモ: 異なるデータセンターにホストされているサービスへのコネクションでは、国境を越えたデータ転送が発生する場合があります。Zoho Creator はデータを安全に取り扱いますが、運用を開始する前に、お客様の組織のデータ所在地ポリシーおよびコンプライアンス要件に合致していることを必ずご確認ください。

1. サービス名: コネクションが作成されたサービスの名前。
2. 承認済みアカウント: コネクションを承認したアカウントに関連付けられている名前。この自動生成された名前は、承認済みアカウント名の横にある編集アイコンをクリックして変更できます。
3. ステータス: コネクションが接続済みか未接続かなど、現在の状態を示します。
4. ［Authorize］ボタン: まだ承認されていない場合に、そのコネクションを承認するためのボタンです。
5. コネクションタイプ: コネクションの種類は、以下の表に示すように異なるアイコンで表されます。 
   

2.1. コネクションの配置

本番モードでコネクションを表示するには:

1. アプリケーション内で、ユーザー名の横にある設定アイコン（）をクリックします。
   
メモ: 設定アイコン（）の位置は、使用しているアプリケーションのテーマによって異なる場合がありますが、通常はユーザー名の近くに表示されます。
2. Connections をクリックします。
   
   

編集モードでコネクションを表示するには:

1. ビルダー右上の Integrations アイコン（）をクリックします。
   
   

メモ: Deluge エディターから直接コネクションを表示するには、エディター上部のバーで Integrations を選択します。

2.2. インストール済みコネクション

インストール済みアプリケーションに追加されたコネクションは、Installed Connections として表示されます。アプリケーションがシステムコネクションを使用しており、同じサービスのコネクションがすでにお客様のアカウントに存在する場合、アプリケーションは既存のコネクションを参照し、一貫性を保ちつつ重複を回避します。

3. 本番モードと編集モードでのコネクションの承認

1. アプリの本番モードまたは編集モードから接続画面に移動します。アプリ内のすべての接続がこちらに一覧表示されます。
   
2. [Authorize] をクリックします。
   
3. 認可を使用する環境を選択します。これは、[Use different authorization for each environment] が選択されている場合にのみ必要です。 詳細はこちら
メモ: OAuth2 タイプの接続では、[Authorize] をクリックすると 90 秒のタイマーが開始されます。サービスの認可ページにリダイレクトされるので、そこでアクセス権を付与してください。
4. 認可情報を入力し、90 秒の制限時間内にアクセス権限を承認します。
   

3.1. 未認可の接続を使用しているアプリケーションコンポーネントの動作

未認可の接続がアプリケーション内のコンポーネント（ワークフロー、関数、または ブループリント）で使用されている場合、そのコンポーネントにアクセスしたとき、またはワークフローの実行中に、認可を求めるプロンプトが表示されます。

1. 管理者接続の場合、接続の認可プロンプトが表示されるのは、管理者とスーパー管理者のみです。その他のユーザーは、管理者が認可するまでそのリソースにアクセスできず、管理者に連絡するよう促すメッセージが表示されます。ユーザーがフォームにアクセスできるようにするには、管理者が接続を認可する必要があります。
   
2. システム接続の場合、接続の認可プロンプトが表示されるのは、スーパー管理者、管理者、開発者のみです。その他のユーザーは、スーパー管理者が認可するまでそのリソースにアクセスできず、管理者／スーパー管理者に連絡するよう促すメッセージが表示されます。ユーザーがフォームにアクセスできるようにするには、スーパー管理者が接続を認可する必要があります。
   
3. ログインユーザー接続の場合、すべての種類のユーザーに接続の認可プロンプトが表示されます。
   

本番モードでの認可プロンプトの表示例:

1. フォーム読み込み時に実行される、未認可の接続を含むワークフローが設定されたフォーム。
   
   
2. 未認可の接続を含むパネルを配置したページ。
   
   
3. 未認可の接続を使用している連携レポート。
   
   
4. 本番ユーザーが、未認可の管理者接続またはシステム接続を使用しているフォームにアクセスした場合。
   
   

メモ:同じ動作は、無効化された接続や、アプリケーションに対する接続アクセスが無効化されている場合に、そのアプリケーションコンポーネントへアクセスしたときにも適用されます。このような場合、ユーザーがアクセスできるようにするには、管理者がマイクロサービスから接続を有効化する必要があります。

4. 認可の切り替え

メモ:

1. システム接続の認可を切り替えられるのは、スーパー管理者、管理者、開発者のみです。
2. 管理者接続の認可は、すべての管理者が切り替えることができます。
   
3. ログインユーザー接続の認可を切り替えられるのは、その認可の所有者のみです。

接続の切り替えとは、その接続に対して新しい認可を付与する操作です。次のような場合にも必要になります:

1. 接続に紐づく認可情報の有効期限が切れた場合
   
2. サードパーティサービス側で認可トークンが無効化または削除された場合
   

メモ: 接続の認可を切り替えると、その接続を利用しているすべてのアプリケーションは以後、新しい認可を使用します。

アプリケーションの本番モードまたは編集モードで接続の認可を切り替えるには、次の操作を行います:

1. アプリの本番モードまたは編集モードから接続画面に移動し、対象の接続をクリックします。
   
   
2. [Switch] をクリックします。
   
   
3. 認可アカウント名を選択し、[Authorize] をクリックします。
   
メモ: OAuth2 タイプの接続では、[Authorize] をクリックすると 90 秒のタイマーが開始されます。サービスの認可ページにリダイレクトされるので、そこでアクセス権を付与してください。
4. 認可情報を入力し、90 秒の制限時間内にアクセス権限を承認します。
   

5. 認可の取り消し

接続の認可を取り消すと、サードパーティサービスへの権限とアクセスが削除され、その接続の認可を使用しているコンポーネントは想定どおりに動作しなくなります。

メモ:

1. システム接続の認可を取り消せるのは、スーパー管理者、管理者、開発者のみです。
   
2. 管理者接続の認可は、すべての管理者が取り消すことができます。
   
3. ログインユーザー接続の認可を取り消せるのは、その認可の所有者のみです。ログインユーザー接続に紐づくプライマリアカウントの認可が取り消された場合、ユーザーが接続を認可できるようにするには、管理者が別の管理者アカウントをプライマリとして設定する必要があります。
   
4. ある接続の認可を取り消しても、同じ認可を使用している他の接続には影響しません。

アプリケーションの本番モードまたは編集モードで接続の認可を取り消すには、次の操作を行います:

1. アプリの本番モードまたは編集モードから接続画面に移動し、対象の接続をクリックします。
   
   
2. [Revoke] をクリックします。
   
   

6. クライアント認証情報を更新する

Info: クライアント認証情報を更新すると、その接続を参照している既存の認可はすべて失効します。認証情報が 1 つ以上の接続で参照されている場合、それらはすべて失効します。接続を再認可するまで、アプリケーションの動作に一時的な影響が出る可能性があります。接続で設定されているアクションが、登録済み OAuth アプリで定義されているスコープ内に収まっていることを必ず確認してください。

1. アプリケーションの本番モードに移動します。Connections スライダーで、対象の接続をクリックします。
2. ［Client Credentials］の下で、一覧に表示されている認証情報名の横にある［Update］ボタンをクリックします。
3. 表示されるポップアップで、新しい Client Credential Name と、サードパーティ OAuth アプリの更新後の Client Secret を選択します。新しい Client ID と Client Secret を追加することもできます。既存のクライアントシークレットは表示されず、再利用することはできません。
   
4. ［Update and Authorize］をクリックして、接続の動作を復元します。
   

接続をカスタム認証情報で作成した場合、クライアント認証情報名は自動生成されます。クライアント認証情報名を編集するには、Connections スライダーの編集アイコンをクリックします。

 メモ:

1. 更新できるのは、認証情報の所有者（認証情報を追加したユーザー）のみです。その他のロールでは［Update］オプションは無効になり、カーソルを合わせるとツールチップが表示されます。 
   
2. 開発者の場合、認証情報の再利用は、関連付けられているアプリケーション内でのみ許可されます。 
   
3. 共有ユーザーはクライアント認証情報を設定できないため、管理者に連絡する必要があります。
   
4. 接続が別のアプリケーションで参照されている場合、本番モードからは更新できません。 
   
5. インポートしたアプリケーションに、カスタムモードで設定された接続が含まれている場合、対応するクライアント認証情報は転送されません。Connection details ページから［Configure］をクリックして接続を再設定し、その後で認可する必要があります。
   

7. 関連データソース

 メモ: 連携項目のデータのみが、関連付けられた Creator フォームレコード内で更新されます。接続されたサービス側へデータがプッシュされることはありません。

1. ［開始］ボタンは、（該当する場合は）データソースが設定され、接続が承認され、アプリへのアクセスが有効になっている場合にのみ表示されます。
   
2. 同期は、ユーザー 1 人あたり、データソース 1 つにつき 24 時間に 1 回実行できます。
   
3. 一度に同期できる連携項目データの上限は 10 件です。
   
4. この時間内に複数のユーザーが同じデータソースの連携項目データを同期しようとした場合、最初の要求のみが実行されます。他のユーザーには、最新の同期のタイムスタンプが表示されます。
   
5. 同期に失敗した場合は、オペレーションのログを確認できます。
   
6. ユーザーが同期を開始すると、外部サービスの API を呼び出して最新データを取得します。これらの API 呼び出しは、ユーザーのサードパーティアカウントの利用上限にカウントされる場合があります。

1. 本番モードおよび編集モードでは、スーパー管理者、管理者、開発者は、アプリケーション内のすべての種類の接続を表示できます。他のユーザーは、アプリケーションコンポーネントに関連付けられた権限に応じて、自分のログインユーザー種別に固有の接続のみを表示できます。
2. プライマリアカウントが承認されていない状態で、ログインユーザー接続がデータソースやスケジュールで使用されている場合、管理者が承認してプライマリアカウントを設定するまで、アプリケーションユーザーはその接続を承認できません。
3. 管理者と開発者は、アプリケーション内で使用されているすべての種類の接続を表示できます。ただし、システム接続の承認を行えるのは、スーパー管理者、管理者、開発者のみです。

9. 関連トピック

1. 接続について
2. 接続の作成と承認
3. 接続の管理