接続管理

接続管理

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Notes
このヘルプページは Creator 6 をご利用の方向けです。旧バージョン（Creator 5）をお使いの場合は、こちらをクリックしてください。ご利用中の Creator のバージョンを確認してください。
このページの内容
Zoho Creator アプリケーションと他の Zoho サービスやサードパーティサービスを連携するために作成した接続の管理方法について説明します。
提供状況
接続:
  1. Creator の有料プランでのみ利用できます
  2. スーパー管理者、管理者、開発者のみが作成および管理でき、他のユーザーは承認と利用のみ行えます
  3. すべてのデータセンターで利用できます

1. 接続を管理する

Microservices 内の Connections タブには、アカウントで作成されたすべての接続が表示されます。各接続はカード形式で表示され、接続名、接続リンク名、接続タイプ、ステータスが含まれます。
画面右側の Filter オプションを使用して、接続の種類や関連アプリケーションで一覧を絞り込むことができます。利用可能な接続タイプは次のとおりです。
  1. システム接続 - システムによって自動的に作成される接続
  2. ユーザー接続 - ユーザーが作成した接続
  3. インストール済み接続 - マーケットプレイスからアプリケーションをインストールしたとき、または非公開共有されたときに作成される接続
フィルターは単一条件でも複数条件でも適用でき、アプリケーションフィルターと組み合わせて、より詳細に絞り込むこともできます。選択したフィルターはタグとして表示され、個別に削除するか、一括でクリアできます。
また、検索ボックスを使用して、特定の接続やアプリケーションをすばやく見つけることもできます。たとえば、Zoho CRM 接続を検索し、その後フィルターを適用して、特定のアプリケーションに関連付けられた接続のみを表示できます。

接続を管理すると、次の操作が可能になります。
  1. 接続の詳細ページを表示する
  2. 接続を編集する
  3. 接続の認可を切り替える
  4. 認可を取り消す
  5. 認可名を編集する
  6. 接続を無効にする
  7. 接続を有効にする
  8. 接続の参照先を表示する
  9. 接続を削除する
  10. クライアント認証情報を更新する
  11. アプリケーションへの接続アクセスを有効／無効にする
  12. 環境ごとに異なる認可を使用する
  13. ログインユーザー接続の認可を表示および管理する

1.1. 接続の詳細ページを表示する

このページでは、対象の接続の基本情報を確認し、編集、削除、有効化／無効化、認可の取り消しなどの管理操作を行うことができます。Connection Details Page を表示するには、次の操作を行います。
  1. Microservices に移動し、下図のように Connections 内で対象の接続カードをクリックします。
次の情報が表示されます:
  1. 接続に対して自動生成された、またはユーザーが指定した表示名。名前の横にある編集アイコンをクリックして変更できます。
  2. Link Name: バックエンドで接続に対して生成される一意の名前。Deluge の連携タスクや URL 呼び出しスクリプトで、認可を確立するために使用できます。
  3. 接続を使用しているアプリケーションの一覧。
  4. Permission: 接続の作成時にユーザーが選択したスコープ。
  5. Client Credential: クライアント認証情報に対して生成される一意の名前です。この自動生成された名前は、横にあるedit アイコンをクリックして編集できます。ユーザーアイコンにカーソルを合わせると、その認証情報を設定したユーザー名と設定日が表示されます。
  6. Authorization Owner: 接続を管理者のみが認可できるか（管理者接続）、または任意のユーザーが認可できるか（ログインユーザー接続）を示します。
  7. Authorization: 3 つの環境すべてで同じ認可を使用するか、環境ごとに異なる認可を使用するかを示します。
  8. Authorized Account: 接続が認可されている場合に表示される、接続先アカウントの表示名。この自動生成された名前は、認可済みアカウント名の横にある edit アイコンをクリックして編集できます。
Notes
メモ:
- 環境を有効にしているアプリケーションでは、3 つの環境すべての認可済みアカウント名が一覧表示されます。接続がログインユーザー接続の場合、その接続に対するすべての認可を表示するリンクが利用できます。
- サードパーティ側からアカウント名が提供されない場合、自動生成される認可済みアカウント名は <service-name> Account <sequence> の形式になります。たとえば、Twilio Account 2 のようになります。
サードパーティからアカウント名が提供されている場合は、その名前がアカウント名として表示されます。
  1. Connection access: 特定のアプリケーションに対する接続のアクセスを有効／無効にしたり、references を表示して、その接続がアプリケーション内のどこで使用されているかを正確に確認したりできます。
  2. その他: 作成者、作成日時、最終更新者、最終更新日時などの情報。

