Differences

This shows you the differences between the selected revisions of the page.

2022-06-09 2023-03-02
5.20.4 putty tools 0.77: Pageant: Option --openssh-config to allow easy interoperation with Windows’s ssh.exe (martin) 6.0 Bug 1873: Support for OpenSSH certificates + other updates from PuTTY docs for Pageant 0.78 (martin)
Line 42: Line 42:
<code> <code>
-ssh-ed25519 SHA256:TddlQk20DVs4LRcAsIfDN9pInKpY06D+h4kSHwWAj4w +Ed25519 ···SHA256:TddlQk20DVs4LRcAsIfDN9pInKpY06D+h4kSHwWAj4w 
-ssh-rsa 2048 SHA256:8DFtyHm3kQihgy52nzX96qMcEVOq7/yJmmwQQhBWYFg+RSA  2048 ·SHA256:8DFtyHm3kQihgy52nzX96qMcEVOq7/yJmmwQQhBWYFg
</code> </code>
For each key, the list box will tell you: For each key, the list box will tell you:
-  * The type of the key. Currently, this can be ''ssh-rsa'' (an RSA key), ''ssh-dss'' (a DSA key), ''ecdsa-sha2-*'' (an ECDSA key), ''ssh-ed25519'' (an Ed25519 key), ''ssh-ed448'' (an Ed448 key), or ''ssh1'' (an RSA key for use with the deprecated SSH-1 protocol, not supported by WinSCP). +  * The type of the key. Currently, this can be ''RSA'', ''DSA'', ''NIST'' (an ECDSA key), ''Ed25519'', ''Ed448'', or ''SSH-1'' (an RSA key for use with the deprecated SSH-1 protocol, not supported by WinSCP). (If the key has an associated certificate, this is shown here with a ''cert'' suffix. //-- Only available in Pageant 0.78 included with latest beta version only//) &beta 
-  * The size (in bits) of the key, for key types that come in different sizes. +  * The size (in bits) of the key, for key types that come in different sizes. (For ECDSA NIST keys, this is indicated as ''p256'' or ''p384'' or ''p521''.) 
-  * The fingerprint for the public key. This should be the same fingerprint given by [[ui_puttygen|PuTTYgen]], and also the same fingerprint shown by remote utilities such as ''ssh-keygen'' when applied to your ''authorized_keys'' file. \\ By default this is shown in the SHA-256 format. You can change to the older MD5 format (which looks like ''aa:bb:cc:...'') with the //Fingerprint type// drop-down, but bear in mind that this format is less secure and should be avoided for comparison purposes where possible.+  * The fingerprint for the public key. This should be the same fingerprint given by [[ui_puttygen|PuTTYgen]], and also the same fingerprint shown by remote utilities such as ''ssh-keygen'' when applied to your ''authorized_keys'' file. \\ By default this is shown in the SHA-256 format. You can change to the older MD5 format (which looks like ''aa:bb:cc:...'') with the //Fingerprint type// drop-down, but bear in mind that this format is less secure and should be avoided for comparison purposes where possible. \\ If some of the keys loaded into Pageant have certificates attached, then Pageant will default to showing the fingerprint of the underlying key. This way, a certified and uncertified version of the same key will have the same fingerprint, so you can see that they match. You can instead use the //Fingerprint type// drop-down to ask for a different fingerprint to be shown for certified keys, which includes the certificate as part of the fingerprinted data. That way you can tell two certificates apart. &beta_feature
  * The comment attached to the key.   * The comment attached to the key.
  * The state of [[#deferred_decryption|deferred decryption]], if enabled for this key.   * The state of [[#deferred_decryption|deferred decryption]], if enabled for this key.
Line 118: Line 118:
So, if you want to use Windows Git with an SSH key held in Pageant, you'll have to set the environment variable ''GIT_SSH'', to point at a different program. You could point it at ''C:\Windows\System32\OpenSSH\ssh.exe'' once you've done this setup – but it's just as easy to point it at Plink! So, if you want to use Windows Git with an SSH key held in Pageant, you'll have to set the environment variable ''GIT_SSH'', to point at a different program. You could point it at ''C:\Windows\System32\OpenSSH\ssh.exe'' once you've done this setup – but it's just as easy to point it at Plink!
 +
 +==== Unix-domain sockets: integrating with WSL 1 ====
 +
 +Pageant can listen on the WinSock implementation of Unix-domain sockets. These interoperate with the Unix-domain sockets found in the original Windows Subsystem for Linux (now known as WSL 1). So if you ask Pageant to listen on one of these, then your WSL 1 processes can talk directly to Pageant.
 +
 +To configure this, run Pageant with the option ''--unix'', followed with a pathname. Then, in WSL 1, set the environment variable ''SSH_AUTH_SOCK'' to point at the WSL translation of that pathname.
 +
 +For example, you might run
 +<code>
 +pageant --unix C:\Users\Simon\.ssh\agent.sock
 +</code>
 +and in WSL 1, set the environment variable
 +<code>
 +SSH_AUTH_SOCK=/mnt/c/Users/Simon/.ssh/agent.sock
 +</code>
 +Alternatively, you can add a line to your ''.ssh/config'' file inside WSL that says
 +<code>
 +IdentityAgent /mnt/c/Users/Simon/.ssh/agent.sock
 +</code>
 +although doing it like that may mean that ''ssh-add'' commands won't find the agent, even though ''ssh'' itself will.
 +
 +Security note: Unix-domain sockets are protected against access by other users by the file protections on their containing directory. So if your Windows machine is multiuser, make sure you create the socket inside a directory that other users can't access at all. (In fact, that's a good idea on general principles.)
 +
 +Compatibility note: WSL 2 processes cannot talk to Pageant by this mechanism, because WSL 2's Unix-domain sockets are managed by a separate Linux kernel, and not by the same kernel that WinSock talks to.
 +
 +&beta_feature
==== Starting with the Key List Visible ==== ==== Starting with the Key List Visible ====

Last modified: by martin