Configuration¶
PHP Agent¶
Configuration options for PHP Agent. They are modifiable using Hdiv Toolbar configuration page or more generally using environment variables.
The following configurations go in the file [AGENT_PATH]/settings/core-settings.ini
| Property | Type | Description |
|---|---|---|
| php.run.dir | string | Set this to any existing directory that can be read, written and traversed (g+rwX). It will be used by the agent and core to store runtime files. |
| hdiv.config.dir | string | Same as above. It will be used by the core. It can be the same as php.run.dir. |
| hdiv.mandatory.app.name | string | The name of your app. |
| hdiv.mandatory.app.version | string | The current version of your app. |
| php.core.[platform].bin | string | On the key, change [platform] to the one the architecture chosen at installation. It can be: java, linux, macos, windows (e.g: php.core.linux.bin). The value must be the full path of the core, including the file name. |
| hdiv.console.level | Custom | Define the logging level the following options are available |
| hdiv.file.level | Custom | Define the logging level the following options are available |
| hdiv.log.append | Boolean | Define whether agent traces should be appended during startup or not, by default false |
| hdiv.async.taint.tracking | Boolean | A flag to that vulnerabilities should be tracked in asynchronous threads, it could be enabled at a cost in performance, by default false |
| hdiv.toolbar.enabled | Boolean | Whether Hdiv toolbar should be shown or not, when the agent is not configured to communicate with a Web Console it will be always displayed, otherwise by default is false |
| hdiv.console.url | String | Defines de URL of the Web Console, by default http://localhost:8089/hdiv-console-services |
| hdiv.console.token | String | Authentication token for the environment in the Web Console |
| hdiv.server.name | String | The name that will identify this server in the Web Console |
Extension¶
The following configuration go into the file [PHP Additional .ini parsed]/hdiv.ini
| Property | Type | Description |
|---|---|---|
| hdiv.prehook_opcode | Boolean(1/0) | This configuration make te extension to wrap opcodes. Default 1 |
| hdiv.debug_level | Number(0-7) | Debug level for logging. It matches syslog levels. Default 0 |
| hdiv.debug_size | Filesize | It indicates how big the debug log file can be. Default 100M |
| hdiv.debug_rotations | Number | This indicates the maximum amount of rotations the logging file will have. Default 1 |
| hdiv.debug_path | String | It indicates where the logging file will be created. Default /tmp |