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

このヘルプページはCreator 6のユーザー向けです。以前のバージョン（Creator 5）を使用している場合は、こちらをクリックしてください。Creatorのバージョンを確認してください。

このページの概要

Zoho Creatorアプリケーションを他のZohoサービスまたは外部サービスと連携するために作成したコネクションの管理方法について説明します。

利用条件

コネクション。

1. Creatorの有料プランでのみ利用できます
2. 特権管理者、管理者、開発者のみ作成および管理できます。他のユーザーは認証してアクセスできます
3. すべてのデータセンターで利用できます

1. コネクションの管理

［マイクロサービス］の［コネクション］タブには、アカウントで作成されたすべてのコネクションが表示されます。各コネクションは、コネクション名、コネクションリンク名、コネクションの種類、ステータスを含むカードとして表示されます。

ページ右側の［フィルター］オプションを使用すると、種類や関連付けられているアプリケーションでコネクションの一覧を絞り込めます。利用可能なコネクションの種類は次のとおりです。

1. システムコネクション - システムによって自動的に作成されたコネクション
2. ユーザーコネクション - ユーザーによって作成されたコネクション
3. インストール済みコネクション - Marketplaceからアプリケーションをインストールした場合、または非公開で共有された場合に作成されるコネクション

フィルターは単一または複数の条件として適用でき、アプリケーションフィルターと組み合わせることで、さらに絞り込んだ結果を表示できます。選択したフィルターはタグとして表示され、個別に削除することも、まとめてクリアすることもできます。

検索ボックスを使用して、特定のコネクションやアプリケーションをすばやく見つけることもできます。たとえば、Zoho CRMコネクションを検索してからフィルターを適用し、アプリケーションに関連付けられているコネクションのみを表示できます。

メモ：プライベートホスト型コネクターを使用して作成されたコネクションは、設定済みのデータブリッジに依存します。これらのコネクションを使用または管理するには、Qntrlがシステム連携で設定され、有効なデータブリッジに関連付けられていることを確認してください。データブリッジが利用できない、または停止している場合、プライベートホスト型コネクターを使用するコネクションは機能しません。

コネクションの管理では、次の操作を実行できます。

1. コネクション詳細ページの表示
2. コネクションの編集
3. コネクションの認証の切り替え
   
4. 認証の取り消し
   
5. 認証名の編集
6. コネクションの無効化
7. コネクションの有効化
8. コネクションの参照先の表示
9. コネクションの削除
   
10. クライアント認証情報の更新
11. アプリケーションへのコネクションアクセスの有効化または無効化
12. 環境ごとに異なる認証を使用
13. ログインユーザーコネクションの認証の表示と管理
    

1.1. コネクション詳細ページの表示

このページでは、必要なコネクションの基本情報を確認できるほか、編集、削除、有効化／無効化、認証の取り消しなどの管理操作を実行できます。コネクション詳細ページを表示するには、次の手順を実行します。

1. ［マイクロサービス］に移動し、以下のように、［コネクション］で目的のコネクションカードをクリックします。
   

次の詳細が表示されます。

1. コネクションに対して自動生成された、またはユーザーが指定した表示名です。この名前の横にある編集アイコンをクリックして編集できます。
2. ［リンク名］：バックエンドでコネクション用に生成される一意の名前です。Delugeの連携タスクやURL呼び出しスクリプトで、認証の確立に使用できます。
3. コネクションを使用するアプリケーションの一覧です。
4. ［権限］：コネクションの作成時にユーザーが選択したスコープです。
   
5. ［クライアント認証情報］：対象となるクライアント認証情報に対して生成された一意の名前です。この自動生成された名前は、横にある［編集］アイコンをクリックして編集できます。ユーザーアイコンにカーソルを合わせると、設定したユーザーの名前と設定日が表示されます。
6. ［認証の所有者］：コネクションを管理者のみが認証できるか（管理者コネクション）、任意のユーザーが認証できるか（ログインユーザーコネクション）を示します
7. ［認証］：3つの環境すべてで同じ認証を使用するか、環境ごとに異なる認証を使用するかを示します。
8. ［認証済みアカウント］：コネクションが認証されている場合の、接続済みアカウントの表示名です。この自動生成された名前は、認証済みアカウント名の横にある［編集］アイコンをクリックして編集できます。
   

