接続の管理

接続の管理

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

Notes
このヘルプページは、Creator 6のユーザー向けです。以前のバージョン（Creator 5）を使用している場合は、こちらをクリックしてください。Creatorのバージョンを確認してください。
このページの内容
他のZohoサービスや外部サービスをZoho Creatorアプリケーションと連携するために作成した接続を管理する方法を説明します。
利用条件
接続：
  1. Creatorの有料 プランでのみ利用できます
  2. 特権管理者と管理者は、マイクロサービスページから接続を作成、管理できます。開発者は、アプリケーションの編集権限があり、そのコンテキストでサポートされているサービスに限り、データソース内でのみ接続を作成できます。その他のユーザーは、接続の認証とアクセスのみ可能です
  3. すべてのデータセンターで利用できます

1. 接続の管理

［マイクロサービス］の下にある［接続］タブには、アカウントで作成されたすべての接続が表示されます。各接続はカードとして表示され、接続名、接続リンク名、接続の種類、ステータスが表示されます。
ページ右側の［フィルター］を使用すると、種類や関連付けられているアプリケーションで接続の一覧を絞り込めます。利用可能な接続の種類は次のとおりです。
  1. システム接続 - システムによって自動的に作成された接続
  2. ユーザー接続 - ユーザーによって作成された接続
  3. インストール済み接続 - Marketplaceからアプリケーションをインストールした場合、またはアプリケーションが個別に共有された場合に作成される接続
フィルターは単一または複数の条件として適用でき、アプリケーションフィルターと組み合わせることで、より詳細に結果を絞り込めます。選択したフィルターはタグとして表示され、個別に削除したり、まとめてクリアしたりできます。
検索ボックスを使用して、特定の接続やアプリケーションをすばやく探すこともできます。たとえば、Zoho CRM接続を検索し、フィルターを適用して、アプリケーションに関連付けられている接続のみを表示できます。
Notes
メモ：プライベートホスト型コネクターを使用して作成された接続は、設定済みのデータブリッジに依存します。これらの接続を使用または管理するには、Qntrlがシステム連携で設定され、有効なデータブリッジに関連付けられていることを確認してください。データブリッジが利用できない場合や停止している場合、プライベートホスト型コネクターを使用する接続は機能しません。
接続を管理すると、次の操作を実行できます。
  1. 接続の詳細ページを表示する
  2. 接続を編集する
  3. 接続の認証を切り替える
  4. 認証を取り消す
  5. 認証名を編集する
  6. 接続を無効にする
  7. 接続を有効にする
  8. 接続の参照を表示する
  9. 接続を削除する
  10. クライアント認証情報を更新する
  11. アプリケーションへの接続アクセスを有効または無効にする
  12. 環境ごとに異なる認証を使用する
  13. ログインユーザー接続の認証を表示、管理する

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

このページでは、対象の接続の基本情報を確認できます。また、接続の編集、削除、有効化/disabling,、認証の取り消しなど、一部の管理操作も実行できます。接続の詳細ページを表示するには：
  1. ［マイクロサービス］に移動し、以下のように、［接続］にある対象の接続カードをクリックします。
次の詳細が表示されます。
  1. 接続に対して自動生成された、またはユーザーが指定した表示名です。名前の横にある［編集］アイコンをクリックすると編集できます。
  2. ［リンク名］：バックエンドで接続に対して生成される一意の名前です。Delugeの連携タスクやURL呼び出しスクリプトで、認証を確立するために使用できます。
  3. 接続を使用しているアプリケーションの一覧です。
  4. ［権限］：接続の作成時にユーザーが選択したスコープです。
  5. ［クライアント認証情報］：クライアント認証情報に対して生成される一意の名前です。この自動生成された名前は、横にある［編集］アイコンをクリックすると編集できます。［ユーザー］アイコンにカーソルを合わせると、設定したユーザー名と設定日が表示されます。
  6. ［認証の所有者］：接続を管理者のみが認証できるか（管理者接続）、任意のユーザーが認証できるか（ログインユーザー接続）を示します
  7. ［認証］：3つの環境すべてで同じ認証を使用するか、環境ごとに異なる認証を使用するかを指定します。
  8. ［認証済みアカウント］：接続が認証されている場合、接続先アカウントの表示名です。この自動生成された名前は、認証済みアカウント名の横にある［編集］アイコンをクリックすると編集できます。
