接続

前へ次へ

REST V3接続のプロパティ

REST V3接続をセットアップする際には、接続プロパティを設定する必要があります。

接続を作成する際に、次の認証方法を指定できます。

なし。RESTエンドポイントに接続するための認証方法は必要ありません。

基本。RESTエンドポイントに接続するには、ユーザーIDとパスワードが必要です。

OAuth 2.0認証コード。RESTエンドポイントに接続するには認証サーバーが必要です。認証コードを使用すると、資格情報を共有または保存せずにエンドポイントへの承認済みアクセスが可能になります。

OAuth 2.0クライアント資格情報。RESTエンドポイントに接続するには、クライアントIDとクライアントシークレットが必要です。

次の表に、認証タイプが基本の接続におけるREST V3接続のプロパティを示します。

接続プロパティ	説明
ランタイム環境	タスクを実行するランタイム環境の名前。 Secure Agentまたはサーバーレスランタイム環境を指定します。
認証タイプ	コネクタがRESTエンドポイントに接続するために使用する必要のある認証方法。［基本］を選択します。デフォルトは［なし］です。
認証ユーザーID	［基本］認証タイプを選択したときにWebサービスアプリケーションにログインするためのユーザー名。
認証パスワード	［基本］認証タイプを選択した場合の、ユーザー名に関連付けられたパスワード。
トラストストアファイルパス	REST APIとの一方向または双方向の安全な接続を確立するためのTLS証明書を含むトラストストアファイルの絶対パス。トラストストアファイルが.jks形式であることを確認してください。各Secure Agentマシンのランタイム環境で使用可能なディレクトリパスを指定します。
トラストストアのパスワード	SSL証明書を含むトラストストアファイルのパスワード。
キーストアファイルパス	REST APIとの双方向の安全な接続を確立するために必要なキーと証明書を含むキーストアファイルの絶対パス。キーストアファイルが.jks形式であることを確認してください。各Secure Agentマシンのランタイム環境で使用可能なディレクトリパスを指定します。
キーストアのパスワード	通信を安全に行うために必要なキーストアファイルのパスワード。
プロキシタイプ	プロキシのタイプ。以下のいずれかのオプションを選択することができます。なし。エージェントレベルまたは接続レベルで設定されたプロキシサーバーをバイパスします。カスタム。接続レベルで設定されたプロキシが考慮されます。プラットフォーム。エージェントレベルで設定されたプロキシが考慮されます。サーバーレスランタイム環境を使用する場合、プロキシは適用されません。
プロキシホスト	プロキシサーバーのIPアドレスまたはホスト名。［カスタム］プロキシタイプにのみ必要です。
プロキシポート	プロキシサーバーのポート番号。［カスタム］プロキシタイプにのみ必要です。
プロキシユーザー	プロキシサーバーのユーザー名。［カスタム］プロキシタイプにのみ必要です。
プロキシパスワード	プロキシサーバーのパスワード。［カスタム］プロキシタイプにのみ必要です。
接続タイムアウト	RESTエンドポイントからの応答を取得するための待機時間（秒単位）。接続タイムアウトを過ぎると、接続は終了します。デフォルトは60秒です。 REST V3接続タイムアウトとエンドポイントAPIタイムアウトの両方が定義されている場合、接続は定義されている最短のタイムアウトで終了します。
再試行回数	応答で、100、300、400、および500シリーズのエラーコードが返された場合に接続を試行する回数。デフォルトは0です。再試行を無効にするには0を指定します。 408のエラーコードの場合、サイレントでの再試行が実行されます。したがって、再試行の回数は、指定した値より多くなる可能性があります。
再試行の遅延	再試行が行われるまでの待機時間（秒）。デフォルトは0です。
HTTPバージョン	RESTエンドポイントに接続するためのHTTPバージョン。以下のいずれかのオプションを選択することができます。 HTTP 2 HTTP 1.1 デフォルトはHTTP 2です。