メモ：
- 環境を有効にしているアプリケーションでは、3つの環境すべての認証済みアカウント名が一覧表示されます。コネクションがログインユーザーコネクションの場合、コネクションに対するすべての認証を表示するためのリンクが利用できます。
- サードパーティから認証アカウント名が提供されていない場合、自動生成される認証済みアカウント名は次の形式になります。<service-name> Account <sequence>。たとえば、Twilio Account 2です。
サードパーティから認証アカウント名が提供される場合は、その名前がアカウント名として表示されます。

1. ［コネクションアクセス］：特定のアプリケーションへのコネクションのアクセスを有効または無効にしたり、［参照先］を表示して、アプリケーション内でコネクションが使用されている正確な場所を確認したりできます。
2. ［その他］：作成者、作成日時、最終更新者、最終更新日時などの情報です。

1.2. コネクションの編集

コネクションの編集では、コネクション名、コネクションリンク名、スコープ設定を変更します。編集するには、次の手順を実行します。

1. ［マイクロサービス］に移動し、編集するコネクションカードにカーソルを合わせます。
   
2. カードの右上にある横三点（3点）アイコンをクリックし、［コネクションを編集］をクリックします。
   
   
3. 更新する情報を入力し、［更新］をクリックします。
    

メモ：接続の編集中に権限を変更した場合、既存の認証が無効になるため、接続の認証を求められます。

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

メモ：

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

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

情報：このセクションは、管理者接続とシステム接続にのみ適用されます。ログイン中のユーザー接続の切り替えについては、こちらをクリックしてください。

接続の切り替えとは、その接続に新しい認証を付与することです。次のような場合にも必要です。

1. 接続に関連付けられた認証情報の有効期限切れ
   
2. サードパーティーサービスでの認証トークンの無効化または削除

メモ：

1. システム接続の認証の切り替えは、スーパー管理者、管理者、開発者のみが実行できます。開発者はマイクロサービスにアクセスできないため、アプリケーションの公開モードまたは編集モードからのみ接続を認証できます。
2. 管理者接続の認証は、すべての管理者が切り替えできます。
   
3. 接続の認証を切り替えると、それを利用しているすべてのアプリケーションで、以降は新しい認証が使用されます。

認証を切り替えるには、次の手順を実行します。

1. ［マイクロサービス］に移動します。アカウントで利用可能なすべての接続が、接続セクションに一覧表示されます。
   
2. 切り替える接続カードにカーソルを合わせ、カード右上の横三点リーダー（三点）アイコンをクリックし、［切り替え］をクリックします。
   
3. 既に保存済みのアカウントを再利用する場合は、［認証済みアカウント］ドロップダウンから選択します。別のアカウント情報で接続を認証する場合は、［新しいアカウントを連携］をクリックします。
   

   メモ：［環境ごとに異なる認証を使用］を選択した場合のみ、こちらで環境を選択できます。
   
   
4. ポップアップに認証情報を入力し、［認証］をクリックします。
   
   

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

1.4. 認証の取り消し

情報：このセクションは、管理者接続とシステム接続にのみ適用されます。ログイン中のユーザー接続での認証の取り消しについては、こちらをクリックしてください。

メモ：

1. システム接続の認証の取り消しは、スーパー管理者、管理者、開発者のみが実行できます。開発者はマイクロサービスにアクセスできないため、アプリケーションの公開モードまたは編集モードからのみ接続を認証できます。
2. 管理者接続の認証は、すべての管理者が取り消しできます。
   
3. 接続の認証を取り消しても、同じ認証を使用している他の接続には影響しません。

接続の認証を取り消すと、サードパーティーサービスへの権限とアクセスが削除され、その接続の認証を使用しているコンポーネントは想定どおりに機能しなくなります。接続の認証を取り消すには、目的の接続の接続の詳細ページに移動し、以下のように取り消しアイコン（）をクリックします。