1.2. 接続を編集する

接続の編集では、接続名、接続リンク名、スコープ設定を変更します。編集するには、次の操作を行います。
  1. Microservices に移動し、編集したい接続カードにカーソルを合わせます。
  2. カード右上の三点リーダー（縦三点）アイコンをクリックし、Edit Connection をクリックします。

  3. 更新したい情報を入力し、Update をクリックします。
     
Notes
メモ: 接続の編集時に権限（Permission）を変更した場合、既存の認可は無効になるため、接続の再認可を求めるメッセージが表示されます。

また、 Connection Details Page の三点リーダーから Edit をクリックして、接続を編集することもできます。

Notes
メモ:
  1. 認証情報を除くすべての項目は編集できます。
  2. 左上に表示される接続名の横にあるRenameアイコンをクリックすると、接続名を編集できます。

1.3. 接続の認可を切り替える

Info
Info: このセクションは管理者接続およびシステム接続にのみ適用されます。ログインユーザー接続の切り替えについてはこちらを参照してください。
接続の切り替えとは、その接続に対して新しい認可を付与する操作です。次のような場合にも必要になります:
  1. 接続に紐づく認証情報の有効期限が切れた場合
  2. サードパーティサービス側で認可トークンが無効化または削除された場合
Notes
メモ:
  1. システム接続の認可を切り替えられるのは、スーパー管理者、管理者、開発者のみです。マイクロサービスは開発者からはアクセスできないため、開発者はアプリケーションの本番モードまたは編集モードからのみ接続を認可できます。
  2. 管理者接続の認可は、すべての管理者が切り替えることができます。
  3. 接続の認可を切り替えると、その接続を利用しているすべてのアプリケーションは以後、新しい認可を使用します。
認可を切り替えるには、次の操作を行います:
  1. Microservicesに移動します。アカウントで利用可能なすべての接続がConnectionsセクションに一覧表示されます。
  2. 認可を切り替えたい接続カードにカーソルを合わせ、カード右上の三点リーダー（3つの点）アイコンをクリックし、Switchをクリックします。
  3. すでに保存されているアカウントを再利用する場合はAuthorized Accountドロップダウンから選択し、別のアカウントの認証情報で接続を認可する場合はLink New Accountをクリックします。
    Notesメモ: 環境ごとに異なる認可を使用する場合はUse different authorization for each environmentを選択しているときのみ、ここで環境を選択できます。

  4. ポップアップで認可の詳細を入力し、Authorizeをクリックします。
また、目的の接続の接続の詳細ページで、Authorized Account の横にあるSwitchをクリックして接続を再認可することもできます。アカウント名を入力し、以降の手順（利用するサービスの認可方式によって異なります）を実行して認可を完了します。これにより、既存の認可は無効になり、新しい認可が有効になります。

1.4. 認可を取り消す

InfoInfo: このセクションは管理者接続およびシステム接続にのみ適用されます。ログインユーザー接続の認可取り消しについてはこちらを参照してください。
Notes
メモ:
  1. システム接続の認可を取り消せるのは、スーパー管理者、管理者、開発者のみです。マイクロサービスは開発者からはアクセスできないため、開発者はアプリケーションの本番モードまたは編集モードからのみ接続を認可できます。
  2. 管理者接続の認可は、すべての管理者が取り消すことができます。
  3. ある接続の認可を取り消しても、同じ認可を使用している他の接続には影響しません。
接続の認可を取り消すと、サードパーティサービスへの権限とアクセスが削除され、その接続の認可を使用しているコンポーネントは意図したとおりに動作しなくなります。接続の認可を取り消すには、目的の接続の接続の詳細ページに移動し、下図のように取り消しアイコン（）をクリックします。
環境ごとに異なる認可を使用している接続の場合は、接続の詳細ページで、取り消したい環境の横にある取り消しアイコン（）をクリックします（下図参照）。

1.5. 認可名を編集する

