接続の管理
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
このページの概要
他のZohoサービスや外部サービスをZoho Creatorアプリケーションと連携するために作成した接続の管理方法について説明します。
利用条件
1. 接続の管理
［接続］タブは［マイクロサービス］内にあり、アカウントで作成されたすべての接続が表示されます。各接続はカードとして表示され、接続名、接続リンク名、接続の種類、ステータスが記載されています。
ページ右側の［フィルター］を使用すると、種類や関連付けられたアプリケーションで接続の一覧を絞り込めます。利用可能な接続の種類は次のとおりです。
- システム接続 - システムによって自動的に作成された接続
- ユーザー接続 - ユーザーが作成した接続
- インストール済み接続 - Marketplaceから、または非公開で共有されたアプリケーションをインストールした際に作成された接続
フィルターには1つまたは複数の条件を指定でき、アプリケーションのフィルターと組み合わせて、さらに詳細に絞り込むこともできます。選択したフィルターはタグとして表示され、個別に削除することも、すべてまとめて解除することもできます。
検索ボックスを使用して、特定の接続やアプリケーションをすばやく検索することもできます。たとえば、Zoho CRMの接続を検索してからフィルターを適用すると、アプリケーションに関連付けられた接続のみを表示できます。
接続の管理では、次の操作を行えます。
- 接続の詳細ページの表示
- 接続の編集
- 接続の認証の切り替え
- 認証の取り消し
- 認証名の編集
- 接続の無効化
- 接続の有効化
- 接続の参照先の表示
- 接続の削除
- クライアント認証情報の更新
- 接続によるアプリケーションへのアクセスの有効化または無効化
- 環境ごとの認証
- ログインユーザー接続の認証の管理
- インストール済み接続の管理
1.1. 接続の詳細ページの表示
このページでは、対象の接続の基本情報を確認できるほか、編集、削除、有効化／無効化、認証の取り消しなどの管理操作を実行できます。接続の詳細ページを表示するには、次の手順を実行します。
- ［マイクロサービス］に移動し、以下のように［接続］で対象の接続カードをクリックします。
次の詳細情報が表示されます。
-
接続に対して自動生成された、またはユーザーが指定した表示名。名前の横にある編集アイコンをクリックすると編集できます。
-
［リンク名］：接続用にバックエンドで生成された一意の名前。Delugeの連携タスクやURL呼び出しスクリプトで、認証を確立するために使用できます。
-
接続を使用しているアプリケーションの一覧。
-
［権限］：接続の作成時にユーザーが選択したスコープ。
-
［クライアント認証情報］：クライアント認証情報に対して生成された一意の名前。この自動生成された名前は、横にある編集アイコンをクリックすると編集できます。ユーザーアイコンにカーソルを合わせると、設定したユーザーの名前と設定日が表示されます。
-
［認証の所有者］：接続を管理者のみが認証できるか（管理者接続）、すべてのユーザーが認証できるか（ログインユーザー接続）を示します
-
［認証］：3つの環境すべてで同じ認証を使用するか、環境ごとに異なる認証を使用するかを示します。
-
［認証済みアカウント］：接続が認証済みの場合に、接続先アカウントの表示名が表示されます。この自動生成された名前は、認証済みアカウント名の横にある編集アイコンをクリックすると編集できます。
メモ：
- 環境が有効になっているアプリケーションでは、3つすべての環境の認証済みアカウント名が一覧表示されます。接続がログインユーザー接続の場合、接続のすべての認証を表示するためのリンクが表示されます。
- 外部サービスから認証済みアカウント名が提供されていない場合、自動生成される認証済みアカウント名は<サービス名> アカウント <連番>の形式になります。例：Twilio アカウント 2
外部サービスから認証済みアカウント名が提供されている場合は、その名前がアカウント名として表示されます。
- 環境が有効になっているアプリケーションでは、3つすべての環境の認証済みアカウント名が一覧表示されます。接続がログインユーザー接続の場合、接続のすべての認証を表示するためのリンクが表示されます。
- 外部サービスから認証済みアカウント名が提供されていない場合、自動生成される認証済みアカウント名は<サービス名> アカウント <連番>の形式になります。例：Twilio アカウント 2
外部サービスから認証済みアカウント名が提供されている場合は、その名前がアカウント名として表示されます。
- ［接続へのアクセス］：接続による特定のアプリケーションへのアクセスを有効または無効にできます。また、接続の参照先を表示して、アプリケーション内で接続が使用されている正確な場所を確認できます。
- ［その他］：作成者、作成日時、最終更新者、最終更新日時などの情報。
1.2. 接続の編集
接続を編集すると、接続名、接続リンク名、スコープ設定を変更できます。編集するには、次の手順を実行します。
- ［マイクロサービス］に移動し、編集する接続カードにカーソルを合わせます。
- カードの右上にある横向きの三点リーダーアイコンをクリックし、［接続を編集］をクリックします。
- 更新する情報を入力し、［更新］をクリックします。
メモ：接続の編集中に権限を変更した場合、既存の認証が無効になるため、接続を再認証するよう求められます。
メモ：
- 認証情報を除くすべての項目を編集できます。
- 左上にある接続の表示名の近くに配置された［名前の変更］アイコンをクリックすると、接続名を編集できます。
1.3. 接続の認証の切り替え
接続の切り替えでは、接続に新しい認証を付与します。また、次のような場合にも必要です。
- 接続に関連付けられた認証情報の有効期限が切れた場合
- 外部サービスで認証トークンが無効化または削除された場合
メモ：
- システム接続の認証を切り替えられるのは、特権管理者、管理者、開発者のみです。開発者はマイクロサービスにアクセスできないため、アプリケーションの公開モードまたは編集モードからのみ接続を認証できます。
- 管理者接続の認証は、すべての管理者が切り替えられます。
- 接続の認証を切り替えると、その接続を使用するすべてのアプリケーションで、それ以降は新しい認証が使用されます。
認証を切り替えるには。
- ［マイクロサービス］に移動します。アカウントで利用可能なすべての接続が、［接続］セクションに一覧表示されます。
- 切り替える接続のカードにカーソルを合わせ、カードの右上にある横三点リーダーアイコンをクリックして、［切り替え］をクリックします。
-
保存済みのアカウントを再利用する場合は、［認証済みアカウント］のドロップダウンから選択します。別のアカウント情報で接続を認証する場合は、［新しいアカウントをリンク］をクリックします。
メモ：こちらで環境を選択できるのは、次の項目で［環境ごとに異なる認証を使用する］を選択した場合のみです。
-
ポップアップに認証情報を入力し、［認証］をクリックします。
または、対象の接続の接続の詳細ページで、［認証済みアカウント］の横にある［切り替え］をクリックして、接続を再認証することもできます。アカウント名を入力し、対象サービスの認証方式に応じて以降の手順を実行します。認証が完了すると、既存の認証は無効になり、新しい認証が有効になります。
1.4. 認証の取り消し
メモ：
- システム接続の認証を取り消せるのは、特権管理者、管理者、開発者のみです。開発者はマイクロサービスにアクセスできないため、アプリケーションの公開モードまたは編集モードからのみ接続を認証できます。
- 管理者接続の認証は、すべての管理者が取り消せます。
- 接続の認証を取り消しても、同じ認証を使用する他の接続には影響しません。
接続の認証を取り消すと、外部サービスへの権限とアクセス権が削除され、その接続の認証を使用するコンポーネントは意図したとおりに機能しなくなります。接続の認証を取り消すには、対象の接続の接続の詳細ページに移動し、以下に示す取り消しアイコン（
）をクリックします。
環境ごとに異なる認証を使用する接続の場合は、接続の詳細ページで、以下に示すように対象の環境の近くにある取り消しアイコン（）をクリックして、認証を取り消します。
1.5. 認証名の編集
表示されたポップアップに新しい認証名を入力し、［完了］をクリックします。
1.6. 接続の無効化
接続を無効にすると、その接続の機能が停止します。接続は非アクティブになり、どのアプリケーションでも使用できなくなります。アプリケーションで使用している接続を無効にすると、再度有効にするまで、その接続を使用する処理は実行されません。無効にするには。
- ［マイクロサービス］に移動します。アカウントで利用可能なすべての接続が、［接続］セクションに一覧表示されます。
- 無効にする接続カードにカーソルを合わせます。
- カードの右上にある横三点リーダー（3つの点）アイコンをクリックし、［無効にする］をクリックします。
メモ：
1.7. 接続の有効化
- ［マイクロサービス］に移動します。アカウントで利用可能なすべての接続が、［接続］セクションに一覧表示されます。
- 有効にするグレー表示された接続カードにカーソルを合わせます。
- カードの右上にある横三点リーダー（3つの点）アイコンをクリックし、［有効にする］をクリックします。
別の方法として、接続の詳細ページで、図のように横三点リーダーから［有効にする］をクリックして、接続を有効にすることもできます。
1.8. 接続の参照先の表示
参照先には、特定の接続が使用されているデータソースやアプリケーション内の場所がすべて一覧表示されます。参照先を表示するには、次の手順を実行します。
- ［マイクロサービス］に移動します。アカウントで利用可能なすべての接続が、［接続］セクションに一覧表示されます。
- 対象の接続カードにカーソルを合わせます。
- カードの右上にある横三点リーダー（3つの点）アイコンをクリックし、［参照先］をクリックします。
1.9. 接続の削除
削除すると、指定した接続がCreatorアカウントから完全に削除されます。
- ［マイクロサービス］に移動します。アカウントで利用可能なすべての接続が、［接続］セクションに一覧表示されます。
- 削除する接続カードにカーソルを合わせます。
- カードの右上にある横三点リーダー（3つの点）アイコンをクリックし、［削除］をクリックします。
- 接続がどのアプリケーションでも使用されていない場合、表示される確認用ポップアップで［削除］をクリックすると、すぐに削除されます。
- それ以外の場合は、接続が使用されているすべての場所の詳細がポップアップに表示されます。接続の［削除を続行する］には、表示された使用箇所をすべて削除する必要があります。
別の方法として、接続の詳細ページで、図のように横三点リーダーから［削除］をクリックして、接続を削除することもできます。
1.10. クライアント認証情報の更新
接続で使用されるOAuthクライアント認証情報は、接続の詳細 ページで変更できます。
クライアント認証情報を更新すると、接続を参照する既存の認証はすべて取り消されます。
- 認証情報が1件以上の接続から参照されている場合、それらの認証はすべて取り消されます。
- 再認証されるまで、アプリケーションの動作に一時的な影響が生じる場合があります。
- 接続に設定されている処理が、登録済みのOAuthアプリで定義されたスコープ内に含まれていることを確認してください。
クライアント認証情報を更新するには、次の手順を実行します。
-
［マイクロサービス］→［接続］ページに移動し、対象の接続を開きます。
-
接続の詳細ページの左側の欄にある［更新］ボタンを［クライアント認証情報］セクションの横でクリックします。
-
表示されたポップアップで、サードパーティーのOAuthアプリの新しい［クライアント認証情報名］と、更新後の新しい［クライアントシークレット］を指定します。新しい［クライアントID］と［クライアントシークレット］を追加することもできます。既存のクライアントシークレットは表示されず、再利用できません。
-
［更新して認証］をクリックして、接続の機能を復元します。
クライアント認証情報は、アプリケーションのライブモードから更新することもできます。
クライアント認証情報名を編集するには
カスタム認証情報を使用して接続を作成すると、クライアント認証情報名が自動生成されます。クライアント認証情報名を編集するには、対象の接続の接続の詳細ページに移動し、編集アイコンをクリックします。
メモ：
- 新しいクライアントIDを追加する場合は、そのIDに関連付けられた新しいクライアントシークレットも追加してください。
- 更新できるのは、認証情報の所有者（認証情報を追加したユーザー）のみです。その他の役割では、［更新］オプションが無効になり、カーソルを合わせるとツールチップが表示されます。
- 開発者が認証情報を再利用できるのは、関連付けられているアプリケーション内に限られます。
- 別のアプリケーションから参照されている接続は、ライブモードから更新できません。
- インポートしたアプリケーションにカスタムモードが設定された接続が含まれている場合、関連するクライアント認証情報は引き継がれません。接続の詳細ページで［設定］をクリックして接続を再設定し、認証してください。
- カスタムコネクターをインポートしても、認証情報は初期設定では追加されません。接続を機能させるには、［カスタム認証情報の設定］で認証情報を入力する必要があります。詳細はこちら
1.11. アプリケーションによる接続へのアクセスの有効化／無効化
接続の詳細ページの［接続へのアクセス］セクションでは、特定のアプリケーションによる接続へのアクセスを有効または無効にできます。これにより、アクセスが有効になっているアプリケーションでのみ接続を利用できます。
1.12. 環境ごとの認証
接続を作成すると、個別に設定しない限り、デフォルトでは開発、ステージング、本番の3つの環境すべてで同じ認証が使用されます。この設定は、すべての環境で同じ認証情報を使用する連携に適しています。後から異なる認証情報を使用する場合、Creatorでは環境別認証を有効にして、各環境に固有の認証を設定できます。異なる認証を使用すると、環境ごとの権限を維持しながら、各環境の要件に応じてアクセスと権限を調整できます。
ただし、本番環境に移行する前にステージング環境や開発環境で異なるAPIキーを使用してテストする場合など、個別の認証が必要になることがあります。
環境別認証の有効化
接続の作成時に環境別認証を有効にできます。作成時に有効にしなかった場合でも、次の方法で既存の接続に対して後から有効にできます。
- 接続一覧ページで、対象の接続の横にある三点リーダーメニューから［環境別認証を使用］を選択します。
- ［接続の詳細ページ］で、認証の横にある［環境別認証を使用］ボタンをクリックします。
その後、管理者には、いずれかの環境を選択して認証するよう求める画面が表示されます。
メモ：
- 同じ認証設定に本番環境の認証がすでに存在する場合、［すべての環境で同じ認証を使用］から［環境別認証］に切り替えても、その認証は保持されます。ただし、必要に応じて管理者が本番環境を再認証することもできます。
- 接続が1つ以上のデータソースに関連付けられている場合、環境別認証は有効にできません。
- 環境別認証を有効にすると、すべての環境で同じ認証を使用する設定には戻せません。ただし、すべての環境を選択して認証を完了することで、同じ結果を得られます。
目的の環境に対して接続を認証するには、次の手順に従います。
1.12.1 環境ごとの認証
環境別認証が有効になっていても認証がまだ完了していない場合は、次の手順で環境を認証します。
- 接続カードをクリックして接続の詳細ページ に移動し、［認証］をクリックします。
-
ドロップダウンから［認証済みアカウント］を選択し、環境を選択します。［再利用］をクリックします。
メモ：接続の作成時に、［環境ごとに異なる認証を使用］設定を有効にしてください。この設定を有効にした場合にのみ、こちらで環境を選択できます。 - 異なる認証情報で接続を認証するには、［新しいアカウントをリンク］をクリックします。認証が必要な環境を選択します。［認証］をクリックします。
1.13 ログインユーザー接続の認証管理
ログインユーザー接続を作成すると、そのアプリケーションにログインしているすべてのユーザーが、ライブモードまたは編集モードで接続を認証して利用できます。ただし、すべての認証の詳細を表示および管理できるのは管理者です。ログインユーザー接続では、次の操作を行えます。
- すべての認証の表示
- 認証の切り替え
- 認証の取り消し
- アカウントをメインに設定
すべての認証の表示
［すべての認証を表示］ページには、接続に関連付けられているすべての認証が一覧表示されます。すべての認証を表示するには、次の手順を実行します。
- 接続カードをクリックして接続の詳細ページ に移動し、［すべての認証を表示］をクリックします。
図のように、すべての認証について、ユーザー名、認証日、ユーザーのメール、ユーザーの種類などの詳細を確認できます。検索バーで特定のユーザーを検索したり、ユーザーの種類や環境に基づいてユーザー一覧を絞り込んだりできます。
認証の切り替え
メモ：管理者とスーパー管理者は、［すべての認証を表示］ページから、その接続に対する自分の認証のみを切り替えられます。
接続の認証の切り替えでは、接続に新しい認証を付与します。また、次のような場合にも必要です。
- 接続に関連付けられた認証情報の有効期限が切れた場合
- 外部サービスで認証トークンが無効化または削除された場合
メモ：接続の認証を切り替えると、その接続を使用するすべてのアプリケーションで、それ以降は新しい認証が使用されます。
認証を切り替えるには。
- ［すべての認証を表示］ページに移動し、自分の認証にカーソルを合わせます。
- 横向きの三点リーダーをクリックし、［切り替え］をクリックします。接続の認証を切り替えるよう求める画面が表示されます。
-
保存済みのアカウントを再利用するかどうかを、［認証済みアカウント］ドロップダウンから選択します。
メモ：［環境ごとに異なる認証を使用］を選択した場合にのみ、こちらで環境を選択できます。 - 別のアカウントの認証情報で接続を認証する場合は、［新しいアカウントをリンク］をクリックします。ポップアップで環境を選択し、［認証］をクリックします。
認証の取り消し
接続の認証を取り消すと、外部サービスへのアクセスと権限が削除され、その接続の認証を使用するコンポーネントは正常に機能しなくなります。
メモ：
- 管理者とスーパー管理者は、［すべての認証を表示］ページから、その接続に対する自分の認証のみを取り消せます。
- 接続の認証を取り消しても、同じ認証を使用している他の接続や環境には影響しません。
- メインアカウントの認証を取り消す前に、別のアカウントをメインに設定することをお勧めします。メインアカウントのリンクを解除すると、関連付けられたデータソースやスケジューラーが切断される可能性があるため、アプリケーションを中断なく機能させるには、この手順が重要です。
認証を取り消すには。
- ［すべての認証を表示］ページに移動し、自分の認証にカーソルを合わせます。
- 横向きの三点リーダーをクリックし、［取り消す］をクリックします。
メインとして設定
ログインユーザー接続を作成すると、最初にその接続を認証した管理者のアカウントがメインアカウントとして指定されます。ただし、メインアカウントは別の管理者のアカウントに変更できます。ログインユーザー接続では、統合サービスを1つのアカウント経由で利用するため、データソースやスケジュールの作成にメインアカウントが必要です。詳細はこちら
アカウントをメインとして設定するには、次の手順を実行します。
メモ：メインアカウントを別の管理者のアカウントに変更できるのは、管理者と特権管理者のみです。
アカウントをメインとして設定するには。
- ［すべての認証を表示］ページに移動し、メインとして設定する別の管理者の認証にカーソルを合わせます。
-
［横三点リーダー］をクリックし、［メインとして設定］をクリックします。
- 表示された確認ポップアップで、［続行］を選択します。
次のように、アカウントがメインとして設定されます。
1.14. インストール済みの接続の管理
インストール済みの接続は、マーケットプレイスからインストールされたアプリケーション、または非公開で共有されたアプリケーションに関連付けられています。これらの接続は、［接続］タブにインストール済みの接続として一覧表示されます。アプリケーションでシステム接続が使用され、同じサービスの接続がアカウントにすでに存在する場合、アプリケーションは既存の接続を参照します。これらの接続は認証または認証の取り消しが可能ですが、編集や削除はできません。
メモ：インストール済みの接続でも、環境ごとの認証を利用できます。
2. 注意事項
- 接続を作成できるのは、特権管理者、管理者、開発者のみです。
- システム接続を認証できるのは、特権管理者、管理者、開発者のみです。
- ログインユーザー接続は、C6でのみ作成できます。
- ログインユーザー接続を使用してデータソースやスケジュールを作成するには、統合サービスを1つのアカウント経由で利用するためのメインアカウントが必要です。
- すべての環境で同一の認証が設定されている接続のみ、データソースの作成に使用できます。