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

1. このページの内容

2. 利用条件

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

3. 外部連携の管理

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

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

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

      

1. 外部連携名：編集アイコンから変更できます。
2. リンク名：Deluge タスクやスクリプトで使用される、自動生成された名前です。
3. 権限：作成時に選択したスコープです。
4. 認可の詳細：同じ認可がすべての環境で使用されているか、環境ごとに別の認可があるかを示します。
5. 認証済みアカウント：接続済みアカウントの表示名で、編集可能です。

メモ:

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

1. サードパーティサービス側でアカウント名が提供されない場合、システムが<サービス名> アカウント <連番>（例：Twilio アカウント 2）の形式で自動生成します。
   

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

1. その他の詳細：作成者／作成日時、更新者／更新日時。
2. 外部連携のアクセス：アプリケーションからのアクセスを有効／無効にしたり、使用箇所を特定するための参照先を表示できます（外部連携がいずれのアプリでも使用中でない場合にのみ可能です）。
   
   

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

アイコン	種類
	管理者外部連携
	システム外部連携
	ユーザー外部連携

メモ: 以下で説明するすべての外部連携設定は、「外部連携の詳細」ページと実行環境の両方からアクセスできます。

3。1。3 編集画面からのアクセス

ワークフローからアクセスする場合：

画面右上の［外部連携］ボタンをクリックします。



Deluge エディターからアクセスする場合：

エディター上部ペインの［外部連携］ボタンをクリックします。

以下で説明する外部連携設定は、外部連携の詳細ページ、編集画面、および開発／ステージング環境の実行画面にある外部連携スライダーからアクセスできます。外部連携の編集と削除は、外部連携の詳細ページからのみ実行できます。

3。2. 外部連携の編集

1. Microservices > 外部連携の詳細ページで、対象の外部連携を選択します。
2. 省略記号（三点リーダー）をクリックし、外部連携を編集を選択します。
   
   
   
3. 外部連携名やスコープなどの詳細を変更し、更新をクリックします。
   
   
   

メモ: 外部連携のスコープを更新する場合は、外部連携を再認可する必要があります。

3。3. 認可の切り替え

メモ: 外部連携の認可の切り替えは、スーパー管理者または開発者が実行できます。切り替えは管理者外部連携とシステム外部連携に適用されます。ログインユーザー外部連携の認可は、その認可主体のみが切り替えることができます。外部連携の認可を切り替えると、その外部連携を利用するすべてのアプリケーションで以後新しい認可が使用されます。

1. カードにカーソルを合わせ、省略記号をクリックして、切り替えを選択します。

      

メモ: 環境ごとに異なる認可を使用している場合は、この操作の際に対象の環境を選択してください。

3。4. 認可の取り消し

メモ:

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

この接続を使用しているすべてのコンポーネントは動作しなくなります。

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

3。5. 認可名を編集する

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

3。6. 接続の参照を表示する

アプリケーション内でその接続が使用されているすべての場所が一覧表示されます。接続カード上の三点リーダーのメニューからアクセスできます。

3。7. 接続を削除する

1. カードにカーソルを合わせ、三点リーダーをクリックして、削除を選択します。

メモ:

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

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

3。8. 環境ごとの認可

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

たとえば、ステージングや開発環境で本番公開前に異なる API キーを使ってテストする場合など、環境ごとに別の認可が必要になるケースがあります。

環境ごとの認可を有効にする

環境ごとの認可は、接続の作成時に有効にできます。作成時にスキップした場合でも、既存の接続に対して次のいずれかの方法で後から有効にできます。

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

これ以降、いずれかの環境を選択すると、その環境用の認可が求められます。

メモ:

1. 開発者が設定した環境ごとの認可は、クライアントがインストールするアプリケーションには適用されません。インストールされた接続は、クライアント側で環境ごとの認可を有効にしない限り、初期設定の単一の認可を引き続き使用します。
2. 一度環境ごとの認可を有効にすると、すべての環境で同じ認可を使用する設定には戻せません。ただし、すべての環境を選択して同じ認可を完了することで、実質的に同じ状態にすることは可能です。

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

3。8。1. 各環境の認可を行う

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

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

      

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

3。9. ログインユーザー接続の認可を管理する

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

1. 接続カードをクリックして接続の詳細ページに移動し、すべての認可を表示をクリックします。
   
   
2. 一覧に表示されるすべての認可について、ユーザー名、認可日、ユーザーのメールアドレス、ユーザー種別などの詳細を確認できます。検索バーで特定のユーザーを検索したり、ユーザー種別や環境に基づいてユーザー一覧をフィルタリングすることもできます。
   
   

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

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

メモ: 各環境で異なる認可を使用する設定を選択している場合のみ、ここで環境を選択できます。

メモ:

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

認可を取り消すには、次の操作を行います。

1. [すべての認可] ページに移動し、対象の認可の上にマウスポインタを置きます。
   
2. 三点リーダーアイコンをクリックし、取り消す をクリックします。
   
   

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

1. [すべての認可] ページに移動し、プライマリとして設定したい別の認可の上にマウスポインタを置きます。
   
2. 三点リーダーアイコンをクリックし、プライマリとして設定 をクリックします。
   
3. 表示される確認ポップアップで 続ける を選択します。
   

4. 注意点

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

5. 関連トピック

1. 接続について
2. 接続の作成と認可
   
3. コネクタについて