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

# 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. **[作成]** を選択します。新しく作成されたコネクタが**コネクタ**リストに表示されます。

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