======WEB LOCATION CONNECTOR======
\\
=====Description=====
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.
\\

**Name:**  Provide a name for the connector.\\
**Note:** Provide any notes regarding the connector (optional).\\
**Documentation…** Will allow you to enter a URL and Label for connector information. (optional)\\

\\ 
=====Connector settings=====

==== Connection settings =====
^ Setting ^ Description ^
| Base URL  | A URL that must include protocol schema (e.g. %%"https://"%%) and host (e.g. "www.googleapis.com"). May optionally include port and URL path.  |
| Authentication  | One of the authentication modes described above. |
\\
**OAuth2 settings:**
^ Setting ^ Description ^
| Authorization URL  | Defined by the web service you're connecting to. E.g. "https://accounts.google.com/o/oauth2/v2/auth".  |
| 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 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.  |
| Permission scopes | A list of permission scopes as they are defined by the target web service. See the web-service documentation on how the scopes are identified. Can be something like "https://www.googleapis.com/auth/analytics.readonly" or "Dataset.ReadWrite.All"  |
| Parameters  | Optional additional connection parameters specified as key-value pairs as specified by the target web service.  |

\\
====Options settings====
^ Setting ^ Description ^
| 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 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.|
| Don't send the header "Expect:100-continue"  |By default, EasyMorph sends the header [[https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Expect|"Expect:100-continue"]] automatically when sending a request with a body (e.g., a POST request). The header requires the remote web server to reply with [[https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/100|HTTP 100]] (Continue) before receiving the (potentially large) request body. Checking this option prevents EasyMorph from including this header.|  

\\
====Proxy settings====
Configure proxy settings, if required. Consult your network administrator for proxy settings, if necessary.

\\
====URL Parameters settings====
The URL parameters specified in this tab will be automatically appended to all web requests sent using the connector. This setting is most commonly used to specify API keys that must be included as URL parameters.

If a "Web request" action also specifies the same URL parameter name but with a different value, the action's setting will take precedence over the connector's setting.

\\
====Headers settings===
The request headers specified in this tab will be automatically appended to all web requests sent using the connector. This setting is most commonly used to specify API keys that must be included as request headers.

If a "Web request" action also specifies the same header but with a different value, the action's setting will take precedence over the connector's setting.

\\ 
=====Remarks=====
====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=====
  * [[transformations:webrequest|Action "Web Request"]]
  * [[transformations:iteratewebrequest|Action "Iterate Web Request"]]