このページの内容
Zoho Creator アプリケーションと他の Zoho サービスやサードパーティサービスを連携するために作成した
外部連携を管理する方法について説明します。
1. 外部連携へのナビゲーションガイド
2. 外部連携を管理する
Microservices 内の 外部連携タブには、アカウント内で作成されたすべての外部連携が表示されます。各連携はカード形式で表示され、連携名、連携リンク名、連携の種類、ステータスが含まれます。
ページ右側のフィルターオプションを使用して、種類や関連付けられているアプリケーションごとに外部連携の一覧を絞り込むことができます。利用可能な連携タイプは次のとおりです。
- システム連携 - システムによって自動的に作成される連携
- ユーザー連携 - ユーザーが作成した連携
- インストール済み連携 - マーケットプレイスまたはプライベート共有されたアプリケーションをインストールした際に作成される連携
フィルターは単一条件でも複数条件でも適用でき、アプリケーションフィルターと組み合わせて、さらに詳細な結果を得ることもできます。選択したフィルターはタグとして表示され、個別に削除するか、一括でクリアできます。
また、検索ボックスを使用して特定の連携やアプリケーションを素早く見つけることもできます。たとえば、Zoho CRM 連携を検索し、その後フィルターを適用して、アプリケーションに関連付けられている外部連携のみを表示できます。
外部連携を管理すると、次の操作が可能です。
- 連携の詳細ページを表示する
- 連携を編集する
- 連携の認証を切り替える
- 認証を取り消す
- 認証名を編集する
- 連携を無効にする
- 連携を有効にする
- 連携の参照先を表示する
- 連携を削除する
- アプリケーションへの連携アクセスを有効/無効にする
- 環境ごとに異なる認証を使用する
- ログインユーザー連携の認証を表示・管理する
2。1 連携の詳細ページを表示する
このページでは、対象の連携の基本情報を表示し、編集、削除、有効化/無効化、認証の取り消しなどの管理操作を行うことができます。連携の詳細ページを表示するには、次の操作を行います。
- Microservices に移動し、外部連携の下に表示されている対象の連携カードをクリックします(下図参照)。

次の情報が表示されます。
- 連携に対して自動生成またはユーザーが指定した表示名。この名前は、名前の横にある編集アイコンをクリックして編集できます。
- リンク名: バックエンドで連携に対して作成される一意の名前。Deluge の連携タスクや URL 呼び出しスクリプトで、認証を確立するために使用されます。
- この連携を使用しているアプリケーションの一覧。
- Permission: 連携作成時にユーザーが選択したスコープ。
- Authorization 担当者: 連携を管理者のみが認証できるか(管理者連携)、任意のユーザーが認証できるか(ログインユーザー連携)を示します。
- Authorization: 3 つの環境すべてで同じ認証を使用しているか、環境ごとに異なる認証を使用しているかを示します。
- 認証済みアカウント: 連携が認証されている場合に表示される、接続済みアカウントの表示名。この自動生成された名前は、認証済みアカウント名の横にある編集アイコンをクリックして編集できます。
メモ:
-
環境が有効になっているアプリケーションでは、3 つの環境すべての認証済みアカウント名が一覧表示されます。連携が
ログインユーザー連携の場合、その連携に対するすべての認証を表示するリンクが利用できます。
- サードパーティ側で認証アカウント名が指定されていない場合、自動生成される認証済みアカウント名は、
<サービス名> アカウント <連番> の形式になります。たとえば、Twilio アカウント 2 のようになります。
サードパーティ側で認証アカウント名が指定されている場合は、その名前がアカウント名として表示されます。
- Connection access: 特定のアプリケーションに対する連携のアクセスを有効/無効にしたり、参照を表示して、そのアプリケーション内で連携が実際に使用されている箇所を特定したりできます。
- その他: 作成者、作成日時、最終更新者、最終更新日時などの情報。
2。2 連携を編集する
連携の編集では、連携名、連携リンク名、スコープ設定を変更できます。編集するには、次の操作を行います。
- Microservices に移動し、編集したい連携カードにカーソルを合わせます。
- カード右上の三点リーダー(縦三点)アイコンをクリックし、連携を編集 をクリックします。

- 更新したい情報を入力し、更新 をクリックします。

