-
Notifications
You must be signed in to change notification settings - Fork 449
Parameters
Kevin Robertson edited this page Jul 26, 2019
·
36 revisions
To cover as many use cases as possible, Inveigh has a lot of parameters (I’ll admit it’s an obnoxious amount at this point) for tweaking how Inveigh and Inveigh-Relay will run. This section contains a list of all current parameters with brief descriptions.
Parameter | Default | Valid Values | Description |
---|---|---|---|
LLMNR | Enabled | Y/N | Enable/Disable LLMNR spoofer. |
LLMNRTTL | 30 Seconds | Seconds | LLMNR TTL in seconds for the response packet. |
mDNS | Disabled | Y/N | Enable/Disable mDNS spoofing. |
mDNSTTL | 120 Seconds | Seconds | mDNS TTL in seconds for the response packet. |
mDNSTypes | QU | QU,QM | Comma separated list of mDNS types to spoof. Note that QM will send the response to 224.0.0.251. |
NBNS | Disabled | Y/N | Enable/Disable NBNS spoofer. |
NBNSTTL | 165 Seconds | Seconds | NBNS TTL in seconds for the response packet. |
NBNSTypes | 00,20 | 00,03,20,1B | Comma separated list of NBNS types to spoof. Types include 00 = Workstation Service, 03 = Messenger Service, 20 = Server Service, 1B = Domain Name |
NBNSBruteForce | Disabled | Y/N | Enable/Disable NBNS brute force spoofer. |
NBNSBruteForceHost | WPAD | Hostname for NBNS brute force spoofer. | |
NBNSBruteForcePause | Disabled | Seconds | Time in seconds the NBNS brute force spoofer will stop spoofing after an incoming HTTP request is received. |
SpooferHostsIgnore | Hostnames | Comma separated list of requested hostnames to ignore when spoofing. | |
SpooferHostsReply | Hostnames | Comma separated list of requested hostnames to respond to when spoofing with LLMNR and NBNS. Listed hostnames will override the whitelist created through SpooferLearning. | |
SpooferIP | Local IP | Response IP address for spoofing. This parameter is only necessary when redirecting victims to a system other than the Inveigh host. | |
SpooferIPsIgnore | IPs | Comma separated list of source IP addresses to ignore when spoofing. | |
SpooferIPsReply | IPs | Comma separated list of source IP addresses to respond to when spoofing. | |
SpooferLearning | Disabled | Y/N | Enable/Disable LLMNR/NBNS valid host learning. If enabled, Inveigh will send out LLMNR/NBNS requests for any received LLMNR/NBNS requests. If a response is received, Inveigh will add the hostname to a spoofing blacklist. The valid system must respond to the protocol type that matches the protocol of the original request in order to be blacklisted. |
SpooferLearningDelay | Minutes | Time in minutes that Inveigh will delay spoofing while valid hosts are being blacklisted through SpooferLearning. | |
SpooferLearningInterval | 30 Minutes | Minutes | Time in minutes that Inveigh will wait before sending out an LLMNR/NBNS request for a hostname that has already been checked through SpooferLearning. |
SpooferRepeat | Enabled | Y/N | Enable/Disable repeated LLMNR/NBNS spoofs to a victim system after one user challenge/response has been captured. |
Parameter | Default | Valid Values | Description |
---|---|---|---|
Challenge | 16 character hex NTLM challenge for use with the HTTP listener. If left blank, a random challenge will be generated for each request. This will only be used for non-relay captures. | ||
HTTP | Enabled | Y/N | Enable/Disable HTTP challenge/response capture. |
HTTPAuth | NTLM | Anonymous, Basic, NTLM, NTLMNoESS | HTTP/HTTPS server authentication type. This setting does not apply to wpad.dat requests. NTLMNoESS turns off the 'Extended Session Security' flag during negotiation. |
HTTPBasicRealm | Realm name for Basic authentication. This parameter applies to both HTTPAuth and WPADAuth. | ||
HTTPContentType | text/html | ||
HTTPDefaultEXE | EXE filename within the HTTPDir to serve as the default HTTP/HTTPS response for EXE requests. | ||
HTTPDefaultFile | Filename within the HTTPDir to serve as the default HTTP/HTTPS response file. This file will not be used for wpad.dat requests. | ||
HTTPDir | Full directory path to enable hosting of basic content through the HTTP/HTTPS listener. | ||
HTTPIP | 0.0.0.0 | IP address for the HTTP listener. | |
HTTPPort | 80 | TCP port for the HTTP listener. | |
HTTPResetDelay | Firefox | Comma separated list of keywords to use for filtering browser user agents. Matching browsers will have a delay before their connections are reset when Inveigh doesn't receive data. This can increase the chance of capturing authentication through a popup box with some browsers (Firefox). | |
HTTPResetDelayTimeout | 30 Seconds | Seconds | HTTPResetDelay timeout in seconds. |
HTTPResponse | String or HTML to serve as the default HTTP/HTTPS response. This response will not be used for wpad.dat requests. This parameter will not be used if HTTPDir is set. Use PowerShell character escapes where necessary. | ||
HTTPS | Disabled | Y/N | Enable/Disable HTTPS challenge/response capture. Warning, a cert will be installed in the local store. If the script does not exit gracefully, manually remove the certificate. This feature requires local administrator access. |
HTTPSCertIssuer | Inveigh | The issuer field for the cert that will be installed for HTTPS. | |
HTTPSCertSubject | localhost | The subject field for the cert that will be installed for HTTPS. | |
HTTPSForceCertDelete | Disabled | Y/N | Force deletion of an existing certificate that matches HTTPSCertIssuer and HTTPSCertSubject. |
HTTPSPort | 443 | TCP port for the HTTPS listener. | |
Proxy | Disabled | Y/N | Enable/Disable proxy server authentication captures. |
ProxyAuth | NTLM | Basic, NTLM, NTLMNoESS | Proxy server authentication type. |
ProxyIgnore | Firefox | Comma separated list of keywords to use for filtering browser user agents. Matching browsers will not be sent the wpad.dat file used for capturing proxy authentications. Firefox does not work correctly with the proxy server failover setup. Firefox will be left unable to connect to any sites until the proxy is cleared. Remove "Firefox" from this list to attack Firefox. If attacking Firefox, consider setting -SpooferRepeat N to limit attacks against a single target so that victims can recover Firefox connectivity by closing and reopening. | |
ProxyIP | 0.0.0.0 | IP address for the proxy listener. | |
ProxyPort | 8492 | TCP port for the proxy listener. | |
WPADAuth | NTLM | Anonymous, Basic, NTLM, NTLMNoESS | HTTP/HTTPS server authentication type for wpad.dat requests. Setting to Anonymous can prevent browser login prompts. NTLMNoESS turns off the 'Extended Session Security' flag during negotiation. |
WPADAuthIgnore | Disabled | Comma separated list of keywords to use for filtering browser user agents. Matching browsers will be skipped for NTLM authentication. This can be used to filter out browsers like Firefox that display login popups for authenticated wpad.dat requests such as Firefox. | |
WPADDirectFile | Enabled | Y/N | Enable/Disable serving a proxyless, all direct, wpad.dat file for wpad.dat requests. Enabling this setting can reduce the amount of redundant wpad.dat requests. This parameter is ignored when using WPADIP, WPADPort, or WPADResponse. |
WPADDirectHosts | Comma separated list of hosts to list as direct in the wpad.dat file. Listed hosts will not be routed through the defined proxy. | ||
WPADIP | Proxy server IP to be included in a basic wpad.dat response for WPAD enabled browsers. This parameter must be used with WPADPort. | ||
WPADPort | Proxy server port to be included in a basic wpad.dat response for WPAD enabled browsers. This parameter must be used with WPADIP. | ||
WPADResponse | wpad.dat file contents to serve as the wpad.dat response. This parameter will not be used if WPADIP and WPADPort are set. Use PowerShell character escapes where necessary. |
Parameter | Default | Valid Values | Description |
---|---|---|---|
ConsoleOutput | Disabled | Low, Medium, Y, N | Enable/Disable real time console output. If using this option through a shell, test to ensure that it doesn't hang the shell. Medium and Low can be used to reduce output. |
ConsoleQueueLimit | Unlimited | Maximum number of queued up console log entries when not using the real time console. | |
ConsoleStatus | Disabled | Minutes | Interval in minutes for displaying all unique captured hashes and credentials. This is useful for displaying full capture lists when running through a shell that does not have access to the support functions. |
ConsoleUnique | Enabled | Y/N | Enable/Disable displaying challenge/response hashes for only unique IP, domain/hostname, and username combinations when real time console output is enabled. |
FileOutput | Disabled | Y/N | Enable/Disable real time file output. |
FileOutputDirectory | Working Directory | Valid path to an output directory for log and capture files. FileOutput must also be enabled. | |
FileUnique | Enabled | Y/N | Enable/Disable outputting challenge/response hashes for only unique IP, domain/hostname, and username combinations when real time file output is enabled. |
LogOutput | Enabled | Y/N | Enable/Disable storing log messages in memory. |
OutputStreamOnly | Disabled | Y/N | Enable/Disable forcing all output to the standard output stream. This can be helpful if running Inveigh through a shell that does not return other output streams. Note that you will not see the various yellow warning messages if enabled. |
ShowHelp | Enabled | Y/N | Enable/Disable the help messages at startup. |
StatusOutput | Enabled | Y/N | Enable/Disable startup and shutdown messages. |
- ElevatedPrivilege - Default = Auto: (Auto/Y/N) Set the privilege mode. Auto will determine if Inveigh is running with elevated privilege. If so, options that require elevated privilege can be used.
- Inspect - (Switch) Disable LLMNR, NBNS, HTTP, HTTPS, and SMB in order to only inspect LLMNR/NBNS traffic.
- IP - Local IP address for listening and packet sniffing. This IP address will also be used for LLMNR/mDNS/NBNS spoofing if the SpooferIP parameter is not set.
- MachineAccounts - Default = Disabled: (Y/N) Enable/Disable showing NTLM challenge/response captures from machine accounts.
- SMB - Default = Enabled: (Y/N) Enable/Disable SMB challenge/response capture. Warning, LLMNR/NBNS spoofing can still direct targets to the host system's SMB server. Block TCP ports 445/139 or kill the SMB services if you need to prevent login requests from being processed by the Inveigh host.
- StartupChecks - Default = Enabled: (Y/N) Enable/Disable checks for in use ports and running services on startup.
- RunCount - Default = Unlimited: (Integer) Number of NTLMv1/NTLMv2 captures to perform before auto-exiting.
- RunTime - Default = Unlimited: (Integer) Run time duration in minutes.
- Tool - Default = 0: (0/1/2) Enable/Disable features for better operation through external tools such as Metasploit's Interactive Powershell Sessions and Empire. 0 = None, 1 = Metasploit, 2 = Empire
- Command - Command to execute on SMB relay target. Use PowerShell character escapes where necessary.
- RelayAutoDisable - Default = Enable: (Y/N) Automaticaly disable SMB relay after a successful command execution on target.
- RelayAutoExit - Default = Default = Enable: (Y/N) Enable/Disable automaticaly exiting after a relay is disabled due to success or error.
- SMB1 - (Switch) Force SMB1. The default behavior is to perform SMB version negotiation and use SMB2 if supported by the target.
- Service - Default = 20 Character Random: Name of the service to create and delete on the target.
- Target - IP address of system to target for SMB relay.
- Usernames - Default = All Usernames: Comma separated list of usernames to use for relay attacks. Accepts both username and domain\username format.
Parameter | Default | Valid Values | Description |
---|
- Challenge|||16 character hex NTLM challenge for use with the HTTP listener. If left blank, a random challenge will be generated for each request. Note that during SMB relay attempts, the challenge will be pulled from the SMB relay target.|
- HTTP|Enabled|Y/N|Enable/Disable HTTP challenge/response capture.|
- HTTPIP|0.0.0.0||IP address for the HTTP/HTTPS listener.|
- HTTPPort|80||TCP port for the HTTP listener.|
- HTTPResetDelay|Firefox||Comma separated list of keywords to use for filtering browser user agents. Matching browsers will have a delay before their connections are reset when Inveigh doesn't receive data. This can increase the chance of capturing/relaying authentication through a popup box with some browsers (Firefox).
- HTTPResetDelayTimeout|30 Seconds|Seconds|HTTPResetDelay timeout in seconds.|
- HTTPS|Disabled|Y/N|Enable/Disable HTTPS challenge/response capture. Warning, a cert will be installed in the local store and attached to port 443. If the script does not exit gracefully, execute "netsh http delete sslcert ipport=0.0.0.0:443" and manually remove the certificate from "Local Computer\Personal" in the cert store.|
- HTTPSCertIssuer|Inveigh||The issuer field for the cert that will be installed for HTTPS.|
- HTTPSCertSubject|localhost||The subject field for the cert that will be installed for HTTPS.|
- HTTPSForceCertDelete|Disabled|Y/N|Force deletion of an existing certificate that matches HTTPSCertIssuer and HTTPSCertSubject.|
- Proxy|Disabled|Y/N|Enable/Disable proxy server authentication captures.|
- ProxyIgnore|Firefox||Comma separated list of keywords to use for filtering browser user agents. Matching browsers will not be sent the wpad.dat file used for capturing proxy authentications. Firefox does not work correctly with the proxy server failover setup. Firefox will be left unable to connect to any sites until the proxy is cleared. Remove "Firefox" from this list to attack Firefox. If attacking Firefox, consider setting -SpooferRepeat N to limit attacks against a single target so that victims can recover Firefox connectivity by closing and reopening.|
- ProxyIP|0.0.0.0||IP address for the proxy listener.|
- ProxyPort|8492||TCP port for the proxy listener.|
- WPADAuth|NTLM|Anonymous, NTLM|HTTP/HTTPS server authentication type for wpad.dat requests. Setting to Anonymous can prevent browser login prompts.|
- WPADAuthIgnore|Disabled||Comma separated list of keywords to use for filtering browser user agents. Matching browsers will be skipped for NTLM authentication. This can be used to filter out browsers like Firefox that display login popups for authenticated wpad.dat requests such as Firefox.|
Parameter | Default | Valid Values | Description |
---|---|---|---|
ConsoleOutput | Disabled | Low, Medium, Y, N | Enable/Disable real time console output. If using this option through a shell, test to ensure that it doesn't hang the shell. Medium and Low can be used to reduce output. |
ConsoleQueueLimit | Unlimited | Maximum number of queued up console log entries when not using the real time console. | |
ConsoleStatus | Disabled | Interval in minutes for displaying all unique captured hashes and credentials. This is useful for displaying full capture lists when running through a shell that does not have access to the support functions. | |
ConsoleUnique | Enabled | Y/N | Enable/Disable displaying challenge/response hashes for only unique IP, domain/hostname, and username combinations when real time console output is enabled. |
FileOutput | Disabled | Y/N | Enable/Disable real time file output. |
FileOutputDirectory | Default | Working Directory: Valid path to an output directory for log and capture files. FileOutput must also be enabled. | |
LogOutput | Enabled | Y/N | Enable/Disable storing log messages in memory. |
OutputStreamOnly | Disabled | Enable/Disable forcing all output to the standard output stream. This can be helpful if running Inveigh Relay through a shell that does not return other output streams. Note that you will not see the various yellow warning messages if enabled. | |
ShowHelp | Enabled | Y/N | Enable/Disable the help messages at startup. |
StatusOutput | Enabled | Y/N | Enable/Disable startup and shutdown messages. |
- MachineAccounts - Default = Disabled: (Y/N) Enable/Disable showing NTLM challenge/response captures from machine accounts.
- RunTime - Default = Unlimited: (Integer) Run time duration in minutes.
- Tool - Default = 0: (0,1,2) Enable/Disable features for better operation through external tools such as Metasploit's Interactive Powershell Sessions and Empire. 0 = None, 1 = Metasploit, 2 = Empire