1. このページの内容

3. 外部連携へのナビゲーションガイド

4. 外部連携の管理

外部連携タブ（Microservices内）には、アカウント内で作成されたすべての外部連携が表示されます。各連携は、接続名、外部連携のリンク名、種類、ステータスが記載されたカードとして一覧表示されます。

ページ右側のフィルターオプションを利用して、外部連携の種類や関連付けられたアプリケーションでリストを絞り込むことができます。利用可能な接続タイプは次の通りです：

1. システム接続 - システムによって自動的に作成される接続
2. ユーザー接続 - ユーザーによって作成される接続
3. インストール済み接続 - マーケットプレイスからアプリケーションをインストールした際や、プライベートで共有された際に作成される接続

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

また、検索ボックスを使って特定の接続やアプリケーションをすばやく見つけることが可能です。たとえば、Zoho CRMの接続を検索し、その後フィルターを適用して、アプリケーションと関連付けられた外部連携のみを表示できます。

1. connection 詳細ページの表示
2. connection の編集
3. connection の認可の切り替え
   
4. 認可の取り消し
   
5. 認可名の編集
6. connection の無効化
7. connection の有効化
8. connection 参照の表示
9. connection の削除
10. アプリケーションへの connection アクセスの有効化または無効化
11. 環境ごとに異なる認可の使用
12. ログインユーザー外部連携の認可の表示と管理
    

4.1 Connection 詳細ページの表示

1. Microservicesに移動し、外部連携の下にある該当する connection カードをクリックします。
   

1. 接続の表示名は、自動作成またはユーザーによって設定されたものです。名前の横にある編集アイコンをクリックすることで編集できます。
2. リンク名前：接続ごとにバックエンドで作成される一意の名前です。Deluge統合タスクやinvoke URLスクリプトで認証を確立する際に使用されます。
3. 接続を利用しているアプリケーションの一覧です。
4. Permission：接続作成時にユーザーが選択したスコープです。
5. Authorization 担当者：接続の認証が管理者のみ行えるか（管理者接続）、または任意のユーザーが行えるか（ログインユーザー接続）を示します。
6. Authorization：同一の認証情報がすべての環境で使用されているか、各環境ごとに異なる認証情報が使用されているかを示します。
7. 認証済みアカウント：接続が認証済みの場合、その接続済みアカウントの表示名が表示されます。この自動作成された名前は、認証済みアカウント名の横にある編集アイコンをクリックすることで編集可能です。

メモ:
- 環境が有効なアプリケーションについては、3つの環境すべての認証済みアカウント名が一覧表示されます。接続がログインユーザー接続の場合、すべての認証情報を表示するためのリンクが利用可能です。
- サードパーティから認証アカウント名が提供されていない場合、自動作成された認証済みアカウント名は、<サービス-名前> アカウント という形式になります。例：Twilio アカウント 2。
サードパーティから認証アカウント名が提供されている場合は、その名前がアカウント名として表示されます。

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

4。2. 接続の編集

1. Microservicesに移動し、編集したい接続カードにカーソルを合わせます。
   
2. カード右上の三点リーダー（三つの点）アイコンをクリックし、接続の編集をクリックします。
   
   
3. 更新したい情報を入力し、更新するをクリックします。
    

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

また、 Connection 詳細ページの横三点リーダーから「編集」をクリックして接続を編集することもできます。

メモ:

1. 認証情報を除くすべての項目は編集可能です。
   
2. 接続名を編集するには、左上に表示される接続表示名の横にある名前を変更するアイコンをクリックしてください。

4.3. 接続のAuthorizationを切り替える

情報: 本セクションはadminおよびsystem外部連携にのみ適用されます。ログインユーザーの接続の切り替えについてはこちらを参照してください。

接続の切り替えとは、新たに認証を付与する手続きです。以下のような場合にも必要です。

1. 接続に紐付く認証情報の有効期限が切れた場合
   
2. 第三者サービスから認証トークンが無効化または削除された場合

メモ:

1. system 外部連携の認証切り替えは、スーパー管理者、管理者、開発者のみが実行できます。ただし、マイクロサービスは開発者がアクセスできないため、開発者はアプリケーションの有効または編集方法からのみ外部連携の認証が可能です。
2. Admin connectionの認証切り替えは、すべての管理者が可能です。
   
3. 認証が切り替えられると、その外部連携を利用しているすべてのアプリケーションは以降、新しい認証情報を使用します。

認証を切り替える手順:

1. Microservicesに移動します。アカウントで利用可能なすべての外部連携が外部連携セクションに表示されます。
   
2. 切り替えたい外部連携のカードにカーソルを合わせ、カード右上の三点リーダー（3つの点）アイコンをクリックし、切り替えるをクリックします。
   