メモ: 連携の編集時に権限(スコープ)を更新した場合、既存の認証は無効になるため、連携の再認証を求められます。
また、
連携の詳細ページの三点リーダーから編集をクリックして、連携を編集することもできます。
メモ:
- 認証情報以外のすべての項目を編集できます。
- 画面左上の連携表示名の横にある名前を変更アイコンをクリックして、連携名を編集できます。
2。3 接続の認可を切り替える
Info: このセクションは
管理者および
システム接続にのみ適用されます。ログインユーザー接続の切り替えについては
こちらを参照してください。
接続の切り替えとは、その接続に対して新しい認可を付与する処理のことです。これは次のような場合にも必要になります:
- 接続にリンクされている認可情報の有効期限が切れた場合
- サードパーティサービス側で認証トークンが無効化または削除された場合
メモ:
- システム接続の認可の切り替えは、スーパー管理者、管理者、開発者のみが実行できます。マイクロサービスは開発者からはアクセスできないため、開発者はアプリケーションの本番モードまたは編集モードからのみ接続を認可できます。
- 管理者接続の認可は、すべての管理者が切り替えることができます。
- 接続の認可を切り替えると、その接続を利用しているすべてのアプリケーションは以後、新しい認可を使用します。
認可を切り替えるには:
- Microservicesに移動します。アカウントで利用可能なすべての接続が接続セクションに一覧表示されます。
- 切り替えたい接続カードにカーソルを合わせ、カード右上の三点リーダー(縦三点)アイコンをクリックし、切り替えるをクリックします。

-
既に保存されているアカウントを再利用する場合は認証済みアカウントドロップダウンから選択し、別のアカウント資格情報で接続を認可する場合は新しいアカウントをリンクをクリックします。
メモ: 環境ごとに異なる認可を使用するを選択している場合のみ、ここで環境を選択できます。
-
ポップアップで認可の詳細を入力し、認証をクリックします。

また、目的の接続の
接続詳細ページで、認証済みアカウントの横にある切り替えるをクリックして接続を再認可することもできます。アカウント名を入力し、(対象サービスの認可方式に応じて)表示される手順に従って認可を行います。これにより既存の認可は無効になり、新しい認可が有効になります。
2。4 認可を取り消す
Info: このセクションは 管理者および システム接続にのみ適用されます。ログインユーザー接続の認可取り消しについては、こちらを参照してください。
メモ:
- システム接続の認可の取り消しは、スーパー管理者、管理者、開発者のみが実行できます。マイクロサービスは開発者からはアクセスできないため、開発者はアプリケーションの本番モードまたは編集モードからのみ接続を認可できます。
- 管理者接続の認可は、すべての管理者が取り消すことができます。
- ある接続の認可を取り消しても、同じ認可を使用している他の接続には影響しません。
接続の認可を取り消すと、サードパーティサービスへの権限とアクセスが削除され、その接続の認可を使用しているコンポーネントは想定どおりに動作しなくなります。接続の認可を取り消すには、対象の接続の
接続詳細ページに移動し、下図のように取り消しアイコン(
)をクリックします。
環境ごとに異なる認可を使用する接続の場合は、接続詳細ページで、取り消したい環境の横にある取り消しアイコン(
)をクリックして、その環境の認可を取り消します(下図参照)。
2。5 認可名を編集する
接続を作成すると、認可名は自動的に生成されます。接続の認可名を編集するには、対象の接続の
接続詳細ページに移動し、下図のように編集アイコンをクリックします。
表示されるポップアップで新しい認可名を入力し、
完了をクリックします。
2。6 接続を無効にする
接続を無効にすると、その接続の機能が停止します。そのため、接続は無効となり、いずれのアプリケーションでも使用できなくなります。アプリケーションで使用中の接続が無効になると、再度有効化されるまで、本来のタスクを実行しなくなります。無効にする手順は次のとおりです:
- Microservicesに移動します。アカウントで利用可能なすべての接続が接続セクションに一覧表示されます。
- 無効にしたい接続カードにカーソルを合わせます。
- カード右上の三点リーダー(縦三点)アイコンをクリックし、無効にするをクリックします。

メモ:
- 接続がいずれのアプリケーションでも使用されていない場合は、無効にするをクリックするとすぐに無効になります。使用されている場合は、接続を使用しているすべての場所の詳細を示すポップアップが表示され、そのうえで無効化を続行するかどうかを選択できます。
- 1つの接続に複数のデータソースがリンクされている場合、その接続を無効にする前に、その接続に関連付けられているすべてのデータソースを無効にする必要があります。
あるいは、
対象の接続の接続詳細ページ で、三点リーダーから無効にするをクリックして接続を無効にすることもできます。
2。7 接続を有効にする
接続を有効にするとは、以前
無効化された接続を再度アクティブにし、
データソースや
ワークフロー内の Deluge スクリプトなど、その接続が使用されているさまざまな箇所での機能を復元することです。有効化するには、次の操作を行います:
- Microservices に移動します。アカウントで利用可能なすべての外部連携が、外部連携セクションに一覧表示されます。
- 有効にしたいグレー表示の接続カードにカーソルを合わせます。
- カード右上の三点リーダー(縦三点)アイコンにカーソルを合わせてクリックし、有効にするをクリックします。