環境ごとに異なる認証を使用している接続では、以下のように接続の詳細ページで、対象の環境の近くにある取り消しアイコン（）をクリックして取り消します。

1.5. 認証名の編集

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

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

1.6. 接続の無効化

1. Microservicesに移動します。アカウントで利用可能なすべての接続が、接続セクションに一覧表示されます。
   
2. 無効にする接続カードにカーソルを合わせます。
   
3. カードの右上にある横三点リーダー（3点）アイコンをクリックし、［無効にする］をクリックします。
   

メモ：

1. 接続がどのアプリケーションでも使用されていない場合、［無効にする］をクリックするとすぐに無効になります。それ以外の場合、接続の無効化に進む前に、その接続を使用しているすべての場所の詳細を示すポップアップが表示されます。
   
2. 複数のデータソースが接続にリンクされている場合、その接続を無効にする前に、関連付けられているすべてのデータソースを無効にする必要があります。

1.7. 接続の有効化

1. Microservicesに移動します。アカウントで利用可能なすべての接続が、接続セクションに一覧表示されます。
   
2. 有効にするグレー表示の接続カードにカーソルを合わせます。
   
3. カードの右上にある横三点リーダー（3点）アイコンをクリックし、［有効にする］をクリックします。
   

1.8. 接続の参照先の表示

1. Microservicesに移動します。アカウントで利用可能なすべての接続が、接続セクションに一覧表示されます。
   
2. 目的の接続カードにカーソルを合わせます。
   
3. カードの右上にある横三点リーダー（3点）アイコンをクリックし、［参照先］をクリックします。
   

1.9. 接続の削除

1. Microservicesに移動します。アカウントで利用可能なすべての接続が、接続セクションに一覧表示されます。
   
2. 削除する接続カードにカーソルを合わせます。
   
3. カードの右上にある横三点リーダー（3点）アイコンをクリックし、［削除］をクリックします。
   
4. 接続がどのアプリケーションでも使用されていない場合、表示される確認ポップアップで［削除］をクリックするとすぐに削除されます。
   
   
5. それ以外の場合、その接続を使用しているすべての場所の詳細を示すポップアップが表示されます。接続の削除に進むには、記載されている使用箇所をすべて削除する必要があります。
   
   

また、接続の詳細ページから、横三点リーダーの［削除］をクリックして接続を削除することもできます。以下のように表示されます。

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

クライアント認証情報を更新すると、その接続を参照している既存の認可はすべて取り消されます。

1. 認証情報が1件以上の接続で参照されている場合、それらはすべて取り消されます。
   
2. 再認可されるまで、アプリケーションの動作に一時的な影響が生じる場合があります。
   
3. 接続に設定されているアクションが、登録済みOAuthアプリで定義したスコープ内に含まれていることを確認してください。
   

クライアント認証情報を更新する手順は次のとおりです。

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

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

クライアント認証情報名の編集。

カスタム認証情報を使用して接続を作成すると、クライアント認証情報名が自動生成されます。クライアント認証情報名を編集するには、対象の接続の接続の詳細ページに移動し、編集アイコンをクリックします。

メモ：

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

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

メモ：このセクションは、システム接続、管理者接続、ログインユーザー接続のすべての種類の接続に適用されます。

1.12. 環境別認証

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

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

環境別認証の有効化

環境別認証は、接続の作成時に有効にできます。作成時に有効にしなかった場合でも、後から既存の接続に対して次の方法で有効にできます。

1. 接続の一覧ページで、接続の横にある三点リーダーメニューから［環境別認証を使用］を選択します。
   
   
2. 接続の詳細ページで、認証の横にある［環境別に使用］ボタンをクリックします。
   
   

その後、管理者は任意の環境を選択して認証するよう求められます。

メモ：

1. 同じ認証プロパティの一部として本番環境の認証がすでに存在する場合、「すべての環境で同じ認証」から「環境別認証」に切り替えても保持されます。ただし、必要に応じて管理者は本番環境を再認証できます。
2. 接続が1つ以上のデータソースにリンクされている場合、環境別認証は有効にできません。
3. 環境別認証を有効にすると、すべての環境で同じ認証に戻すことはできません。ただし、すべての環境を選択して認証を完了することで、同じ状態にできます。
   

