HTTPコネクターのベースURLを設定する
HTTPコネクションにベースURLを設定して、アウトバウンドリクエストを指定したURLに制限できます。 これにより、レシピでコネクションを使用するユーザーは、指定したサーバーまたはアプリケーションにのみ接続できます。
HTTPコネクターのセキュリティを確保する
データガバナンスにより、あるアプリから別のアプリへのデータフローを制御できます。 ベースURLを設定すると、機密データが特定のエンドポイント、ドメイン、またはホストのみを通過するようにできます。
正しいAPIバージョンを使用する
すべてのリクエストがターゲットアプリケーションの正しいAPIバージョンに対して行われるようにします。 ベースURLを設定すると、APIバージョンを含むすべてのリクエストが同じエンドポイントにルーティングされます。
ベースURLを設定すると、APIバージョンの変更時にレシピの更新が簡単になります。 ベースURLを設定すると、個別のアクションを手動で更新することなく、すべてのレシピのリクエストURLを更新できます。
たとえば、ベースURLをSalesforce REST APIの特定のバージョンに設定できます。 APIバージョンを更新する時期になったら、HTTPコネクションのベースURLを1回更新するだけで済みます:
https://instance.salesforce.com/services/data/v65.0仕組み
HTTPアクションが実行されるとき、ベースURLとアクションのリクエストURLを使用して最終リクエストURLが構築されます。 この概念は次のように簡略化できます: Base URL + Action Request URL = Final request URL。
例:
- ベースURL:
https://instance.salesforce.com - アクションリクエストURL:
/services/data - 最終リクエストURL:
https://instance.salesforce.com/services/data
Workatoは、すべての送信HTTPリクエストを、指定されたベースURLに制限します。 URL検証ルールは次のとおりです:
| HTTPリクエスト | 説明 |
|---|---|
| 絶対パス | ベースURL: https://instance.salesforce.comリクエストURL: https://instance.salesforce.com/services/data/Workatoは、指定されたエンドポイントのベースURLがコネクションのベースURLと一致することを検証します。 |
/プレフィックス付きの相対パス | ベースURL: https://instance.salesforce.com/servicesリクエストURL: /services/data/Workatoは、トップレベルドメイン（ .com）から始まるパスを検証します。 この例では、ベースURL内の/servicesがリクエストURL内の/servicesと一致します。注: 相対パスは、ベースURLが設定されている場合にのみ使用できます。 |
/プレフィックスなしの相対パス | ベースURL: https://instance.salesforce.com/servicesリクエストURL: data/Workatoは、リクエストURLをベースURLに追加します。 注: 相対パスは、ベースURLが設定されている場合にのみ使用できます。 |
ベースURLエラー
アクションリクエストURLが別のベースURLを使用しようとした場合、または計算された最終リクエストURLが無効な場合、WorkatoはHTTPアクションを阻止し、エラーでジョブを停止します。
HTTPベースURL検証でよく発生するエラーを以下に示します:
| エラーのタイプ | 例 |
|---|---|
| 別のベースURLの使用 | ベースURL: https://instance.salesforce.comリクエストURL: https://acme.com/users/ベースURLが一致しません。 エラーメッセージ: Attempted to send request to https://acme.com/users/ but only request with base URL https://instance.salesforce.com is allowed. |
| /プレフィックス付き相対パスの不一致 | ベースURL: https://instance.salesforce.com/servicesリクエストURL: /rest相対パスが、ベースURLで定義された /servicesと一致しません。エラーメッセージ: Attempted to send request to https://instance.salesforce.com/rest but only request with base URL https://instance.salesforce.com/services is allowed. |
ベースURLを定義する
HTTPコネクションを作成するときにベースURLフィールドを設定することで、ベースURLを定義できます。 ベースURLは通常、ターゲットAPIのドキュメントで提供されています。
たとえば、Salesforce REST APIのベースURLは次のとおりです:
https://instance.salesforce.com/これはクラウドベースのHTTPエンドポイントとオンプレミスのHTTPエンドポイントの両方に適用されます。
Last updated: