1 https.server

evilsocket edited this page 2019-02-05 11:18:45 +01:00

A simple HTTPS server, used to serve files and scripts across the network.

Commands

command	description
https.server on	Start the HTTP server in the background.
https.server off	Stop the HTTP server in the background.

Parameters

parameter	default	description
https.server.path	.	Server folder.
https.server.address	<interface address>	Address to bind the http server to.
https.server.port	443	Port to bind the http server to.
https.server.certificate	~/.bettercap-https.cert.pem	TLS certificate file (will be auto generated if filled but not existing).
https.server.key	~/.bettercap-https.key.pem	TLS key file (will be auto generated if filled but not existing).
https.server.certificate.bits	4096	Number of bits of the RSA private key of the generated HTTPS certificate.
https.server.certificate.commonname	bettercap	Common Name field of the generated HTTPS certificate.
https.server.certificate.country	US	Country field of the generated HTTPS certificate.
https.server.certificate.locality		Locality field of the generated HTTPS certificate.
https.server.certificate.organization	bettercap devteam	Organization field of the generated HTTPS certificate.
https.server.certificate.organizationalunit	https://bettercap.org/	Organizational Unit field of the generated HTTPS certificate.

Examples

One liner to serve /var/www/html:

$ sudo bettercap -eval "set https.server.path /var/www/html; https.server on"

• Known Issues
• Using with Docker
• Compilation
  • on Linux and macOS
  • on Windows
  • on Android
  • cross compilation (ARM example)
• Interactive Mode and Command Line Arguments
• Changing the Prompt
• Caplets

Modules

• Core
  • events.stream
  • ticker
  • api.rest
  • update
  • caplets
• HID on 2.4Ghz (mousejacking)
  • hid.recon / sniff / inject
• Bluetooth Low Energy
  • ble.recon / enum / write
• 802.11
  • wifi.recon / assoc / deauth / ap
• Ethernet and IP
  • net.recon
  • net.probe
  • net.sniff / net.fuzz
  • syn.scan
  • wake on lan
  • Spoofers
    • arp.spoof
    • dhcp6.spoof
    • dns.spoof
  • Proxies
    • any.proxy
    • packet.proxy
    • tcp.proxy
      • modules
    • http.proxy
    • https.proxy
      • modules
• Servers
  • http.server
  • https.server
• Rogue Servers
  • mysql.server
• Utils
  • mac.changer
  • gps

bettercap.org | @bettercap | team