Notes
メモ：
- 環境を有効にしているアプリケーションでは、3つすべての環境の認証済みアカウント名が一覧表示されます。接続がログインユーザー接続の場合、その接続のすべての認証を表示するためのリンクが表示されます。
- 外部サービスから認証済みアカウント名が提供されていない場合、自動生成される認証済みアカウント名は次の形式になります：<service-name> Account <sequence>。例：Twilio Account 2。
外部サービスから認証済みアカウント名が提供されている場合は、同じ名前がアカウント名として表示されます。
  1. ［接続アクセス］：特定のアプリケーションへの接続アクセスを有効または無効にしたり、接続の［参照］を表示して、アプリケーション内で接続が使用されている正確な場所を確認したりできます。
  2. ［その他］：作成者、作成日時、最終更新者、最終更新日時などの情報です。

1.2. 接続の編集

接続の編集では、接続名、接続リンク名、スコープ設定を変更します。編集するには：
  1. ［マイクロサービス］に移動し、編集する接続カードにカーソルを合わせます。
  2. カードの右上にある横三点リーダー（3つの点）アイコンをクリックし、［接続を編集］をクリックします。

  3. 更新する情報を入力し、［更新］をクリックします。
     
Notes
メモ：接続の編集中に権限を変更した場合、既存の認証が無効になるため、接続の認証を求められます。

または、接続の詳細ページで横三点リーダーの［編集］をクリックして、接続を編集することもできます。

Notes
メモ：
  1. 認証情報を除くすべての項目を編集できます。
  2. 左上に表示されている接続の表示名の近くにある［名前の変更］アイコンをクリックすると、接続名を編集できます。

1.3. 接続の認証の切り替え

Info
情報：このセクションは、管理者接続とシステム接続にのみ適用されます。ログイン中のユーザー接続の切り替えについては、こちらをクリックしてください。
接続の切り替えとは、接続に新しい認証を付与する処理です。次のような場合にも必要です。
  1. 接続に関連付けられている認証情報の有効期限が切れた場合
  2. サードパーティーサービスで認証トークンが無効化または削除された場合
Notes
メモ：
  1. システム接続の認証を切り替えられるのは、特権管理者、管理者、開発者のみです。開発者はマイクロサービスにアクセスできないため、アプリケーションの本番モードまたは編集モードからのみ接続を認証できます。
  2. 管理者接続の認証は、すべての管理者が切り替えられます。
  3. 接続の認証を切り替えると、その認証を使用しているすべてのアプリケーションで、以後は新しい認証が使用されます。
認証を切り替えるには、次の手順を実行します。
  1. ［マイクロサービス］に移動します。アカウントで利用可能なすべての接続が、［接続］セクションに一覧表示されます。
  2. 切り替える接続カードにカーソルを合わせ、カード右上の横三点リーダー（3つの点）アイコンをクリックして、［切り替え］をクリックします。
  3. 保存済みのアカウントを再利用する場合は、［認証済みアカウント］のドロップダウンから選択します。別のアカウント情報で接続を認証する場合は、［新しいアカウントを関連付ける］をクリックします。
    Notesメモ：［環境ごとに異なる認証を使用する］を選択した場合のみ、ここで環境を選択できます。

  4. ポップアップに認証の詳細を入力し、［認証］をクリックします。
または、対象の接続の接続の詳細ページで［認証済みアカウント］の横にある［切り替え］をクリックして、接続を再認証することもできます。アカウント名を入力し、以降の手順（対象サービスの認証方式によって異なります）を実行して認証します。その後、既存の認証は無効になり、新しい認証が有効になります。

1.4. 認証の取り消し

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

1.5. 認証名の編集

接続を作成すると、認証名は自動生成されます。接続の認証名を編集するには、対象の接続の接続の詳細ページに移動し、以下のように編集アイコンをクリックします。

表示されたポップアップに新しい認証名を入力し、［完了］をクリックします。

1.6. 接続の無効化

接続を無効にすると、接続の機能が停止されるため、接続は非アクティブになり、どのアプリケーションでも使用できなくなります。アプリケーションで使用されている接続を無効にすると、有効に戻すまで、本来の処理は実行されません。無効にするには、次の手順を実行します。
  1. ［Microservices］に移動します。アカウントで利用可能なすべての接続が、［接続］セクションに表示されます。
  2. 無効にする接続カードにカーソルを合わせます。
  3. カードの右上にある横三点リーダー（3つの点）アイコンをクリックし、［無効化］をクリックします。