接続を作成すると、認可名は自動生成されます。接続の認可名を編集するには、目的の接続の接続の詳細ページに移動し、下図の編集アイコンをクリックします。

表示されるポップアップで新しい認可名を入力し、Doneをクリックします。

1.6. 接続を無効にする

接続を無効にすると、その接続の機能が停止します。無効化された接続は非アクティブとなり、いずれのアプリケーションでも使用できなくなります。アプリケーションで使用している接続が無効化されると、再度有効にするまで、その接続は本来の処理を実行しません。無効にするには、次の操作を行います:
  1. Microservicesに移動します。アカウントで利用可能なすべての接続がConnections セクションに一覧表示されます。
  2. 無効にしたい接続カードにカーソルを合わせます。
  3. カード右上の三点リーダー（3つの点）アイコンをクリックし、Disableをクリックします。
Notes
メモ:
  1. 接続がいずれのアプリケーションでも使用されていない場合は、Disable をクリックすると直ちに無効化されます。使用されている場合は、Proceed to Disableで無効化を続行する前に、その接続が使用されているすべての場所の詳細を示すポップアップが表示されます。
  2. 1つの接続に複数のデータソースがリンクされている場合、その接続を無効にする前に、その接続に関連付けられているすべてのデータソースを無効にする必要があります。


また、代わりに、接続の詳細ページ で、カードの右上にある三点リーダーから無効化をクリックして接続を無効にすることもできます。

1.7. 接続を有効化する

接続を有効化すると、以前無効化した接続が再度アクティブになり、データソースやワークフロー内の Deluge スクリプトなど、その接続が使用されているさまざまな箇所での機能が復元されます。有効化するには、次の操作を行います:
  1. Microservices に移動します。アカウントで利用可能なすべての接続が、Connections セクションに一覧表示されます。
  2. 有効化したいグレー表示の接続カードにカーソルを合わせます。
  3. カード右上の三点リーダー（縦三点アイコン）をクリックし、有効化をクリックします。
また、接続の詳細ページで、三点リーダーから「有効化」をクリックして接続を有効化することもできます（図参照）。

1.8. 接続の参照先を表示する

「参照」には、その接続が使用されているデータソースやアプリケーション内など、すべての場所の一覧が表示されます。参照先を表示するには、次の操作を行います:
  1. Microservices に移動します。アカウントで利用可能なすべての接続が、Connections セクションに一覧表示されます。
  2. 対象の接続カードにカーソルを合わせます。
  3. カード右上の三点リーダー（縦三点アイコン）をクリックし、参照をクリックします。

1.9. 接続を削除する

削除すると、指定した接続は Creator アカウントから完全に削除されます。
  1. Microservices に移動します。アカウントで利用可能なすべての接続が、Connections セクションに一覧表示されます。
  2. 削除したい接続カードにカーソルを合わせます。
  3. カード右上の三点リーダー（縦三点アイコン）をクリックし、削除をクリックします。
  4. 接続がいずれのアプリケーションでも使用されていない場合は、表示される確認ポップアップで削除をクリックすると、直ちに削除されます。

  5. それ以外の場合は、その接続を使用しているすべての場所の詳細が記載されたポップアップが表示されます。接続を削除を続行するには、表示されているすべての利用箇所を削除する必要があります。

また、接続の詳細ページで、三点リーダーから「削除」をクリックして接続を削除することもできます（図参照）。

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

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

クライアント認証情報を更新するには:

  1. Microservices > Connectionsページに移動し、対象の接続を開きます。
  2. 接続の詳細ページで、左ペインのクライアント認証情報セクションの横にある更新ボタンをクリックします。
  3. 続いて表示されるポップアップで、新しいクライアント認証情報名と、サードパーティ OAuth アプリの更新後のクライアントシークレットを選択します。新しいクライアント IDとクライアントシークレットを追加することもできます。既存のクライアントシークレットは表示されず、再利用することはできません。
  4. 接続の動作を復元するには、更新して認可をクリックします。

クライアント認証情報は、アプリケーションの ライブモードから更新することもできます。

クライアント認証情報名を編集するには:

カスタム認証情報で接続を作成すると、クライアント認証情報名は自動生成されます。クライアント認証情報名を編集するには、対象の接続のConnection Detailsページに移動し、編集アイコンをクリックします。
 
