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

1. このページの内容

2. 利用可能範囲

外部連携の作成および管理は、Developer Console内のスーパー管理者および開発者のみが実行できます。クライアントは、アプリケーションをインストール後に認証およびアクセスが可能です。

3. 外部連携の管理

1. 外部連携の詳細ページへのアクセス
   
2. 連携内容の編集
   
3. 認証の切り替え
   
4. 認証の取り消し
   
5. 認証名の編集
6. 外部連携参照の表示
   
7. 外部連携の削除
8. 環境ごとに異なる認証の利用
   
9. ログイン中ユーザーの外部連携認証の表示と管理

3。1. 外部連携ページへのアクセス

1. Microservicesに移動し、外部連携の下に表示されている該当する連携カードをクリックします。

      

1. Connection 名前: 編集アイコンで編集可能。
2. リンク 名前: Delugeタスクやスクリプト用に自動作成され、使用されています。
3. 権限: 作成時に選択したスコープ。
4. Authorization 詳細: 同じ認証情報がすべての環境で使用されているか、環境ごとに異なるかを指定します。
5. 認証済みアカウント: 接続済み取引先の編集可能な名前が表示されます。

メモ:

1. 環境が有効なアプリケーションの場合、認証済みアカウントの名前は環境ごとに一覧表示されます。
   

1. サードパーティサービスがアカウント名を提供しない場合、システムが「<サービス-名前> アカウント 」という形式で自動生成します（例：Twilio アカウント 2）。
   

1. 既にサードパーティアカウント名が存在する場合は、その名前が表示されます。

1. その他の詳細: 作成者/作成日、最終更新者/更新日。
2. Connection Access: アプリケーションへのアクセスを有効化または無効化し、利用状況を確認するための参照情報を表示します。（この操作は、接続がいずれのアプリでも使用中でない場合のみ可能です）
   
   

1. サービス名: 接続が作成されたサービスの名前。
2. リンク名: バックエンドで接続用に作成された一意の名前。Deluge連携タスクや認証確立のためのURLスクリプトで利用できます。
3. 権限: 接続作成時にユーザーが選択したスコープ。
4. Authorization 担当者: 管理者のみ（管理者接続）か、任意のユーザー（ログインユーザー接続）が認証できるかを示します。
5. 認証情報: すべての環境で同じ認証情報を使用するか、各環境ごとに異なる認証情報を使用するかを指定します。
6. 認証済みアカウント: 接続が認証済みの場合、接続済みアカウントの表示名。自動生成されたこの名前は、認証済みアカウント名の横にある編集アイコンから変更できます。
7. Connection Access: 特定アプリケーションへの接続アクセスを有効化・無効化したり、参照を表示してアプリケーション内での利用箇所を特定できます。
8. その他: 作成者、作成日、最終更新者、最終更新日などの情報。
9. Connection種類: 種類ごとに異なるアイコンで表示されます（下表参照）。

アイコン	種別
	管理者 connection
	システム connection
	ユーザー connection

メモ: 以下に記載されているすべてのconnection設定は、「外部連携詳細」ページおよび有効方法からアクセスできます。

3.1.3 差出人編集方法へのアクセス

ワークフローから差出人へアクセスする場合 -

ページ右上の「外部連携」ボタンをクリックします。



Delugeエディタから差出人へアクセスする場合 -

エディタ上部の「外部連携」ボタンをクリックします。

以下のconnection設定は、外部連携詳細ページ、編集方法、さらに有効方法の外部連携スライダーから、開発またはステージ環境でアクセスできます。なお、編集や削除は外部連携詳細ページからのみ可能です。

3.2. Connectionの編集

1. Microservices > Connection詳細ページで、該当するconnectionを選択します。
2. 三点リーダー（…）をクリックし、編集Connectionを選択します。
   
   
   
3. connection名やスコープなどの詳細を修正し、更新するをクリックします。
   
   
   

メモ: connectionのスコープを更新する場合は、再認証が必要です。

3.3. 認証の切り替え

メモ: 接続の認可の切り替えは、スーパー管理者または開発者によって完了できます。切り替えは管理者およびシステム外部連携に適用されます。ログイン中のユーザー接続認可は、認可担当者のみが切り替え可能です。接続認可が切り替えられると、それを利用するすべてのアプリケーションは今後新しい認可を使用します。

1. カードにカーソルを合わせ、三点リーダーをクリックし、切り替えるを選択します。

      

