Differences
This shows you the differences between the selected revisions of the page.
| 2013-08-12 | 2013-12-19 | ||
| ui_login_tls (martin) | 5.5 redesigned login dialog (martin) | ||
| Line 1: | Line 1: | ||
| ====== Configuring Session (Login Dialog) ====== | ====== Configuring Session (Login Dialog) ====== | ||
| - | To [[session_configuration|configure your session]], start WinSCP, and then use the Login dialog that opens. It can be invoked also later to [[task_connections#opening_additional_connection|open additional sessions]]. The Login dialog's options are categorised to pages, which are documented separately. The program hides advanced options (even complete pages) unless you select the //Advanced options// checkbox below the navigation tree. | + | To [[session_configuration|configure your session]], start WinSCP, and then use the Login dialog that opens. It can be invoked also later to [[task_connections#opening_additional_connection|open additional sessions]]. |
| - | &screenshotpict(login_session) | + | //Login dialog was redesigned in recent release. If you are using an older version of WinSCP, it won't match with what with page describes.// &recent |
| - | ===== [[using]] Using Dialog ===== | + | &screenshotpict(login) |
| - | If there are no [[session_configuration#site|sites]] (stored sessions), &beta WinSCP displays the //[[ui_login_session|Session page]]//. After you store one or more sites on the //[[ui_login_stored_sessions|Sites/Stores sessions page]]//, &beta the //Sites page// will be the WinSCP Login dialog box's default view. | + | ===== New Site ===== |
| + | To connect to a new site, select //New Site// node in the tree on the left. Then select [[protocols|protocol]], enter hostname and your user name. Typically you will also need to enter your password. For details see below. | ||
| - | After you configure the session, you can open it by clicking //Login// or [[session_configuration#site|save]] it by clicking //Save//. | + | To start ad-hoc connection, click //Login// button. |
| - | To set current session options as [[session_configuration#default|defaults]] use //Set defaults// command in drop down menu of //Save// button.((On Windows XP and older, use //Set defaults// button on //[[ui_login_stored_sessions|Sites/Stored sessions page]]//. &beta)) | + | If you plan to connect to the site ofter, you will want to [[session_configuration#site|save]] the site by clicking //Save As// button. |
| - | ===== Pages ===== | + | ==== Session Settings ==== |
| - | Pages available on Login dialog: | + | The //File protocol// selection lets you choose [[protocols|transfer protocol]]. |
| - | * [[ui_login_session|Session]] (basic session options) | + | When [[ftp|FTP protocol]] is selected, you can further specify to use basic unsecured variant (//No encryption//) or one of three methods to invoke [[ftps|FTPS]]. |
| - | * [[ui_login_stored_sessions|Sites/Stored sessions]] (to manage sites/stored sessions) &beta | + | |
| - | * [[ui_login_logging|Logging]] (to enable logging) | + | |
| - | * [[ui_login_environment|Environment]] (server compatibility options, filename encoding, DST, etc) | + | |
| - | * [[ui_login_directories|Directories]] (initial directories, directory cache) | + | |
| - | * [[ui_login_recycle_bin|Recycle Bin]] | + | |
| - | * [[ui_login_sftp|SFTP]] (SFTP protocol specific/compatibility options) | + | |
| - | * [[ui_login_scp|SCP/Shell]] (shell and SCP protocol specific/compatibility options) | + | |
| - | * [[ui_login_ftp|FTP]] (FTP protocol specific options) | + | |
| - | * [[ui_login_connection|Connection]] (timeouts, keepalives) | + | |
| - | * [[ui_login_proxy|Proxy]] (connection thru proxy server) | + | |
| - | * [[ui_login_tunnel|Tunnel]] (connection thru SSH tunnel) | + | |
| - | * [[ui_login_tls|TLS/SSL]] (TLS/SSL protocol options) | + | |
| - | * [[ui_login_ssh|SSH]] (SSH protocol options and authentication) | + | |
| - | * [[ui_login_kex|Key exchange]] (key exchange and reexchange options) | + | |
| - | * [[ui_login_authentication|Authentication]] (advanced authentication options) | + | |
| - | * [[ui_login_bugs|Bugs]] (detections of known bugs in SSH servers) | + | |
| - | * [[ui_login_preferences|Preferences]] ([[ui_preferences|interface/behaviour configuration]]) | + | |
| - | ===== Other Tasks ===== | + | The //Host name// box is where you type the name, or the IP address, of the server you want to connect to. //Host name// is the only mandatory box that must be filled for a session to open. You can use environment variables in the value with syntax ''%NAME%''. |
| + | |||
| + | The //Port number// box lets you specify which port number on the server to connect to. You need to specify it only in rare circumstances, when the server uses non standard protocol.((SSH protocol uses port number 22 by default. FTP protocol uses port number 21 by default. [[ftps|FTPS]] protocol with implicit encryption uses port number 990 by default.)) Otherwise WinSCP selected the protocol for you. | ||
| + | |||
| + | The //Username// box is where you type your account name on the server. If you do not fill the username and it needs to be known to complete authentication (most cases), you will be [[ui_authenticate#username|prompted for username]] then. You can use environment variables in the value with syntax ''%NAME%''. | ||
| + | |||
| + | The //Password// box is for the password associated with the account. You are advised not to fill it in if you are going to [[session_configuration#site|save the site]]. If you decide to do so nevertheless, do not forget to force password storing on the //[[ui_login_save|Save session as dialog]]//. Also do not fill the password if you are going to use other [[ssh#authentication_in_ssh|authentication method]] (like public key). If you do not fill the password and other authentication methods fail (password authentication has the lowest preference), you will be [[ui_authenticate#password|prompted for password]] then. | ||
| + | |||
| + | With [[ftp|FTP protocol]] you can use //Anonymous login//. It effectively sets the //User name// to ''anonymous'' and //Password// to ''anonymous@example.com''. | ||
| + | |||
| + | If you need to configure advanced settings, click //Advanced// button to open [[ui_login_advanced|Advanced Site Settings dialog]]. | ||
| + | |||
| + | ===== Sites/Stored Sessions Management ===== | ||
| + | The list on the left shows saved [[session_configuration#site|sites]] (stored sessions) and [[workspace|workspaces]]. &beta You should select there a site, site folder, or workspace to work with before using pressing one of the //Login// or //Edit// (sites only) button or using //Delete//, //Rename// and other commands from //Manage// menu (also available from context menu). | ||
| + | |||
| + | Double clicking a site or workspace opens is (as if you have clicked //Login// button). | ||
| + | |||
| + | To open all sites in site folder, select the folder and press //Login// button. | ||
| + | |||
| + | If you have many sites, you can quickly jump to a site by typing any part of its name. Then you can use ''Tab'' (or ''Shift-Tab'') to search next (previous) matching sites. Press ''Esc'' to cancel searching. | ||
| + | |||
| + | ==== [[folders]] Site/Stored Session Folders ==== | ||
| + | The sites (stored sessions) &beta can be organized into folders. Expand/collapse folder by double-clicking on its name. | ||
| + | |||
| + | Use the //Manage > New folder// command to create new site folder. To create subfolder, use path syntax "folder/subfolder" (Select the parent folder before pressing button to have the path prefilled). Note that empty folders are not preserved. | ||
| + | |||
| + | ==== [[edit]] Editing Existing Site/Stored Session ==== | ||
| + | &beta | ||
| + | Use //Edit// button to start editing selected site (stored session). &beta After you complete your changes, save them with //Save// button. You can also saved modified site under a new name using //Save As// command from drop down menu of //Save// button. | ||
| + | |||
| + | Use //Cancel// button to rollback your changes. | ||
| + | |||
| + | Note that you cannot login to the site until you commit (or rollback) your changes. | ||
| + | |||
| + | ==== Deleting ==== | ||
| + | &beta | ||
| + | The //Manage > Delete// button (or ''Del'' key) deletes selected site (stored session) &beta, site folder or workspace. Deleting a site folder deletes all the sites it contains. | ||
| + | |||
| + | ==== Renaming ==== | ||
| + | &beta | ||
| + | Use the //Manage > Rename// button to rename selected site (stored session) &beta, site folder or workspace. | ||
| + | |||
| + | ==== Creating Shortcuts ==== | ||
| + | &beta | ||
| + | Use //Manage > Desktop Icon// command to [[integration#desktop_and_quick_launch_icons|Desktop]] shortcut icons for selected site (stored session), site folder or workspace. For sites you can create also [[integration#send_to|'Send To']] shortcuts. &beta | ||
| + | |||
| + | Note that if you delete the site the existing icons will not work anymore. | ||
| + | |||
| + | ===== Opening Site in PuTTY ===== | ||
| + | You can open configured session or selected site in [[integration_putty|PuTTY SSH client]] instead of WinSCP. Use //Manage > Open in PuTTY// command. | ||
| + | |||
| + | ===== Default Session Settings ===== | ||
| + | Use //Manage > Set Defaults// set configured session settings or settings of selected site as [[session_configuration#default|default session settings]]. | ||
| + | |||
| + | ===== Tools Menu===== | ||
| In addition to configuring the session, you can use the WinSCP Login dialog box to: | In addition to configuring the session, you can use the WinSCP Login dialog box to: | ||
| - | * [[languages#switching_language|Change UI Language]] | + | * [[ui_import|Import sites from PuTTY or FileZilla]]; |
| - | ··* [[ui_import|Import Sites from PuTTY or FileZilla]] | + | * [[config#import|Import]]/[[config#export|Export configuration]]; |
| - | * [[config#import|Import]]/[[config#export|Export Configuration]] | + | * [[ui_cleanup|Cleanup data stored on your computer by WinSCP]]; |
| - | * [[ui_cleanup|Cleanup Data stored on Your Computer by WinSCP]] | + | * Run [[ui_puttygen|PuTTYgen]] or [[ui_pageant|Pageant]]; |
| - | * [[ui_about|Show About dialog]] | + | * [[updates|Check for application updates]]; |
| - | * [[updates|Check for Application Updates]] | + | * Open [[ui_preferences|Preferences dialog]]; |
| + | * Open [[ui_about|About dialog]]. | ||