Zabbix Documentation 4.4

3.04.05.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.24.4Guidelines

User Tools

Site Tools


manual:config:items:itemtypes:http

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
manual:config:items:itemtypes:http [2019/06/13 06:00]
martins-v linking to Kerberos auth example
manual:config:items:itemtypes:http [2020/06/15 09:12] (current)
martins-v proxy string may be prefixed with its scheme (ZBXNEXT-5957)
Line 42: Line 42:
 |//Retrieve mode// ​ |Select the part of response that must be retrieved:​\\ **Body** - body only\\ **Headers** - headers only\\ **Body and headers** - body and headers ​ | |//Retrieve mode// ​ |Select the part of response that must be retrieved:​\\ **Body** - body only\\ **Headers** - headers only\\ **Body and headers** - body and headers ​ |
 |//Convert to JSON// ​ |Headers are saved as attribute and value pairs under the %%"​%%header%%"​%% key.\\ If '​Content-Type:​ application/​json'​ is encountered then body is saved as an object, otherwise it is stored as string, for example:\\ {{:​manual:​config:​items:​itemtypes:​http_conv_json.png|}} ​ | |//Convert to JSON// ​ |Headers are saved as attribute and value pairs under the %%"​%%header%%"​%% key.\\ If '​Content-Type:​ application/​json'​ is encountered then body is saved as an object, otherwise it is stored as string, for example:\\ {{:​manual:​config:​items:​itemtypes:​http_conv_json.png|}} ​ |
-|//HTTP proxy// ​ |You can specify an HTTP proxy to use, using the format ''​%%[protocol://​][username[:​password]@]proxy.mycompany.com[:​port]%%''​.\\ The optional ''​%%protocol://​%%''​ prefix may be used to specify alternative proxy protocols (the protocol prefix support was added in cURL 7.21.7). With no protocol specified, the proxy will be treated as an HTTP proxy.\\ By default, 1080 port will be used.\\ If specified, the proxy will overwrite proxy related environment variables like http_proxy, HTTPS_PROXY. If not specified, the proxy will not overwrite proxy-related environment variables. The entered value is passed on %%"​%%as is%%"​%%,​ no sanity checking takes place.\\ You may also enter a SOCKS proxy address. If you specify the wrong protocol, the connection will fail and the item will become unsupported.\\ //Note// that only simple authentication is supported with HTTP proxy.\\ Supported macros: {HOST.IP}, {HOST.CONN},​ {HOST.DNS}, {HOST.HOST},​ {HOST.NAME},​ {ITEM.ID}, {ITEM.KEY}, user macros, low-level discovery macros.\\ This sets the [[https://​curl.haxx.se/​libcurl/​c/​CURLOPT_PROXY.html|CURLOPT_PROXY]] cURL option. ​ |+|//HTTP proxy// ​ |You can specify an HTTP proxy to use, using the format ''​%%[protocol://​][username[:​password]@]proxy.mycompany.com[:​port]%%''​.\\ The optional ''​%%protocol://​%%''​ prefix may be used to specify alternative proxy protocols (e.g. https, socks4, socks5; see [[https://​curl.haxx.se/​libcurl/​c/​CURLOPT_PROXY.html|documentation]]; ​the protocol prefix support was added in cURL 7.21.7). With no protocol specified, the proxy will be treated as an HTTP proxy. If you specify the wrong protocol, the connection will fail and the item will become unsupported.\\ By default, 1080 port will be used.\\ If specified, the proxy will overwrite proxy related environment variables like http_proxy, HTTPS_PROXY. If not specified, the proxy will not overwrite proxy-related environment variables. The entered value is passed on %%"​%%as is%%"​%%,​ no sanity checking takes place.\\ //Note// that only simple authentication is supported with HTTP proxy.\\ Supported macros: {HOST.IP}, {HOST.CONN},​ {HOST.DNS}, {HOST.HOST},​ {HOST.NAME},​ {ITEM.ID}, {ITEM.KEY}, user macros, low-level discovery macros.\\ This sets the [[https://​curl.haxx.se/​libcurl/​c/​CURLOPT_PROXY.html|CURLOPT_PROXY]] cURL option. ​ |
 |//HTTP authentication// ​ |Authentication type:​\\ ​ **None** - no authentication used.\\ **Basic** - basic authentication is used.\\ **NTLM** - NTLM ([[http://​en.wikipedia.org/​wiki/​NTLM|Windows NT LAN Manager)]] authentication is used.\\ **Kerberos** - Kerberos authentication is used. See also: [[:​manual/​appendix/​items/​kerberos|Configuring Kerberos with Zabbix]].\\ Selecting an authentication method will provide two additional fields for entering a user name and password, where user macros and low-level discovery macros are supported.\\ This sets the [[https://​curl.haxx.se/​libcurl/​c/​CURLOPT_HTTPAUTH.html|CURLOPT_HTTPAUTH]] cURL option. ​ | |//HTTP authentication// ​ |Authentication type:​\\ ​ **None** - no authentication used.\\ **Basic** - basic authentication is used.\\ **NTLM** - NTLM ([[http://​en.wikipedia.org/​wiki/​NTLM|Windows NT LAN Manager)]] authentication is used.\\ **Kerberos** - Kerberos authentication is used. See also: [[:​manual/​appendix/​items/​kerberos|Configuring Kerberos with Zabbix]].\\ Selecting an authentication method will provide two additional fields for entering a user name and password, where user macros and low-level discovery macros are supported.\\ This sets the [[https://​curl.haxx.se/​libcurl/​c/​CURLOPT_HTTPAUTH.html|CURLOPT_HTTPAUTH]] cURL option. ​ |
 |//SSL verify peer// ​ |Mark the checkbox to verify the SSL certificate of the web server. The server certificate will be automatically taken from system-wide certificate authority (CA) location. You can override the location of CA files using Zabbix server or proxy configuration parameter SSLCALocation.\\ This sets the [[http://​curl.haxx.se/​libcurl/​c/​CURLOPT_SSL_VERIFYPEER.html|CURLOPT_SSL_VERIFYPEER]] cURL option. ​ | |//SSL verify peer// ​ |Mark the checkbox to verify the SSL certificate of the web server. The server certificate will be automatically taken from system-wide certificate authority (CA) location. You can override the location of CA files using Zabbix server or proxy configuration parameter SSLCALocation.\\ This sets the [[http://​curl.haxx.se/​libcurl/​c/​CURLOPT_SSL_VERIFYPEER.html|CURLOPT_SSL_VERIFYPEER]] cURL option. ​ |