Dynamic Params
Evilginx Pro reserves a set of dynamic parameter placeholders whose values are generated from the current server and phishlet configuration. They use the same ${placeholder_name} syntax as custom parameters. Placeholders that need an argument put it after a colon: ${placeholder_name:parameter}.
Dynamic parameters can be used in Phishlets 2.0 configuration values and injected JavaScript. Evilginx Pro replaces each placeholder with its generated value when it processes the configuration or script.
Phishlet configuration files
These placeholders are available in Phishlets 2.0 configuration files. They are particularly useful in match_value and value fields—for example, in rewrite rules that replace a hostname trusted by client-side anti-phishing protections with the corresponding Evilginx proxy hostname.
| Placeholder | Parameter | Parameter format | Generated output, use, and example |
|---|---|---|---|
${proxy_hostname:hostname} | Required | An original hostname defined in proxy.hosts, such as accounts.google.com. | The proxy hostname generated for the referenced original hostname using the current Evilginx configuration. Example: ${proxy_hostname:accounts.google.com} → accounts.google.phishing.com. |
${proxy_subdomain:hostname} | Required | An original hostname defined in proxy.hosts, such as accounts.google.com. | The subdomain portion of the proxy hostname generated for the referenced original hostname. Example: ${proxy_subdomain:accounts.google.com} → accounts. |
${phishlet_hostname} | None | — | The current phishlet hostname, without any proxy subdomain. This is the value configured with phishlets set <phishlet> hostname <hostname>. Example: ${phishlet_hostname} → google.phishing.com. |
${phishlet_domain} | None | — | The base domain configured for the current phishlet. Example: ${phishlet_domain} → phishing.com. |
${phishlet_landing_url:phishlet} | Required | The full name of an enabled phishlet, such as evilginx/google. If the phishlet is unavailable or disabled, the output is an empty string. | A custom lure URL leading to the named phishlet's phishing page. This is useful in injected JavaScript that needs to navigate to another phishlet. Example: ${phishlet_landing_url:evilginx/google} → https://accounts.google.v2.fake.com/?ff=c216f76b. |
JavaScript injects
All placeholders from Phishlet configuration files are also available in JavaScript files injected by the Evilginx proxy. The following additional placeholders generate JavaScript values or function calls for scripts hosted with a phishlet or injected into reverse-proxied pages.
| Placeholder | Parameter | Parameter format | Generated output, use, and example |
|---|---|---|---|
${js_bitb_show_popup:phishlet} | Required | The full name of an enabled phishlet, such as evilginx/google. If the phishlet is unavailable or disabled, the output is an empty string. | A call to the internal Browser-in-the-Browser (BITB) function that opens a popup containing the named phishlet. Example: ${js_bitb_show_popup:evilginx/google} → obfuscatedBITBShow(...). |
${js_bitb_hide_popup} | None | — | A call to the internal BITB function that hides any visible popup. Example: ${js_bitb_hide_popup} → obfuscatedBITBHide(). |
${js_phishlet_enabled:phishlet} | Required | The full name of a phishlet, such as evilginx/google. | true when the named phishlet is available and enabled, false when it is available but disabled, or an empty string when it is unavailable. Use it to conditionally redirect to or show a BITB popup for another phishlet. Example: ('${js_phishlet_enabled:evilginx/google}' === 'true'); ${js_phishlet_enabled:evilginx/google} → true. |