Notes
メモ: 
  1. 新しいクライアントIDを追加する場合は、それに関連付けられた新しいクライアントシークレットも必ず追加してください。 
  2. 認証情報の所有者（認証情報を追加したユーザー）のみが更新できます。その他のロールでは、Updateオプションは無効になり、ホバーするとツールチップが表示されます。 
  3. 開発者の場合、認証情報の再利用は、関連付けられたアプリケーション内でのみ許可されます。 
  4. 接続が別のアプリケーションで参照されている場合、ライブモードからは更新できません。
  5. インポートしたアプリケーションに、カスタムモードが設定された接続が含まれている場合、該当するクライアント認証情報は転送されません。接続詳細ページで［Configure］をクリックして接続を再設定し、その後、再度認可する必要があります。

1.11. アプリケーションへの接続アクセスを有効化／無効化する

Notes
メモ: このセクションは、システム接続、管理者接続、ログインユーザー接続など、すべての種類の接続に適用されます。
Connection Details Page の［Connection Access］セクションでは、特定のアプリケーションに対する接続アクセスを有効または無効にできます。これにより、接続はアクセスが有効になっているアプリケーションでのみ利用可能になります。

1.12. 環境ごとの認可

接続を作成すると、別々に設定しない限り、デフォルトでは同じ認可が3つの環境（開発、ステージング、本番）すべてで使用されます。この構成は、すべての環境で同じ認証情報を使用する統合に最適です。後から異なる認証情報を使用することにした場合でも、Creator では「環境ごとの認可」を有効にでき、各環境ごとに個別の認可を設定できます。異なる認可を使用することで、環境ごとの権限やアクセスレベルの要件に合わせて柔軟に設定しつつ、環境固有の権限を維持できます。

たとえば、本番環境に移行する前に、ステージングや開発環境で異なるAPIキーを使ってテストする必要がある場合など、環境ごとに別々の認可が必要になるケースがあります。

環境ごとの認可を有効にする
接続の作成時に「環境ごとの認可」を有効にできます。作成時に有効にしなかった場合でも、既存の接続に対して次のいずれかの方法で後から有効にできます。
  1. 接続一覧ページで、対象の接続の横にある三点リーダーのメニューからUse Per-Environment Authorizationを選択します。

  2. Connection details pageで、認可の横にあるUse Per Environmentボタンをクリックします。

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

1.12.1 環境ごとの認可を行う

「環境ごとの認可」が有効になっていても、まだ認可が完了していない場合は、以下の手順に従って各環境を認可します。
  1. 接続カードをクリックしてconnection details page に移動し、Authorizeをクリックします。

  2. ドロップダウンからAuthorized Accountを選択し、環境を選択します。［Reuse］をクリックします。
    メモ: 接続を作成する際に、必ずUse different authorizations for different environmentsプロパティを有効にしておいてください。このプロパティを有効にしている場合にのみ、ここで環境を選択できます。
  3. 別の認証情報で接続を認可するには、Link New Accountをクリックします。認可を行う必要がある環境を選択し、Authorizeをクリックします。

1.13. ログインユーザー接続の認可を管理する

ログインユーザー接続を作成すると、そのアプリケーションにログインしている任意のユーザーが、ライブモードまたは編集モードでその接続を認可して利用できます。ただし、すべての認可の詳細は管理者が閲覧および管理できます。ログインユーザー接続の管理には、次の操作が含まれます。
  1. すべての認可の表示
  2. 認可の切り替え
  3. 認可の取り消し
  4. アカウントをプライマリとして設定
すべての認可の表示
［View All Authorizations］ページでは、その接続に関連付けられているすべての認可を一覧で確認できます。すべての認可を表示するには、次の手順を実行します。
  1. 接続カードをクリックしてconnection details page に移動し、View all Authorizationsをクリックします。
ユーザー名、認可日、ユーザーのメールアドレス、ユーザータイプなどの詳細とともに、すべての認可が一覧表示されます。検索バーを使用して特定のユーザーを検索したり、ユーザータイプや環境でフィルターしてユーザー一覧を絞り込むことができます。

認可を切り替える
Notes
メモ:管理者およびスーパー管理者は、すべての認可を表示ページから、自分自身の接続認可のみを切り替えることができます。
接続の切り替えとは、その接続に対して新しい認可を付与する処理です。次のような場合にも必要になります。
  1. 接続にリンクされている認可情報の有効期限が切れた場合
  2. サードパーティサービス側で認可トークンが無効化または削除された場合
