This allows you to tell PuTTY that the host it will really end up connecting to is different from where it thinks it is making a network connection.
You might use this, for instance, if you had set up an SSH port forwarding in one PuTTY session so that connections to some arbitrary port (say, localhost port 10022) were forwarded to a second machine's SSH port (say, foovax port 22), and then started a second PuTTY connecting to the forwarded port.
In normal usage, the second PuTTY will access the host key cache under the host name and port it actually connected to (i.e. localhost port 10022 in this example). Using the logical host name option, however, you can configure the second PuTTY to cache the host key under the name of the host you know that it's really going to end up talking to (here foovax).
This can be useful if you expect to connect to the same actual server through many different channels (perhaps because your port forwarding arrangements keep changing): by consistently setting the logical host name, you can arrange that PuTTY will not keep asking you to reconfirm its host key. Conversely, if you expect to use the same local port number for port forwardings to lots of different servers, you probably didn't want any particular server's host key cached under that local port number. (For this latter case, you could also explicitly configure host keys in the relevant sessions; see
section 4.19.3
.)
If you just enter a host name for this option, PuTTY will cache the SSH host key under the default SSH port for that host, irrespective of the port you really connected to (since the typical scenario is like the above example: you connect to a silly real port number and your connection ends up forwarded to the normal port-22 SSH server of some other machine). To override this, you can append a port number to the logical host name, separated by a colon. E.g. entering ‘foovax:2200’ as the logical host name will cause the host key to be cached as if you had connected to port 2200 of foovax.
If you provide a host name using this option, it is also displayed in other locations which contain the remote host name, such as the default window title and the default SSH password prompt. This reflects the fact that this is the host you're really connecting to, which is more important than the mere means you happen to be using to contact that host. (This applies even if you're using a protocol other than SSH.)
4.14 The Data panel
The Data panel allows you to configure various pieces of data which can be sent to the server to affect your connection at the far end.
Each option on this panel applies to more than one protocol. Options which apply to only one protocol appear on that protocol's configuration panels.
•
4.14.1 ‘Auto-login username’
•
4.14.2 Use of system username
•
4.14.3 ‘Terminal-type string’
•
4.14.4 ‘Terminal speeds’
•
4.14.5 Setting environment variables on the server
4.14.1 ‘Auto-login username’
All three of the SSH, Telnet and Rlogin protocols allow you to specify what user name you want to log in as, without having to type it explicitly every time. (Some Telnet servers don't support this.)
In this box you can type that user name.
4.14.2 Use of system username
When the previous box (
section 4.14.1
) is left blank, by default, PuTTY will prompt for a username at the time you make a
connection.
In some environments, such as the networks of large organisations implementing single sign-on, a more sensible default may be to use the name of the user logged in to the local operating system (if any); this is particularly likely to be useful with GSSAPI authentication (see
section 4.22
). This control allows you to change the default behaviour.
The current system username is displayed in the dialog as a convenience. It is not saved in the configuration; if a saved session is later used by a different user, that user's name will be used.