対象の環境で接続を認証するには、以下の手順に従ってください。

1.12.1 環境ごとの認証

環境別認証が有効になっているものの、認証がまだ完了していない場合は、以下の手順で環境を認証します。

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

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

1. すべての認証の表示
2. 認証の切り替え
   
3. 認証の取り消し
4. アカウントをプライマリとして設定
   

1. 接続カードをクリックして接続の詳細ページに移動し、［すべての認証を表示］をクリックします。
   

表示されているように、すべての認証を、ユーザー名、認証日、ユーザーのメール、ユーザーの種類の詳細とともに一覧で確認できます。検索バーを使用して特定のユーザーを検索したり、ユーザーの種類や環境に基づいてユーザー一覧を絞り込んだりできます。

認証の切り替え

メモ：管理者と特権管理者は、すべての認証を表示ページから、自分自身のコネクション認証のみを切り替えられます。

コネクションの切り替えとは、コネクションに新しい認証を付与する処理です。次のような場合にも必要です。

1. コネクションに関連付けられている認証情報の有効期限が切れた場合
   
2. 外部サービスで認証トークンが無効化または削除された場合

メモ：コネクション認証を切り替えると、その認証を使用しているすべてのアプリケーションで、以後は新しい認証が使用されます。

認証を切り替えるには：

1. すべての認証を表示ページに移動し、自分の認証にカーソルを合わせます。
   
2. 横三点リーダーをクリックし、［切り替え］をクリックします。コネクションの認証を切り替えるよう求められます。
   
3. ［認証済みアカウント］ドロップダウンから、保存済みのアカウントを再利用するかどうかを選択します。
   
   
   
   メモ：［環境ごとに異なる認証を使用］を選択した場合のみ、こちらで環境を選択できます。
4. または、［新しいアカウントをリンク］をクリックして、別のアカウントの認証情報でコネクションを認証します。ポップアップで環境を選択し、［認証］をクリックします。
   
   

認証の取り消し

コネクション認証を取り消すと、外部サービスへの権限とアクセスが削除され、そのコネクション認証を使用しているコンポーネントは意図したとおりに機能しなくなります。

メモ：

1. 管理者と特権管理者は、すべての認証を表示ページから、自分自身のコネクション認証のみを取り消せます。
   
2. コネクションの認証を取り消しても、同じ認証を使用している他のコネクションや環境には影響しません。
   
3. プライマリーアカウントを取り消す前に、別のアカウントをプライマリーとして指定することをおすすめします。プライマリーアカウントのリンクを解除すると、関連付けられているデータソースやスケジューラーが切断される可能性があるため、アプリケーションの機能を継続して利用するにはこの手順が重要です。

認証を取り消すには：

1. すべての認証を表示ページに移動し、自分の認証にカーソルを合わせます。
   
2. 横三点リーダーをクリックし、［取り消し］をクリックします。
   

メモ：管理者と特権管理者のみが、プライマリーアカウントのステータスを別の管理者のアカウントに切り替えられます。

1. すべての認証を表示ページに移動し、プライマリーとして設定する別の管理者の認証にカーソルを合わせます。
2. 横三点リーダーをクリックし、［プライマリーとして設定］をクリックします。
   
   
3. 表示される確認ポップアップで、［続行］を選択します。
   

表示されているように、アカウントがプライマリーとして設定されます。

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

メモ：インストール済みコネクションでも、環境別認証を利用できます。

2. 注意点

1. コネクションを作成できるのは、特権管理者、管理者、開発者のみです。
2. システムコネクションを認証できるのは、特権管理者、管理者、開発者のみです。
3. ログインユーザーコネクションはC6でのみ作成できます。
4. データソースやスケジューラーをログインユーザーコネクションで作成する場合、連携サービスを単一のアカウント経由で利用するには、プライマリーアカウントが必須です。
5. すべての環境で同じ認証を使用するコネクションのみ、データソースの作成に使用できます。
   

3. 関連トピック

1. コネクションの概要
2. コネクションの作成と認証
3. 公開モードと編集モードでのコネクション