Notes
メモ:接続の認可を切り替えると、その接続を利用しているすべてのアプリケーションは以後、新しい認可を使用します。
認可を切り替えるには:
  1. すべての認可を表示ページに移動し、自分の認可にカーソルを合わせます。
  2. 三点リーダーアイコンをクリックし、[切り替え]をクリックします。接続の認可を切り替えるよう求められます。
  3. [認可済みアカウント]ドロップダウンから、保存済みアカウントを再利用するかどうかを選択します。

    メモ: [環境ごとに異なる認可を使用] を選択している場合のみ、ここで環境を選択できます。
  4. 別のアカウントの認可を使用する場合は、[新しいアカウントをリンク]をクリックして接続を認可します。ポップアップで環境を選択し、[認可]をクリックします。

認可を取り消す
接続の認可を取り消すと、そのサードパーティサービスへの権限とアクセスが削除され、その接続認可を使用しているコンポーネントは想定どおりに動作しなくなります。
Notes
メモ:
  1. 管理者およびスーパー管理者は、すべての認可を表示ページから、自分自身の接続認可のみを取り消すことができます。
  2. ある接続の認可を取り消しても、同じ認可を使用している他の接続や環境には影響しません。
  3. プライマリアカウントの認可を取り消す前に、別のアカウントをプライマリとして指定することを推奨します。プライマリアカウントのリンクを解除すると、リンクされているデータソースやスケジューラーが切断され、アプリケーションの機能が中断される可能性があるため、この手順は重要です。
認可を取り消すには:
  1. すべての認可を表示ページに移動し、自分の認可にカーソルを合わせます。
  2. 三点リーダーアイコンをクリックし、[取り消し]をクリックします。
プライマリとしてマークする
ログインユーザー接続が作成されると、その接続を最初に認可した管理者のアカウントがプライマリアカウントとして指定されます。ただし、このプライマリアカウントのステータスは、別の管理者アカウントに移行できます。ログインユーザー接続では、統合サービスを単一アカウント経由で利用するために、データソースやスケジューラーを作成する際にプライマリアカウントが必要です。詳細はこちら
以下の手順に従って、アカウントをプライマリとしてマークします。
Notes
メモ: プライマリアカウントのステータスを別の管理者アカウントに切り替えられるのは、管理者およびスーパー管理者のみです。
アカウントをプライマリとしてマークするには:
  1. すべての認可を表示ページに移動し、プライマリとしてマークしたい別の管理者の認可にカーソルを合わせます。
  2. 三点リーダーアイコンをクリックし、[プライマリとしてマーク]をクリックします。
  3. 表示される確認ポップアップで[続行]を選択します。
アカウントがプライマリとしてマークされ、次のように表示されます。

1.14. インストール済み接続を管理する

インストール済み接続は、マーケットプレイスからインストールされた、またはプライベート共有されたアプリケーションに関連付けられています。これらの接続は、[接続]タブでインストール済み接続として一覧表示されます。アプリケーションがシステム接続を使用しており、同じサービスの接続がすでにアカウント内に存在する場合、アプリケーションは既存の接続を参照します。これらの接続は認可または取り消しはできますが、編集や削除はできません。
Notes
メモ: インストール済み接続でも、環境ごとの認可を利用できます。

2. 注意点

  1. 接続を作成できるのは、スーパー管理者、管理者、および開発者のみです。
  2. システム接続を認可できるのは、スーパー管理者、管理者、および開発者のみです。
  3. ログインユーザー接続は、C6 でのみ作成できます。
  4. ログインユーザー接続を使用してデータソースやスケジューラーを作成する場合、統合サービスを単一アカウント経由で利用するために、プライマリアカウントが必須です。
  5. すべての環境で同じ認可を使用している接続のみ、データソースの作成に使用できます。
  1. 接続について理解する
  2. 接続を作成して認可する
  3. ライブモードと編集モードでの接続
次のステップ
前のトピック
次のステップ
Zoho Creator アプリケーションのライブモードと編集モードで、接続を表示および管理する方法を確認しましょう。
前のトピック
まずは接続について学び、接続を作成して認可する方法を確認しましょう。