また、
接続の詳細ページの三点リーダーメニューから[有効にする]をクリックして、接続を有効化することもできます。
以下の例を参照してください。
2。8 接続の参照先を表示する
[References]には、その接続が使用されているデータソースやアプリケーション内など、すべての場所の一覧が表示されます。参照先を表示するには、次の操作を行います:
- Microservices に移動します。アカウントで利用可能なすべての外部連携が、外部連携セクションに一覧表示されます。
- 対象の接続カードにカーソルを合わせます。
- カード右上の三点リーダー(縦三点)アイコンをクリックし、References をクリックします。

2。9. 接続を削除する
削除とは、指定した接続を Creator アカウントから完全に削除する操作です。
- Microservices に移動します。アカウントで利用可能なすべての外部連携が、外部連携セクションに一覧表示されます。
- 削除したい接続カードにカーソルを合わせます。
- カード右上の三点リーダー(縦三点)アイコンをクリックし、削除をクリックします。

- 接続がいずれのアプリケーションでも使用されていない場合は、表示される確認ポップアップで削除をクリックすると、すぐに削除されます。
- それ以外の場合は、その接続が使用されているすべての場所の詳細を示すポップアップが表示されます。接続を削除し続けるには、表示されたすべての利用箇所を削除する必要があります。
また、
接続の詳細ページの三点リーダーメニューから[削除]をクリックして、接続を削除することもできます。
以下の例を参照してください。

2。10. アプリケーションへの接続アクセスを有効/無効にする
接続の詳細ページ の[Connection Access]セクションでは、特定のアプリケーションに対する接続アクセスを有効または無効にできます。これにより、その接続はアクセスが有効になっているアプリケーションでのみ利用可能になります。
2。11. 環境ごとの認可
接続を作成すると、初期設定では、開発・ステージング・本番という 3 つの
環境すべてで同じ認可情報が使用されます(環境ごとに個別設定しない限り)。この設定は、すべての環境で同じ認証情報を使用する統合に最適です。後から別の認証情報を使用する必要が生じた場合でも、Creator では「環境ごとの認可」を有効にして、各
環境に固有の認可を設定できます。環境ごとに異なる認可を使用することで、環境ごとの要件に合わせてアクセスや権限を調整しつつ、
環境固有の権限を維持できます。
ただし、ステージングや開発環境で本番移行前に異なる API キーを使ってテストする場合など、環境ごとに別の認可が必要となるケースもあります。
環境ごとの認可を有効にする
環境ごとの認可は、接続の作成時に有効にできます。作成時にスキップした場合でも、既存の接続に対して後から次のいずれかの方法で有効にできます。
- 外部連携の一覧ページで、接続の横にある三点リーダーメニューから環境ごとの認可を使用を選択します。

- 接続の詳細ページで、認可の横にある環境ごとに使用ボタンをクリックします。

これ以降、管理者は任意の環境を選択して認証を行うよう求められます。
メモ:
- 同じ認可プロパティの一部としてすでに本番環境の認可が存在する場合、「すべての環境で同じ認可」から「環境ごとの認可」に切り替えても、その本番環境の認可は保持されます。ただし、必要に応じて管理者が本番環境を再認証することもできます。
- 接続が 1 つ以上のデータソースにリンクされている場合、環境ごとの認可は有効にできません。
- 環境ごとの認可を一度有効にすると、「すべての環境で同じ認可」に戻すことはできません。ただし、すべての環境を選択して認証を完了することで、同等の状態にすることは可能です。
希望する
環境に対して接続を認証するには、次の手順に従います。
2。11。1 各環境の認証
環境ごとの認可が有効になっているものの、まだ認証が完了していない場合は、以下の手順で各環境を認証します。
- 接続カードをクリックして接続の詳細ページ に移動し、認証をクリックします。

-
ドロップダウンから認証済みアカウントを選択し、環境を選択します。[Reuse]をクリックします。
メモ: 接続の作成時に、環境ごとに異なる認可を使用するプロパティを有効にしていることを確認してください。このプロパティを有効にしている場合にのみ、ここで環境を選択できます。
- 別の認証情報で接続を認証するには、新規アカウントをリンクをクリックします。認可を適用する環境を選択し、認証をクリックします。

2。12 ログインユーザー接続の認可を管理する
ログインユーザー接続を作成すると、そのアプリケーションにログインしている任意のユーザーが、その接続を
本番モードまたは編集モードで認証して利用できます。ただし、すべての認可の詳細は管理者のみが表示および管理できます。ログインユーザー接続の管理には、次の操作が含まれます:
- すべての認可を表示する
- 認可を切り替える
- 認可を取り消す
- アカウントをプライマリとして設定する
すべての認可を表示する
[すべての認可を表示]ページでは、その接続に関連付けられているすべての認可の一覧を確認できます。すべての認可を表示するには、次の操作を行います。
- 接続カードをクリックして接続の詳細ページ に移動し、すべての認可を表示をクリックします。