Notes
メモ：
  1. 接続がいずれのアプリケーションでも使用されていない場合、［無効化］をクリックするとすぐに無効になります。それ以外の場合、接続を使用しているすべての場所の詳細を示すポップアップが表示され、その後で接続の［無効化に進む］ことができます。
  2. 複数のデータソースが接続にリンクされている場合、その接続を無効にする前に、関連付けられているすべてのデータソースを無効にする必要があります。


または、横三点リーダーの［無効化］をクリックして、接続の詳細ページから図のように接続を無効にすることもできます。

1.7. 接続の有効化

接続を有効にすると、以前に無効にした接続が有効化され、データソースやワークフロー内のDelugeスクリプトなど、その接続が使用されているさまざまな場所で機能が復元されます。有効にするには、次の手順を実行します。
  1. ［Microservices］に移動します。アカウントで利用可能なすべての接続が、［接続］セクションに表示されます。
  2. 有効にするグレー表示の接続カードにカーソルを合わせます。
  3. カードの右上にある横三点リーダー（3つの点）アイコンをクリックし、［有効化］をクリックします。
または、接続の詳細ページ、から横三点リーダーの［有効化］をクリックして、図のように接続を有効にすることもできます。

1.8. 接続の参照先の表示

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

1.9. 接続の削除

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

  5. それ以外の場合、接続を使用しているすべての場所の詳細を示すポップアップが表示されます。接続の［削除に進む］には、表示された使用箇所をすべて削除する必要があります。
または、接続の詳細ページ、から横三点リーダーの［削除］をクリックして、図のように接続を削除することもできます。

1.10. クライアント認証情報の更新

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

クライアント認証情報を更新するには、次の手順を実行します。

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

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

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

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

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

Notes
メモ：このセクションは、システム接続、管理者接続、ログインユーザー接続のすべての種類の接続に適用されます。
［接続の詳細］ページの［接続アクセス］セクションでは、特定のアプリケーションへの接続アクセスを有効または無効にできます。これにより、接続はアクセスが有効なアプリケーションでのみ利用できるようになります。

1.12. 環境別認証

接続を作成すると、個別に設定しない限り、初期設定では開発、ステージング、本番の3つの環境すべてで同じ認証が使用されます。この設定は、連携で各環境に同じ認証情報を使用する場合に適しています。後で異なる認証情報を使用する場合、Creatorでは環境別認証を有効にできます。これにより、各環境に固有の認証を設定できます。異なる認証を使用することで、環境ごとの権限を維持しながら、各環境の要件に合わせてアクセスや権限を調整できます。

ただし、本番環境へ移行する前にステージング環境や開発環境で別のAPIキーを使ってテストする場合など、個別の認証が必要になることがあります。

環境別認証の有効化
環境別認証は、接続の作成時に有効にできます。作成時にスキップした場合でも、既存の接続に対して次の方法で後から有効にできます。
  1. 接続の一覧ページで、対象の接続の横にある省略記号メニューから［環境別認証を使用する］を選択します。

  2. ［接続の詳細］ページで、認証の横にある［環境別に使用］ボタンをクリックします。

その後、管理者は任意の環境を選択して認証するよう求められます。
Notes
メモ：
  1. 同じ認証プロパティの一部として本番環境の認証がすでに存在する場合、「すべての環境で同じ認証」から「環境別認証」に切り替えても、その認証は保持されます。ただし、必要に応じて管理者は本番環境を再認証できます。
  2. 接続が1つ以上のデータソースに関連付けられている場合、環境別認証は有効にできません。
  3. 環境別認証を有効にすると、すべての環境で同じ認証に戻すことはできません。ただし、すべての環境を選択して認証を完了することで、同じ結果を得ることができます。
対象の環境で接続を認証するには、以下の手順に従います。

1.12.1 異なる環境での認証

環境別認証が有効になっているものの、認証がまだ完了していない場合は、以下の手順に従って環境を認証します。
  1. 接続カードをクリックして接続の詳細ページに移動し、［認証］をクリックします。

  2. ドロップダウンから［認証済みアカウント］を選択し、環境を選択します。［再利用］をクリックします。
    メモ：接続の作成時に、［環境ごとに異なる認証を使用する］プロパティを有効にしていることを確認してください。この設定を有効にした場合にのみ、こちらで環境を選択できます。
  3. 別の認証情報で接続を認証するには、［新しいアカウントを関連付ける］をクリックします。認証を必須にする環境を選択します。［認証］をクリックします。

1.13. ログインユーザー接続の認証の管理

