Differences

This shows you the differences between two versions of the page.

--- connectors:weblocation [2020/11/28 06:04] – dmitry
+++ connectors:weblocation [2023/03/09 15:54] (current) – upates for v5.4.1 craigt
@@ Line 1: / Line 1: @@
 ===== Web Location =====
-Specifies a web location which can later be used for sending web requests. The action supports 4 authentication modes:
+Specifies a web location that can later be used for sending web requests. The action supports 6 authentication modes:
   * No authentication
   * Basic HTTP authentication
+  * HTTP Digest authentication
   * Windows identity (a.k.a. Windows integrated)
   * OAuth2
+  * API key
 Note that implementation of OAuth2 by some web services may require frequent renewals of refresh tokens. Since EasyMorph connectors are immutable (mutable connectors are coming in 2021) a "Web location" connector is only valid until the 1st refresh token expires, and will require re-authentication after that.
@@ Line 22: / Line 24: @@
 | Token URL  | Defined by the web service you're connecting to. E.g. "https://oauth2.googleapis.com/token".  |
 | Redirect URI  | Redirect to a (local or not) URI after authorization is performed. If you're not sure what this is try localhost with a random port, e.g. "http://localhost:12456".  |
-| Client ID  | The ID of your OAuth client which configured in the target web service.  |
+| Client ID  | The ID of your OAuth client configured in the target web service.  |
 | Client secret  | Optional secret that could be configured in your OAuth client specified above.  |
 | Don't use PKCE  | [[https://oauth.net/2/pkce/|PKCE]] is a popular additional security measure frequently used by web services. May not be supported by the web service you are connecting to.  |
@@ Line 31: / Line 33: @@
 ^ Setting ^ Description ^
-| Request timeout  | Time in seconds after which web request will fail automatically if it's not completed by then. |
+| Request timeout  | Time in seconds after which a web request will fail automatically if it's not completed by then. |
-| Use throttling | Throttling settings that limit the number of requests sent to the target web service. Specified per connector, but used on per-project basis.  |
+| Use throttling | Throttling settings that limit the number of requests sent to the target web service. Specified per connector, but used on a per-project basis.  |
 | Handle HTTP 429 automatically  | If the target web service responds with [[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429|HTTP 429]] (too many requests) then EasyMorph can automatically retry sending web request after the delay specified in the server's response.  |
+| Don't send User-Agent automatically  |By default, EasyMorph sends the User-Agent HTTP header (e.g. "User-Agent: EasyMorph 5.4" - note that only the first two numbers of the current EasyMorph version are sent).  Checking this option prevents EasyMorph from including this header.|
 === Tab Proxy ===
@@ Line 47: / Line 50: @@
 If a "Web request" action also specifies the same header but with a different value, the actions setting will take precedence over the connector's setting.
+=== Cookie container ===
+When project execution starts the "Web location" connector creates a temporary cookie container that only exists during one project execution and is discarded when execution stops. The container automatically stores cookies set by HTTP responses and automatically appends them to outgoing web requests. During iterations or call, the cookie container is seamlessly passed to the called module/project thus enabling cookie-based session management.
 ** See also **