表示されているすべての認可について、ユーザー名、認可日、ユーザーのメールアドレス、ユーザー種別などの詳細を確認できます。検索バーを使用して特定のユーザーを検索したり、ユーザー種別や環境に基づいてユーザー一覧をフィルタリングしたりできます。
認可を切り替える
メモ: 管理者およびスーパー管理者は、
すべての認可を表示ページから、自分自身の接続認可のみを切り替えることができます。
接続の切り替えとは、その接続に対して新しい認可を付与する操作です。次のような場合にも必要になります。
- 接続に紐づく認可情報の有効期限が切れた場合
- サードパーティサービス側で認証トークンが無効化または削除された場合
メモ: 接続の認可を切り替えると、その認可を利用しているすべてのアプリケーションは以後、新しい認可を使用します。
認可を切り替えるには:
- すべての認可を表示ページに移動し、自分の認可の上にカーソルを合わせます。
- 三点リーダーアイコンをクリックし、切り替えをクリックします。接続の認可を切り替えるよう求めるメッセージが表示されます。

-
すでに保存されているアカウントを再利用する場合は、認証済みアカウントドロップダウンから選択します。
メモ: 環境ごとに異なる認可を使用するを選択している場合のみ、ここで環境を選択できます。
- 別のアカウントの認証情報で接続を認証する場合は、新しいアカウントをリンクをクリックします。ポップアップで環境を選択し、認証をクリックします。

認可を取り消す
接続の認可を取り消すと、サードパーティサービスへの権限とアクセスが削除され、その接続認可を使用しているコンポーネントは想定どおりに動作しなくなります。
メモ:
- 管理者およびスーパー管理者は、すべての認可を表示ページから、自分自身の接続認可のみを取り消すことができます。
- 接続の認可を取り消しても、同じ認可を使用している他の接続や環境には影響しません。
- プライマリアカウントの認可を取り消す前に、別のアカウントをプライマリとして指定することを推奨します。この手順は、アプリケーションの機能を中断させないために重要です。プライマリアカウントのリンクを解除すると、リンクされているデータソースやスケジューラーが切断される可能性があります。
認可を取り消すには:
- すべての認可を表示ページに移動し、自分の認可の上にカーソルを合わせます。
- 三点リーダーアイコンをクリックし、取り消すをクリックします。

プライマリとして設定
ログインユーザー接続が作成されると、最初にその接続を認証した管理者のアカウントがプライマリアカウントとして指定されます。ただし、このプライマリアカウントのステータスは、別の管理者アカウントに移行できます。ログインユーザー接続では、統合サービスを単一のアカウント経由で利用するために、データソースやスケジューラーを作成する際にプライマリアカウントが必須です。
詳細はこちら
以下の手順に従って、アカウントをプライマリとして設定します。
メモ: プライマリアカウントのステータスを別の管理者アカウントに切り替えられるのは、管理者およびスーパー管理者のみです。
アカウントをプライマリとして設定するには:
- すべての認可を表示ページに移動し、プライマリとして設定したい別の管理者の認可の上にカーソルを合わせます。
-
三点リーダーアイコンをクリックし、プライマリとして設定をクリックします。
- 表示される確認ポップアップで続行を選択します。
アカウントは図のようにプライマリとしてマークされます。
2。13. インストール済み接続を管理する
インストール済み接続は、マーケットプレイスからインストールされた、または非公開で共有されたアプリケーションに関連付けられています。これらの接続は、[接続]タブで
インストール済み接続として一覧表示されます。アプリケーションがシステム接続と、同じサービスの既存接続を使用している場合、アプリケーションは既存の接続を参照します。これらの接続は認証または取り消しはできますが、編集や削除はできません。
メモ: インストール済み接続でも、環境ごとの認可が利用できます。
3. 注意点
- 接続を作成できるのは、スーパー管理者、管理者、および開発者のみです。
- システム接続を認証できるのは、スーパー管理者、管理者、および開発者のみです。
- ログインユーザー接続は、C6 でのみ作成できます。
- データソースやスケジューラーをログインユーザー接続で作成する場合、統合サービスを単一のアカウント経由で利用するために、プライマリアカウントが必須です。
- すべての環境で同じ認可を使用している接続のみ、データソースの作成に使用できます。
- 接続について
- 接続の作成と認証
- Zoho Creator アプリケーションの本番モードと編集モードでの接続