3. 既に保存されているアカウントを再利用する場合は認証済みアカウントドロップダウンから選択し、別のアカウント資格情報で認証したい場合はリンク 新規アカウントをクリックしてください。
   

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

または、切り替えるをクリックし、希望する接続のConnection 詳細ページにある認証済みアカウント差出人の次に、アカウント名を入力し、以降の手順（希望するサービスの認証方式による）を実行して認証します。これにより、既存の認証は無効となり、新しい認証が有効になります。

4。4. 認証の取り消し

情報: このセクションはadminおよびsystem外部連携にのみ適用されます。ログインユーザー連携での認証取り消しについては、こちらを参照してください。

メモ:

1. system 外部連携の認証を取り消せるのは、スーパー管理者、管理者、開発者のみです。マイクロサービスは開発者がアクセスできないため、開発者はアプリケーションの有効または編集モードからのみ外部連携の認証が可能です。
2. Admin connectionの認証は、すべての管理者が取り消すことができます。
   
3. ある接続の認証を取り消しても、同じ認証を利用している他の外部連携には影響しません。

接続の認可を取り消すと、権限およびサードパーティサービスへのアクセスが削除され、その認可を利用しているコンポーネントは正常に動作しなくなります。接続の認可を取り消すには、対象の接続のConnection 詳細ページに移動し、取り消すアイコン（）をクリックします（下記参照）。

異なる環境ごとに異なる認可を使用する外部連携の場合、接続詳細ページで、対象環境の近くにある取り消すアイコン（）をクリックして取り消してください（下記参照）。

4.5 認可名の編集

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

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

4.6 接続の無効化

1. Microservicesに移動します。アカウントで利用可能な外部連携は、外部連携セクションに一覧表示されます。
   
2. 無効にしたい連携のカードにカーソルを合わせます。
   
3. カード右上の三点リーダー（…）アイコンをクリックし、無効にするをクリックします。
   

メモ:

1. 連携がいずれのアプリケーションでも使用中でない場合、無効にするをクリックするとすぐに無効になります。使用中の場合は、連携が利用されているすべての場所の詳細を表示するポップアップが無効にするの続行前に表示されます。
   
2. 複数のデータソースが連携に紐付いている場合、その連携を無効にする前に、関連付けられているすべてのデータソースを無効にする必要があります。

4。7. 連携を有効にする

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

4。8. Connection Referencesの表示

1. Microservicesに移動します。アカウントで利用可能なすべての外部連携は、外部連携セクションに一覧表示されます。
   
2. 目的の接続カードにカーソルを合わせます。
   
3. カード右上の三点リーダー（…）アイコンをクリックし、Referencesをクリックします。
   

4。9. Connectionの削除

1. Microservicesに移動します。アカウントで利用可能なすべての外部連携が外部連携セクションに表示されます。
   
2. 削除したい連携のカードにカーソルを合わせます。
   
3. カードの右上にある三点リーダー（…）アイコンをクリックし、削除をクリックします。
   
4. その連携がいずれのアプリケーションでも使用中でない場合は、確認のポップアップで削除をクリックすると、直ちに削除されます。
   
   
5. 使用中の場合は、その連携が利用されているすべての場所の詳細が表示されるポップアップが表示されます。削除を続行するには、表示された使用箇所をすべて削除する必要があります。
   
   

また、Connection 詳細ページの三点リーダーから削除をクリックして連携を削除することもできます。下図参照。

4.10. アプリケーションへのConnectionアクセスを有効化または無効化する

メモ: 本セクションはすべてのタイプの外部連携、すなわちsystem 外部連携、admin 外部連携、およびlogged-in ユーザー 外部連携に適用されます。

4.11. 環境ごとの認可

接続を作成する際、初期設定では同じ認可情報が開発、ステージング、本番の3つの環境すべてで使用されますが、個別に設定することも可能です。この設定は、各環境で同じ認証情報を利用する統合の場合に最適です。あとから異なる認証情報を利用したい場合は、CreatorでPer-Environment Authorization（環境ごとの認可）の有効化が可能です。これにより、各環境ごとに個別の認可を設定できます。異なる認可情報を使用することで、各環境に応じたアクセス権や権限を柔軟に調整しながら、環境ごとの特権も維持できます。

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

Per Environment Authorizationの有効化

接続の作成時にPer Environment Authorizationを有効にできます。作成時にスキップした場合でも、既存の接続に対して以下の方法で後から有効化できます。

1. 外部連携リストページから、接続の横にある省略記号メニューよりPer-Environment Authorizationを使用を選択します。
   
   
2. Connection詳細ページから、認可の横にあるPer Environmentを使用ボタンをクリックします。
   
   

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

メモ:

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

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

4。11。1. 各環境での認証

Per Environment Authorizationが有効だが認可がまだ完了していない場合は、下記の手順で環境の認証を行ってください。

1. connection 詳細ページ にアクセスするには、connectionカードをクリックし、認証をクリックします。
   
   
2. 認証済みアカウントをドロップダウンから選択し、環境を選択します。Reuseをクリックします。
   
   メモ: コネクション作成時に異なる環境ごとに異なる認証を使用プロパティを有効にしていることを確認してください。このプロパティを有効にしている場合のみ、ここで環境を選択できます。
3. 別の認証情報でコネクションを認証する場合は、新規アカウントをリンクをクリックします。認証を義務付ける環境を選択し、認証をクリックします。
   
   

4.12. ログインユーザー外部連携の認証管理

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

1. connection カードをクリックし、connection 詳細ページに移動し、すべての Authorizations を表示をクリックします。
   

ユーザー名、authorization 日付、ユーザー メール、ユーザー種類などの詳細とともに、一覧表示されているすべての authorizations を確認できます。特定のユーザーを検索バーで検索したり、ユーザー種類や環境を基準にユーザーリストをフィルタすることも可能です。

4.12.2. Authorization の切り替え

メモ:管理者およびスーパ管理者は、すべての Authorizations を表示ページから、自身の connection の authorizations のみ切り替えることができます。

connection を切り替えるとは、新しい authorization を付与する処理を指します。以下のような場合にも必要です：

1. connection に紐づく authorization 資格情報の有効期限が切れた場合
   
2. サードパーティサービスから認証トークンが無効化または削除された場合

メモ:connection の authorization を切り替えると、それを利用しているすべてのアプリケーションで以降は新しい authorization が使用されます。

Authorization を切り替えるには:

1. すべてのAuthorizationsページに移動し、ご自身の認証の上にマウスポインタを合わせます。
   
2. 横三点リーダーをクリックし、切り替えるをクリックします。接続の認証を切り替えるよう促されます。
   
3. 認証済みアカウントドロップダウンから、すでに保存済みのアカウントを再利用する場合は選択します。
   
   
   
   メモ: 環境ごとに異なる認証を使用するを選択した場合、ここで環境を選択できます。
4. または、新規アカウントをリンクをクリックし、別のアカウント認証情報で接続を認証します。ポップアップで環境を選択し、認証をクリックしてください。
   
   

4.12.3. 認証の取り消し

接続の認証を取り消すと、権限および第三者サービスへのアクセスが解除され、その認証を利用しているコンポーネントは正常に動作しなくなります。

メモ:

1. 管理者およびスーパ管理者は、すべてのAuthorizationsページから自分自身の認証のみ取り消すことができます。
   
2. 接続の認証を取り消しても、同じ認証を使用している他の外部連携や環境には影響しません。
   
3. 主要アカウントを取り消す前に、別のアカウントを主要アカウントとして指定することを推奨します。この手順は、主要アカウントの連携解除によりリンクされたデータソースやスケジューラの切断が発生する可能性があるため、アプリケーションの継続的な機能維持に不可欠です。

認証を取り消すには:

1. 表示する すべて Authorizationsページに移動し、該当する認可にカーソルを合わせます。
   
2. 横に並んだ三点リーダーをクリックし、取り消すをクリックします。
   

メモ: プライマリーアカウントのステータスを他の管理者アカウントに切り替えられるのは、管理者およびスーパ管理者のみです。

1. 表示する すべて Authorizationsページに移動し、プライマリーに設定したい他の管理者の認可にカーソルを合わせます。
2. 横に並んだ三点リーダーをクリックし、プライマリーとして設定をクリックします。
   
   
3. 確認のポップアップで続けるを選択します。
   

アカウントがプライマリーとしてマークされます（下図参照）。

4。13. インストール済み外部連携の管理

メモ: インストール済み外部連携でも環境ごとの認可が利用可能です。

5. メモしておきたいポイント

1. 外部連携の作成は、スーパー管理者、管理者、開発者のみが可能です。
2. System 外部連携の認証は、スーパー管理者、管理者、開発者のみが行えます。
3. Logged-in ユーザー 外部連携はC6でのみ作成できます。
4. データソースやスケジューラーをlogged-in ユーザー 外部連携で作成する場合、統合されたサービスを単一のアカウントで連携するため、主要なアカウントの入力が必須です。
5. すべての環境で同じ認可を持つ接続のみが、データソースの作成に使用できます。
   

6. 関連リンク

1. 外部連携の理解
2. 接続の作成と認証
3. 有効・編集モードでの接続