翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# サードパーティーのサービスに接続する
<a name="add-connector-third-party"></a>

**Topics**
+ [OpenAPI Connector と API Connector](#add-connector-third-party-openapi-vs-api)
+ [サードパーティーAPIs に接続する (汎用)](connectors-api.md)
+ [OpenAPI を使用して サービスに接続する](connectors-openapi.md)
+ [Salesforce に接続する](connectors-salesforce.md)

## OpenAPI Connector と API Connector
<a name="add-connector-third-party-openapi-vs-api"></a>

App Studio アプリケーションからサードパーティーのサービスに API リクエストを送信するには、アプリケーションでサービスでの認証と API コールの設定に使用するコネクタを作成して設定する必要があります。App Studio には、これを実現するために `API Connector`と `OpenAPI Connector` コネクタタイプの両方が用意されています。以下に説明します。
+ **API Connector: **任意のタイプの REST API の認証とリクエスト情報を設定するために使用されます。
+ **OpenAPI Connector: **OpenAPI 仕様 (OAS) OpenAPI を採用している APIs の認証とリクエスト情報を設定するために使用されます。OAS に準拠する APIs には、標準化、セキュリティ、ガバナンス、ドキュメントなど、いくつかの利点があります。

App Studio では、OAS に準拠する APIs `OpenAPI Connector`に を使用し、OpenAPI 仕様ファイルを提供することをお勧めします。OpenAPI の詳細については、[OpenAPI とは」を参照してください。](https://swagger.io/docs/specification/v3_0/about/) Swagger ドキュメントの 。

# サードパーティーAPIs に接続する (汎用)
<a name="connectors-api"></a>

App Studio で汎用 **API Connector** を作成するには、次の手順に従います。**API Connector** は、App Studio アプリにサードパーティーのサービス、リソース、またはオペレーションへのアクセスを提供するために使用されます。

****API Connector** を使用してサードパーティーのサービスに接続するには**

1. 左側のナビゲーションペインで、**管理**セクションで**コネクタ**を選択します。既存のコネクタのリストとそれぞれの詳細を示すページが表示されます。

1. **\$1 コネクタの作成**を選択します。

1. **API Connector** を選択します。次に、次のフィールドに入力してコネクタを設定します。

1. **コネクタ名: **コネクタの名前を指定します。

1. **コネクタの説明: **コネクタの説明を入力します。

1. **ベース URL: ** サードパーティー接続のウェブサイトまたはホスト。例えば、`www.slack.com`。

1. **認証方法:** ターゲットサービスで認証する方法を選択します。
   + **なし:** 認証なしでターゲットサービスにアクセスします。
   + **基本:** 接続先のサービスから****取得した**ユーザー名とパスワード**を使用して、ターゲットサービスにアクセスします。
   + **ベアラートークン:** サービスのユーザーアカウントまたは API 設定から取得した認証トークンの**トークン値**を使用して、ターゲットサービスにアクセスします。
   + **OAuth 2.0:** OAuth 2.0 プロトコルを使用してターゲットサービスにアクセスします。これにより、App Studio は認証情報や ID を共有せずにサービスとリソースにアクセスできるようになります。OAuth 2.0 認証方法を使用するには、まず App Studio を表す接続先のサービスからアプリケーションを作成して、必要な情報を取得する必要があります。この情報を使用して、次のフィールドに入力します。

     1. **クライアント認証情報フロー:** アプリケーションがユーザーとやり取りすることなく独自に動作するsystem-to-systemやり取りに最適です。たとえば、ユーザーが追加した新しいレコードに基づいて Salesforce レコードを自動的に更新する CRM アプリや、トランザクションデータを取得してレポートに表示するアプリなどです。

        1. **クライアント ID** に、ターゲットサービスで作成された OAuth アプリから取得した ID を入力します。

        1. **クライアントシーク**レットで、ターゲットサービスで作成された OAuth アプリから取得したシークレットを入力します。

        1. **アクセストークン URL** で、ターゲットサービスで作成された OAuth アプリから取得したトークン URL を入力します。

        1. 必要に応じて、**スコープ**にアプリケーションのスコープを入力します。スコープは、アプリケーションに必要なアクセス許可またはアクセスレベルです。ターゲットサービスの API ドキュメントを参照してスコープを理解し、App Studio アプリに必要なスコープのみを設定します。

        **接続の検証**を選択して、認証と接続をテストします。

     1. **認可コードフロー:** ユーザーに代わって動作する必要があるアプリケーションに最適です。たとえば、ユーザーがログインしてサポートチケットを表示および更新するカスタマーサポートアプリや、各チームメンバーがログインして販売データを表示および管理するセールスアプリなどです。

        1. **クライアント ID** に、ターゲットサービスで作成された OAuth アプリから取得した ID を入力します。

        1. **クライアントシーク**レットで、ターゲットサービスで作成された OAuth アプリから取得したシークレットを入力します。

        1. **認可 URL** に、ターゲットサービスの認可 URL を入力します。

        1. **アクセストークン URL** で、ターゲットサービスで作成された OAuth アプリから取得したトークン URL を入力します。

        1. 必要に応じて、**スコープ**にアプリケーションのスコープを入力します。スコープは、アプリケーションに必要なアクセス許可またはアクセスレベルです。ターゲットサービスの API ドキュメントを参照してスコープを理解し、App Studio アプリに必要なスコープのみを設定します。

1. **ヘッダー:** リクエストまたはレスポンスに関するメタデータを提供するために使用される HTTP ヘッダーを追加します。キーと値の両方を追加することも、ビルダーがアプリケーションで値を提供できるキーのみを指定することもできます。

1. **クエリパラメータ:** リクエスト URL の一部としてオプション、フィルター、またはデータを渡すために使用されるクエリパラメータを追加します。ヘッダーと同様に、キーと値の両方を指定することも、ビルダーがアプリケーションで値を提供できるキーのみを指定することもできます。

1. **[作成]** を選択します。新しく作成されたコネクタが**コネクタ**リストに表示されます。

コネクタが作成されると、ビルダーはそれをアプリケーションで使用できます。

# OpenAPI を使用して サービスに接続する
<a name="connectors-openapi"></a>

OpenAPI を使用して App Studio をサービスに接続し、ビルダーがリクエストを送信してサービスからレスポンスを受信するアプリケーションを構築できるようにするには、次の手順を実行します。

1. [OpenAPI 仕様ファイルを取得し、サービス情報を収集する](#connectors-openapi-create-resources)

1. [OpenAPI コネクタを作成する](#connectors-openapi-create-connector)

## OpenAPI 仕様ファイルを取得し、サービス情報を収集する
<a name="connectors-openapi-create-resources"></a>

OpenAPI を使用してサービスを App Studio に接続するには、次の手順を実行します。

1. App Studio に接続するサービスに移動し、OpenAPI 仕様 JSON ファイルを見つけます。
**注記**  
App Studio は、バージョン OpenAPI 仕様バージョン 3.0.0 以降に準拠した OpenAPI 仕様ファイルをサポートしています。

1. 以下を含む OpenAPI コネクタの設定に必要なデータを収集します。
   + サービスに接続するためのベース URL。
   + トークンやユーザー名/パスワードなどの認証認証情報。
   + 該当する場合は、任意のヘッダー。
   + 該当する場合は、任意のクエリパラメータ。

## OpenAPI コネクタを作成する
<a name="connectors-openapi-create-connector"></a>

**OpenAPI 用のコネクタを作成するには**

1. App Studio に移動します。

1. 左側のナビゲーションペインで、**「管理****」セクションの「コネクタ**」を選択します。既存のコネクタのリストとそれぞれの詳細を示すページが表示されます。

1. **\$1 コネクタの作成**を選択します。

1. コネクタタイプのリストから **OpenAPI Connector** を選択します。次に、次のフィールドに入力してコネクタを設定します。

1. **名前:** OpenAPI コネクタの名前を入力します。

1. **説明:** OpenAPI コネクタの説明を入力します。

1. **ベース URL:** サービスに接続するためのベース URL を入力します。

1. **認証方法:** ターゲットサービスで認証する方法を選択します。
   + **なし:** 認証なしでターゲットサービスにアクセスします。
   + **基本:** 接続先のサービスから****取得した**ユーザー名とパスワード**を使用して、ターゲットサービスにアクセスします。
   + **ベアラートークン:** サービスのユーザーアカウントまたは API 設定から取得した認証トークンの**トークン値**を使用して、ターゲットサービスにアクセスします。
   + **OAuth 2.0:** OAuth 2.0 プロトコルを使用してターゲットサービスにアクセスします。これにより、App Studio は認証情報や ID を共有せずにサービスやリソースにアクセスできるようになります。OAuth 2.0 認証方法を使用するには、まず App Studio を表す接続先のサービスからアプリケーションを作成して、必要な情報を取得する必要があります。この情報を使用して、次のフィールドに入力します。

     1. **クライアント認証情報フロー:**

        1. **クライアント ID** で、ターゲットサービスの ID を入力します。

        1. **クライアントシーク**レットで、ターゲットサービスのシークレットを入力します。

        1. **アクセストークン URL** で、ターゲットサービスのトークン URL を入力します。

        1. 必要に応じて、**スコープ**にアプリケーションのスコープを入力します。スコープは、アプリケーションに必要なアクセス許可またはアクセスレベルです。ターゲットサービスの API ドキュメントを参照してスコープを理解し、App Studio アプリに必要なスコープのみを設定します。

        呼び出しごとにサービスで送信される**変数**を追加し、**接続の検証**を選択して認証と接続をテストします。

     1. **認可コードフロー:**

        1. **クライアント ID** で、ターゲットサービスの ID を入力します。

        1. **クライアントシーク**レットで、ターゲットサービスのシークレットを入力します。

        1. **認可 URL** に、ターゲットサービスの認可 URL を入力します。

        1. **アクセストークン URL** で、ターゲットサービスのトークン URL を入力します。

        1. 必要に応じて、**スコープ**にアプリケーションのスコープを入力します。スコープは、アプリケーションに必要なアクセス許可またはアクセスレベルです。ターゲットサービスの API ドキュメントを参照してスコープを理解し、App Studio アプリに必要なスコープのみを設定します。

1. **変数:** 呼び出しごとにサービスに送信する変数を追加します。設定中に追加された変数は安全に保存され、接続を使用するアプリケーションのランタイム中にのみアクセスされます。

1. **ヘッダー:** リクエストまたはレスポンスに関するメタデータを提供するために使用される HTTP ヘッダーを追加します。キーと値の両方を追加することも、ビルダーがアプリケーションで値を提供できるキーのみを指定することもできます。

1. **クエリパラメータ:** リクエスト URL の一部としてオプション、フィルター、またはデータを渡すために使用されるクエリパラメータを追加します。ヘッダーと同様に、キーと値の両方を指定することも、ビルダーがアプリケーションで値を提供できるキーのみを指定することもできます。

1. **OpenAPI 仕様ファイル:** OpenAPI 仕様 JSON ファイルをドラッグアンドドロップするか、**ファイルを選択して**ローカルファイルシステムを移動し、アップロードするファイルを選択します。

   追加すると、ファイルが処理され、使用可能なオプションのリストが表示されます。コネクタに必要なオペレーションを選択します。

1. **[作成]** を選択します。新しく作成されたコネクタが**コネクタ**リストに表示されます。

コネクタが作成されると、ビルダーはそれをアプリケーションで使用できます。

# Salesforce に接続する
<a name="connectors-salesforce"></a>

App Studio を Salesforce に接続して、ビルダーがアプリケーションで Salesforce リソースにアクセスして使用できるようにするには、Salesforce で接続されたアプリケーションを作成および設定し、App Studio で Salesforce コネクタを作成する必要があります。

**Salesforce を App Studio に接続するには**

1. App Studio のナビゲーションペインで、**「管理**」セクションの**「コネクタ**」を選択します。既存のコネクタのリストとそれぞれの詳細を示すページが表示されます。

1. **\$1 コネクタの作成**を選択します。

1. コネクタタイプのリストから **Salesforce** を選択して、コネクタ作成ページを開きます。

1. リダイレクト **URL** を書き留めておきます。この URL を使用して、次の手順で Salesforce を設定します。

1. 次のステップでは、Salesforce で接続されたアプリケーションを作成します。別のタブまたはウィンドウで、Salesforce インスタンスに移動します。

1. クイック検索ボックスで、**App Manager** を検索**App Manager**して選択します。

1. **新しい接続されたアプリ**を選択します。

1. **接続されたアプリケーション名**と **API **名に、アプリケーションの名前を入力します。App Studio アプリ名と一致する必要はありません。

1. 必要に応じて連絡先情報を入力します。

1. **API (OAuth 設定の有効化)** セクションで、**OAuth 設定の有効化を有効にします**。

1. **コールバック URL** に、先ほど App Studio から書き留めた**リダイレクト URL** を入力します。

1. **選択した OAuth スコープ**で、リストから必要なアクセス許可スコープを追加します。App Studio は Salesforce REST APIs とやり取りして、アカウント、ケース、連絡先、リード、オポチュニティの 5 つのオブジェクトに対して CRUD オペレーションを実行できます。**フルアクセス (フルアクセス)** を追加して、App Studio アプリに関連するすべてのアクセス許可またはスコープがあることを確認することをお勧めします。

1. **サポートされる認可フローのコード交換 (PKCE) 拡張に必要な証明キーを無効にします**。PKCE は App Studio ではサポートされていません。

1. **ウェブサーバーフローのシークレットを要求**し、**更新トークンフローのシークレットを有効に**して、 のベストプラクティスに従います。

1. App Studio は、次の認証フローの両方をサポートしています。
   + **クライアント認証情報フロー**: アプリケーションがユーザーとのやり取りなしで独自に動作するserver-to-serverやり取りに最適です。たとえば、Salesforce アクセスを持たない臨時従業員のチームのすべてのリード情報を一覧表示します。
   + **認可コードフロー**: 個人データへのアクセスやアクションなど、ユーザーに代わって動作するアプリケーションに適しています。例えば、このアプリを通じて他のタスクを実行するために、販売マネージャーが調達または所有する各セールスマネージャーのリードを一覧表示します。
   + クライアント認証情報フローの場合:

     1. **クライアント認証情報フローの有効化**を有効にします。メッセージを確認して確認します。

     1. アプリを保存します。

     1. フローにはユーザー操作はありませんが、実行ユーザーを選択する必要があります。実行ユーザーを選択すると、Salesforce はユーザーに代わってアクセストークンを返します。

        1. **App Manager** で、アプリのリストから App Studio アプリの矢印を選択し、**管理**を選択します。

        1. **ポリシーの編集**を選択する

        1. **クライアント認証情報フロー**で、適切なユーザーを追加します。
   + 認可コードフローで、**認可コードと認証情報フローを有効にする**

1. Salesforce はクライアント ID とクライアントシークレットを提供します。これは、次の手順で App Studio でコネクタを設定するために使用する必要があります。

   1. **App Manager** で、App Studio アプリの矢印を選択し、**表示**を選択します。

   1. **API (OAuth 設定の有効化)** セクションで、**コンシューマーの詳細の管理** を選択します。これにより、確認キーの E メールが送信される場合があり、確認のために入力する必要があります。

   1. **コンシューマーキー** (クライアント ID) と**コンシューマーシー**クレット (クライアントシークレット) を書き留めます。

1. App Studio に戻り、次のフィールドに入力してコネクタを設定および作成します。

1. **Name** に、Salesforce コネクタの名前を入力します。

1. **説明** に、Salesforce コネクタの説明を入力します。

1. **ベース URL** に、Salesforce インスタンスのベース URL を入力します。ホスト名を ** Salesforce インスタンス名に置き換えると`https://hostname.salesforce.com/services/data/v60.0`、 のようになります。

1. **認証方法で**、**OAuth 2.0 **が選択されていることを確認します。

1. **OAuth 2.0 フロー**で、OAuth 認証方法を選択し、関連フィールドに入力します。
   + system-to-system統合のために、独自に動作するアプリケーションで使用するために、**クライアント認証情報フロー**を選択します。

     1. **クライアント ID** に、Salesforce から以前に取得した**コンシューマーキー**を入力します。

     1. **クライアントシー**クレットに、Salesforce から以前に取得した**コンシューマーシークレット**を入力します。

     1. **アクセストークン URL** に、OAuth 2.0 トークンエンドポイントを入力します。ホスト名を ** Salesforce インスタンス名に置き換えると`https://hostname/services/oauth2/token`、 のようになります。詳細については、[Salesforce OAuth Endpoints ](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5)ドキュメントを参照してください。

     1. **接続の検証**を選択して、認証と接続をテストします。
   + ユーザーに代わって動作するアプリケーションで使用するために**認可コードフロー**を選択します。

     1. **クライアント ID** に、Salesforce から以前に取得した**コンシューマーキー**を入力します。

     1. **クライアントシー**クレットに、Salesforce から以前に取得した**コンシューマーシークレット**を入力します。

     1. **認可 URL** に認可エンドポイントを入力します。ホスト名を ** Salesforce インスタンス名に置き換えると`https://hostname/services/oauth2/authorize`、 のようになります。詳細については、[Salesforce OAuth Endpoints ](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5)ドキュメントを参照してください。

     1. **アクセストークン URL** に、OAuth 2.0 トークンエンドポイントを入力します。ホスト名を ** Salesforce インスタンス名に置き換えると`https://hostname/services/oauth2/token`、 のようになります。詳細については、[Salesforce OAuth Endpoints ](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5)ドキュメントを参照してください。

1. **オペレーション**で、コネクタがサポートする Salesforce オペレーションを選択します。このリストのオペレーションは事前定義されており、共通オブジェクトからのレコードの作成、取得、更新、削除など、Salesforce 内の一般的なタスクを表します。

1. **[作成]** を選択します。新しく作成されたコネクタが**コネクタ**リストに表示されます。