diff --git a/docs/img/config_proxychoice.jpg b/docs/img/config_proxychoice.jpg new file mode 100644 index 0000000..7e29ccd Binary files /dev/null and b/docs/img/config_proxychoice.jpg differ diff --git a/docs/navigation.md b/docs/navigation.md index 4731bc2..1d1a332 100644 --- a/docs/navigation.md +++ b/docs/navigation.md @@ -15,6 +15,7 @@ * [Automatic password](pages/AutomaticPassword.md) * [Private key usage confirmation](pages/KeyConfirmation.md) * [Port knocking](pages/PortKnock.md) + * [Proxy choice](pages/ProxyChoice.md) * [SSH Handler: Internet Explorer integration](pages/SSHHandler.md) [Technical]() diff --git a/docs/pages/ProxyChoice.md b/docs/pages/ProxyChoice.md new file mode 100644 index 0000000..0f1b4aa --- /dev/null +++ b/docs/pages/ProxyChoice.md @@ -0,0 +1,39 @@ +
+ +## Proxy choice + +When working with bastion server, it could be boring to always ssh this one then to jump to reach the host we really want to connect to. + +A solution could be to open a permanent connection to the bastion with a **dynamic port forward** that acts like a **proxy socks**. Then configure your sessions to connect to real destination host throught this proxy (in `Connection/Proxy` panel of the configuration box). + +In order to make easier the connections, there is now an option for selecting a proxy to use directly from the main window of the configuration box: + + + +The **proxy choice** feature is disabled by default. The option can be activated by adding these two lines to the **kitty.ini** file. + +***kitty.ini file*** + + [ConfigBox] + proxyselection=yes + + +Proxies definitions are located in a new **KiTTY** configuration key: `[HKEY_CURRENT_USER\Software\9bis.com\KiTTY\Proxies]`. + +Below, is a configuration file to create a new proxy définition (**Proxy One [7070]**), that point to a socks4 server started on localhost (**127.0.0.1**) and listening on port **7070** (`00001b9e` in hexa): + +``` +Windows Registry Editor Version 5.00 + +[HKEY_CURRENT_USER\Software\9bis.com\KiTTY\Proxies\PROXY%20One%20[7070]] +"ProxyExcludeList"="" +"ProxyDNS"=dword:00000001 +"ProxyLocalhost"=dword:00000000 +"ProxyMethod"=dword:00000001 +"ProxyHost"="127.0.0.1" +"ProxyPort"=dword:00001b9e +"ProxyUsername"="" +"ProxyPassword"="" +"ProxyTelnetCommand"="connect %host %port\\n" +"ProxyLogToTerm"=dword:00000001 +```