HTTP Request コネクターを使用すると、コマンド をチェーンで使用して、指定された URL に対してハイパーテキスト転送プロトコル（HTTP）GET 、POST 、PUT 、DELETE リクエストを実行できます。たとえば、このコネクターをチェーンで使用して、それぞれのコネクターを介して他のソリューションを接続し、自動化することができます。
HTTP リクエストがどのように構造化されるかについては、HTTP コネクターのサンプルリストを参照してください。
メモ: HTTP Request とラベル付けされていますが、HTTPS (Secure HTTP) がサポートされています (および推奨)。
要件
- この接続には OData 固有の機能はありませんが、ヘッダー またはクエリ文字列 パラメータを使って、リクエストに必要なコンポーネントを追加することができます。
- 組織のチェーンでコネクターを使用できるようにするには、組織のセキュリティ管理者がまずコネクターを有効にする必要があります。
HTTPリクエスト・コネクターの設定
- チェーンビルダー から、接続 をクリックし、右上の作成 をクリックします。
-
コネクタ接続 で、HTTP リクエスト とデフォルト CloudRunner を選択します。
- 基本情報の下に、コマンドの識別をヘルプするユニークな名称と説明を入力します。
- 接続を使用する環境を選択して、保存をクリックします。
- 接続をテストするには、 コネクターのGETコマンドでチェーンを作成・実行し、有効な出力を返すことを確認します。
安全なHTTPリクエストのための認証情報の管理
コネクターのHTTPリクエストをセキュリティ設定するには、以下のコマンドを設定します：
- 基本的なユーザー名とパスワードによる認証
-
相互トランスポート・レイヤー・セキュリティ(mTLS)認証などのプライバシー強化メール(PEM)エンコード証明書。
メモ:Workiva は、HTTP リクエストの証明書を生成しません。PEMエンコード証明書を使用するには、リクエストとともに送信する公開キー／秘密キーのペアを提供し、オプションで作成者（CA）証明書を提供します。
認証情報を持つコマンドを設定するには：
- チェーンビルダーで、ワークスペース・リソースとして証明書をアップロードします。
- コネクターのコマンドを設定する際、プロパティとして証明書を選択します：
- 基本認証の場合、ユーザー名 およびパスワード に認証情報を入力または選択する。
- 公開鍵と秘密鍵のペアについては、証明書 および証明書秘密鍵 で、それぞれリソースを選択する。
- オプションの CA 証明書については、CA 証明書 でそのリソースを選択する。
トラブルシューティング
- エラーが返却された場合は、ソースURLとリクエストの構造をレビューしてください。HTTP コネクターの例 の記事では、必要な各コンポーネントの詳細を説明しています。
- クエリ文字列がエンコードされているか確認してください。