Environment variables type
Use the environment variables object type to define environment variables for your apps in your app's manifest file.
The environment variables object is not an IBM® QRadar® application type. The following four environment variables are set automatically by QRadar and are available to use in your app.
- QRADAR_CONSOLE_HOST_NAME
- The host name of the console where the app is installed.
- QRADAR_CONSOLE_IP
- The IP address of where the app is installed.
- QRADAR_APPLICATION_BASE_URL
- The web URL for the app.
- LANG
- The language code and character encoding that is used by the QRadar Console UI when the app is installed.
- HTTP_PROXY / HTTPS_PROXY
- If a proxy is configured, this environment variable is the IP address/hostname of the proxy server that QRadar uses.
- PROXY_USERNAME
- If a proxy is configured, this environment variable is the username of the HTTPS proxy server that QRadar uses.
- PROXY_PASSWORD_DECRYPTED
- If a proxy is configured, this environment variable is the decrypted password of the HTTPS proxy server that QRadar uses.
- PROXY_URL
- If a proxy is configured, this environment variable is the IP address/hostname of the proxy server that QRadar uses.
- PROXY_PORT
- If a proxy is configured, this environment variable is the port number of the proxy server that QRadar uses.
Environment variables that you define in an app's manifest file are specific to that app and haven no effect outside the app container.
The following code sample shows how to configure the environment_variables block in the manifest file.
{
...
"environment_variables":[
{
"name":"ENV_VAR1",
"value":"1"
},
{
"name":"ENV_VAR2",
"value":"2"
},
{
"name":"ENV_VAR3",
"value":"3"
}
],
...
}
The following table explains the manifest fields for the environment_variables block.
Field | Type | Description | Required |
---|---|---|---|
name | String | The name of the environment variable. Environment variable names cannot begin with a number, or contain an equals (=) sign. |
Yes |
value | String | The value of the environment variable. | Yes |