メモ: 環境ごとの認可の場合、このプロセス中に必須の環境を選択してください。

3。4. 認可の取り消し

メモ:

認可を取り消しても、同じ認証情報を使用している他の外部連携には影響しません。

この接続を利用しているすべてのコンポーネントの動作が停止します。

1. 接続の詳細ページに移動し、目的の接続を選択します。
   
   
2. 取り消しアイコンをクリックし、確定します。
   
   
   

3。5. 認可名の編集

1. 接続の詳細ページにアクセスし、接続を選択します。
   
2. 認可名の横にある編集アイコンをクリックし、新しい名前を入力して保存します。
   
   

3。6. 接続参照の表示

アプリケーション内で接続が使用されているすべての領域を一覧表示します。接続カードの省略記号メニューからアクセスできます。

3.7. 接続の削除

1. カードにカーソルを合わせ、省略記号をクリックし、削除を選択します。

メモ:

1. 接続が未使用の場合、削除はすぐに実行されます。
2. 接続がアプリケーションのいずれかで使用されている場合、すべての参照が削除されるまで削除できません。
   

また、Connection 詳細ページから接続を削除することも可能です。

3.8. 環境ごとの認可

接続を作成する際、初期設定では開発やステージングなどの環境に同じ認可が使用されますが、個別に設定することも可能です。この設定は統一した認証情報を複数の環境で利用する場合に最適です。後から異なる認証情報を使用したい場合、Creatorでは「環境ごとの認可」を有効にすることで、各環境に固有の認可を設定できます。環境ごとに異なる認可を使うことで、それぞれの環境の要件に合わせてアクセスや権限を調整しつつ、環境固有の権限管理を維持できます。

ただし、ステージングや開発で異なるAPIキーを使ってテストし、その後クライアントへの公開前に分けて認可が必要となる場合もあります。

環境ごとの認可の有効化

接続を作成する際に、「環境ごとの認可」を有効にできます。作成時にスキップした場合でも、以下の方法で既存の接続に対して後から有効化できます。

1. 外部連携一覧ページから、接続の横にある省略記号メニューより環境ごとの認可を使用を選択します。
   
   
2. 接続詳細ページで、認可の横にある環境ごとに使用ボタンをクリックします。
   
   

この操作後、環境を選択する際に認可の入力が求められます。

メモ:

1. 開発者によって設定された環境ごとの認可は、クライアントがインストールしたアプリケーションには適用されません。インストールされた外部連携は、クライアントが環境ごとの認可を有効にしない限り、初期設定の認可が引き続き利用されます。
2. 一度環境ごとの認可を有効化すると、すべての環境で単一の認可へ戻すことはできません。ただし、すべての環境を選択して認可を完了することで同様の動作を実現できます。

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

3.8.1. 環境ごとの認証

環境ごとの認可が有効で、まだ認可が完了していない場合は、以下の手順で環境を認証してください。

2. 認証済みアカウント差出人のドロップダウンを選択し、環境を選択します。再利用をクリックします。

      

メモ: 接続を作成する際は、異なる環境ごとに異なる認可を使用するプロパティを有効にしてください。このプロパティを有効にしている場合のみ、ここで環境を選択できます。

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

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

1. 接続カードをクリックして接続詳細ページへ移動し、すべての認可を表示をクリックします。
   
   
2. ユーザー名、認可日、ユーザーメール、ユーザー種別など、一覧表示された認可の詳細を確認できます。検索バーで特定のユーザーを検索したり、ユーザー種別や環境でユーザーリストを絞り込むことも可能です。
   
   

メモ: スーパー管理者は、自身の接続認証のみ表示する すべて Authorizationsページから切り替えることができます。

1. 表示する すべて Authorizationsページに移動し、ご自身の認証にカーソルを合わせます。
   
2. 横三点リーダーをクリックし、切り替えるをクリックします。接続の認証を切り替えるよう求められます。
   
   
   
   
3. 認証済み アカウントドロップダウンから、既に保存されているアカウントを再利用する場合は差出人を選択します。
   
   

メモ「各環境ごとに異なる認証を使用する」を選択している場合のみ、ここで環境を選択できます。

メモ:

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

認証を取り消すには:

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

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

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

4. 注意点

1. 外部連携の作成および管理は、スーパー管理者と開発者のみが可能です。
   
2. 外部連携は、スーパー管理者と開発者がテスト目的で認証できます。

5. 関連トピック

1. 外部連携の理解
2. 接続の作成および認証
   
3. コネクタの理解