Environment Variables
ANTA exposes several environment variables that allow you to configure its behavior. These variables are automatically read during the initialization and preparation phases, ensuring the environment is configured correctly before any tests are executed.
Summary¶
| Variable | Default | Consumed By | Description |
|---|---|---|---|
ANTA_HTTPX_TRUST_ENV |
true |
AsyncEOSDevice | Configures the trust_env parameter for the underlying HTTPX client. When false, HTTPX ignores environment variables for proxy and SSL settings. See the HTTPX documentation for details. |
ANTA_SSL_CIPHERS |
unset | AsyncEOSDevice | OpenSSL cipher list used by HTTPS eAPI connections without explicit per-device ssl_params. Custom ciphers may reduce TLS security. |
Example Usage¶
The examples below show common scenarios where environment variables can be used to adjust ANTA’s behavior.
Disabling proxy environment variable passthrough¶
export ANTA_HTTPX_TRUST_ENV=false
anta nrfu table
Configuring SSL ciphers globally¶
export ANTA_SSL_CIPHERS="AES256-SHA:DHE-RSA-AES256-SHA:AES128-SHA:DHE-RSA-AES128-SHA"
anta nrfu table
ANTA_SSL_CIPHERS applies to every HTTPS inventory entry that does not define ssl_params. Prefer upgrading EOS or configuring an EOS server-side SSL profile instead of enabling legacy ciphers when possible.