1. Babelway
  2. Babelway User Guide
  3. Chapter 4. Manage & Build

4.2.4.16. Http Client Gateway In (Deprecated)

 

The Http Client allows to periodically retrieve the content of the Http response to a specific URL

 Authentication method 

 You can select from Basic, NTLM or OAuth 2.0 with Credentials depend on the server response. 

 Login url 

 If authentication method is FORM. 

 Url 

 Url to call to create message. 

 Support HTTP and HTTPS protocols. 

 Username 

 Username used for BASIC/NTLM/DIGEST authentication. 

 For NTLM authentication, the username can be prepended by the domain (domain/username). 

 Password 

 Password used for BASIC/NTLM authentication. 

 Valid HTTP return code 

 Comma separated list of expected return Http code. If the return code is not in the list, the polling generates an alert. The default is '200,201,202,204,205'. 

 Timeout 

 Timeout for connection in milliseconds. Must be between 10000 and 240000. 

 Http Method 

 You can specify the http method to call. The default is GET. 

 TLS version  

 You can specify the version of the TLS protocol. TLS is the replacement of SSL. The default is TLSv1.2. 

 Http headers 

 You can add specific http header. 

 Trust level 

 The trust level defines the level of security used in the SSL handshake. Relax = No certificate verification, Standard = trusting certificates in environment certificates as well as known CA's, Paranoiac = only trusts certificates defined in the environmnent certificates. The default is Standard 

 Login url 

 If authentication method is FORM. 

 Authentication form fields 

 When using FORM authentication, you can add specific authentication form fields to the authentication call. This accepts metadata. 

 Metadata from response 

 You can use data receive by the login request as metadata, which can be used in the data sending after login. 

 Cron expression 

 Cron expression. Allows to define complex time expression like every weekday night at 23:00 (0 0 23 ? * MON-FRI *) and the time zone for the polling. If left empty, the system will check at least once every 15 minutes. For easy creation of your cron expression, you can use the online cron maker tool available at http://www.cronmaker.com/. 

 

When using the Authentication method of type OAuth 2.0 with Credentials we will do two calls, The first call will be through the URL provided in the "Login url" field then when we receive the response we can use regex to extract the data received in the response body and save them in a user defined metadata in the "Metadata from response" section then this created user defined metadata can be used in the second call in the "HTTP headers" section, as shown below.

mceclip1.png

Note:

  • The Gateway In of type "HTTP Client (Deprecated)" only supports the BASIC authentication mode.

  • In the "General" page for this Gateway In you can see the "Poll now" button. When clicking on this button this will poll all of the messages immediately (and will not wait for the next defined moment).

  • If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
  • You can check bunch of info like last success date, last message date …etc. by pressing on Run Info button.

mceclip4.png

  • The maximum file size accepted by this gateway is 100 MB.