Proxy Server Plugin
The purpose of this plugin is to enable a proxy mode on the embedded HTTP interface.
It can replace a proxy pass configuration on a http server or a complex proxy setup. It offers few other advantages and features that can be used in advanced setup.
By default, this plugin is disabled. The first step is to enable it creating a dedicated configuration:
Make a copy of this file in the same folder by just changing the file extension from
This way, the agent will start to accept inventory submission on its current port and on
/proxy/glpi as base url.
If a GLPI server is setup, any submitted inventory will be forwarded to that GLPI server.
You can also enable a secondary proxy by creating the
The purpose here is to enable another proxy configuration on the same agent, mostly in the case
you need it on a dedicated port with eventually SSL support plugin enabled.
The default configuration is self-explanatory:
# By default, a plugin is always disabled unless "disabled" is set to "no" or "0". # You can uncomment the following line or set it in included configuration file # at the end of this configuration #disabled = no # Set base url matching for API #url_path = /proxy # Note: the server URL to set on client would have to be http[s]://[host]:[port][url_path]/glpi # By default, this should be: http://[agent-ip-or-dns]:62354/proxy/glpi # Port on which to listen for inventory requests, default to legacy port #port = 62354 # The delay the proxy should return as contact timeout to agents (in hours) #prolog_freq = 24 # Option to handle proxy local storing. Set a folder full path as local_store to # also store received XML locally. Set only_local_store to not immediatly send # received XML to known server(s). #only_local_store = no #local_store = # To limit any abuse we expect a maximum of 30 requests by hour and by ip (3600 seconds) # You can adjust the rate limitation by updating the requests number limit # or the period on which apply the requests number limit #maxrate = 30 #maxrate_period = 3600 # The maximum number of forked handled request #max_proxy_threads = 10 # The maximum number of proxy a request can pass-through #max_pass_through = 5 # By default, if a GLPI server is set, we consider it supports GLPI protocol # otherwise this proxy should only support legacy XML based protocol #glpi_protocol = yes # no-category config returned to agent when using CONTACT protocol without GLPI server # or if only_local_store is set to yes # no_category = # Example: no_category = process,environment # You should create and define you specific parameter in the following # included configuration file to override any default. # For example just set "disabled = no" in it to enable the plugin include "proxy-server-plugin.local"
Can be set to "no" to enable the plugin. (By default: yes)
Can be set to a port on which the agent will listen too. (By default: 0, meaning use agent port)
You can dedicate a port for the proxy usage. You can even enable the SSL Server Plugin, and set the port in its
portslist to force using SSL with the proxy mode.
In the case the proxy agent is not in touch with a GLPI server, this is the delay time in hours an inventory should be sent by contacting agents. (By default: 24)
yesto only store locally submitted inventories. (By default: no)
This can be handy if the only purpose is to collect inventories and no GLPI server is reachable. Stored inventories could then be passed later to
This is a full path where to store submitted inventories. If set, the proxy agent will always stored submitted inventories. (By default: empty)
You must manage by yourself the stored inventories or you may face a storage outage after a while if many agents submits inventories. But as inventories are stored with the deviceid as file basename, new inventory for a known agent will just replace the existing one.
This storage may be used as an inventory backup solution but keep in mind this storage should be keep secured as it will contains a lot of sensible datas.
Limit requests for a given ip to maxrate other the maxrate_period time (in seconds). (By default: 30 requests by 3600 seconds for a single ip)
This 2 parameters could be used to limit abuse if the agent proxy if listening on a public network.
By default the average request for a given ip should be lower than 2. But this can be greater if the other ip is a chained proxy. In that last case, you may need to grow that values.
This set the maximum number of single requests the proxy agent can handle at the same time. (By default: 10)
This set the maximum number of proxy agents a single inventory submission can pass. (By default: 5)
Each time a inventory is submitted, a HTTP header value is set or increased. If that value reachs the
max_pass_throughof a proxy agent, the inventory won't be submitted to the next proxy agent.
Changing this parameter is only needed when you're using a chained proxy agents configuration and when you have at least 5 proxy agents in the chain. This parameter is a security to block loops in the case of chained proxy agents misconfiguration pointing to each others.
Set to "no" if you don't want to use new GLPI Agent Protocol needed for GLPI native inventory. (By default: yes)
When set to "no", the proxy agent will just act as a legacy GLPI server supporting XML inventory format only. Otherwise, it will tell remote agent to use new protocol which involves to send inventory in JSON format.
This is a comma separated list of category to not include in inventories. It has the same purpose than no-category configuration but set on server-side. This only works with new GLPI Agent Protocol and JSON format.
Private network inventory storage
In the case, you have a private network from where no device can access the GLPI server, you can:
First, store submitted inventory using a proxy agent with such
disabled = no only_local_store = yes local_store = /var/glpi-agent/proxy
Then, from GLPI server or a dedicated platform with GLPI server access possible, get a copy of stored inventories into a dedicated folder:
using a command like
using an USB key
Finally, inject inventories into GLPI with
glpi-injector -d /var/glpi-agent -r -R -u http://my-glpi-server/
Proxy with HTTP and HTTPS support
In the case you need to secure a private network with eventually old FusionInventory agent not supporting SSL, but you still need SSL for newer GLPI Agents, you can create a proxy agent listening on port 80 and port 443.
First, enable main proxy mode on port 443 with the following
disabled = no port = 443
Secondly, enable the secondary proxy mode on port 80 with the following
disabled = no port = 80
Also enable the SSL Server Plugin with the following
disabled = no ports = 443
Now, in agent configuration having access to the proxy agent, you can use any one of the 2 following URL as server configuration:
server = http://proxy-agent/proxy/glpi server = https://proxy-agent/proxy/glpi
Here you don't have to specify the port as standard http and https ports are used. The only requirement for the proxy agent is to run on a dedicated server with that ports not used by any other service.
Imagine you want to inventory the devices from one factory of your company in a given town having its dedicated and private network. This factory network is only visible via a vpn at the town level through a network being able to see other factories in the same town. Now your GLPI server is located in your head quarter in another town linked through a dedicated network link.
You can first create a proxy agent at the factory level just by enabling the proxy plugin on one computer, let'say the one with
You just need to enable the plugin with the following
disabled = no
Do the same on other agent where you need the plugin, the one at the town level, let's say it has the
And do also the same with the agent in the head quarter network with let's say the
On all other devices in the factory, setup agents with the following URL as server configuration:
server = http://10.77.200.55:62354/proxy/glpi
On the agent with the proxy plugin enabled, set the server URL to the proxy agent enabled at the town level:
server = http://10.77.0.2:62354/proxy/glpi
On the agent at the town level with the proxy plugin enabled, set the server URL to the proxy agent enabled at the head quarter level:
server = http://10.1.0.120:62354/proxy/glpi
On the agent at the head quarter level, just set the normal GLPI server URL as server configuration.
Then you just have to secure your network to permit each proxy agent to communicate on port 62354 with its chained one.
Remember only 5 proxy agents can be chained by default (see max_pass_through parameter). If you want to chain more proxy agents, set this parameter value to a higher value starting from the 6th proxy agent.
on windows the configuration is also a file under the
etcsub-folder of the GLPI Agent installation folder.