ログインユーザー接続を作成すると、そのアプリケーションのログインユーザーであれば、ライブモードまたは編集モードで認証してアクセスできます。ただし、すべての認証情報は管理者が表示および管理できます。ログインユーザー接続の管理には、次の操作が含まれます。
  1. すべての認証の表示
  2. 認証の切り替え
  3. 認証の取り消し
  4. アカウントをプライマリーとして設定
すべての認証の表示
［すべての認証の表示］ページには、接続に関連付けられているすべての認証が一覧表示されます。すべての認証を表示するには、次の手順を実行します。
  1. 接続カードをクリックして接続の詳細ページに移動し、［すべての認証を表示］をクリックします。
表示されているように、ユーザー名、認証日、ユーザーのメールアドレス、ユーザーの種類の詳細とともに、すべての認証を一覧で確認できます。検索バーを使用して特定のユーザーを検索したり、ユーザーの種類と環境に基づいてユーザー一覧をフィルターしたりできます。

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

    メモ：こちらで環境を選択できるのは、［環境ごとに異なる認証を使用］を選択した場合のみです。
  4. または、別のアカウントの認証情報でコネクションを認証するには、［新しいアカウントをリンク］をクリックします。ポップアップで環境を選択し、［認証］をクリックします。

認証の取り消し
コネクションの認証を取り消すと、サードパーティサービスへの権限とアクセス権が削除され、そのコネクション認証を使用しているコンポーネントは意図したとおりに機能しなくなります。
Notes
メモ：
  1. 管理者と特権管理者は、すべての認証の表示ページから、コネクションに対する自分の認証のみを取り消すことができます。
  2. コネクションの認証を取り消しても、同じ認証を使用している他のコネクションや環境には影響しません。
  3. メインアカウントの認証を取り消す前に、別のアカウントをメインとして指定することをおすすめします。メインアカウントのリンクを解除すると、関連付けられているデータソースやスケジューラーの接続が解除される可能性があるため、アプリケーションの機能を継続して利用するには、この手順が不可欠です。
認証を取り消すには：
  1. すべての認証の表示ページに移動し、自分の認証にカーソルを合わせます。
  2. 横三点リーダーをクリックし、［取り消す］をクリックします。
メインアカウントへの設定
ログインユーザーコネクションを作成すると、最初に認証した管理者のアカウントがメインアカウントとして指定されます。ただし、このメインアカウントの状態は、別の管理者のアカウントに移行できます。ログインユーザーコネクションでは、連携サービスを単一のアカウント経由にまとめるため、データソースやスケジューラーを作成する際にメインアカウントが必要です。詳細はこちら
アカウントをメインとして設定するには、以下の手順を実行します。
Notes
メモ：メインアカウントの状態を別の管理者のアカウントに切り替えられるのは、管理者と特権管理者のみです。
アカウントをメインとして設定するには：
  1. すべての認証の表示ページに移動し、メインとして設定する別の管理者の認証にカーソルを合わせます。
  2. 横三点リーダーをクリックし、［メインに設定］をクリックします。
  3. 表示される確認ポップアップで、［続行］を選択します。
表示されているように、アカウントがメインとして設定されます。

1.14. インストール済みコネクションの管理

インストール済みコネクションは、Marketplaceからインストールされたアプリケーション、または非公開で共有されたアプリケーションに関連付けられています。これらのコネクションは、［コネクション］タブにインストール済みコネクションとして表示されます。アプリケーションがシステムコネクションを使用しており、同じサービスのコネクションがアカウントにすでに存在する場合、アプリケーションは既存のコネクションを参照します。これらのコネクションは認証または認証の取り消しはできますが、編集や削除はできません。
Notes
メモ：環境別認証は、インストール済みコネクションでも利用できます。

2. 注意事項

  1. コネクションを作成できるのは、特権管理者、管理者、開発者のみです。
  2. システムコネクションを認証できるのは、特権管理者、管理者、開発者のみです。
  3. ログインユーザーコネクションは、C6でのみ作成できます。
  4. データソースやスケジューラーをログインユーザーコネクションを使用して作成する場合、連携サービスを単一のアカウント経由にまとめるため、メインアカウントが必須です。
  5. すべての環境で同じ認証を使用するコネクションのみ、データソースの作成に使用できます。
  1. コネクションの概要
  2. コネクションの作成と認証
  3. ライブモードと編集モードでのコネクション
次へ
前へ
次へ
Zoho Creatorアプリケーションのライブモードと編集モードで、コネクションを表示／管理する方法を確認します。
前へ
詳しくは、コネクションの概要と、作成して認証する方法をご参照ください。