Skip to content

Commit 71b687b

Browse files
committed
Add sample IdentityAgent configurations.
1 parent 1a7876c commit 71b687b

File tree

1 file changed

+21
-1
lines changed

1 file changed

+21
-1
lines changed

protocols/sftp/index.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -129,6 +129,24 @@ The agent `ssh-agent` is running by default on macOS. You add private key identi
129129
The following agents are supported:
130130
* OpenSSH `ssh-agent`.
131131
* [1Password SSH agent](https://developer.1password.com/docs/ssh/agent/compatibility/#cyberduck)
132+
* [Bitwarden](https://bitwarden.com/help/ssh-agent/#configure-bitwarden-ssh-agent)
133+
134+
Example `~/.ssh/config` configuration for 1Password:
135+
136+
```
137+
Host myhostname
138+
# 1Password SSH agent
139+
IdentityAgent ~/.1password/agent.sock
140+
```
141+
142+
Example `~/.ssh/config` configuration for Bitwarden:
143+
144+
```
145+
Host myhostname
146+
# Bitwarden SSH agent
147+
IdentityAgent ~/.bitwarden-ssh-agent.sock
148+
```
149+
132150

133151
:::
134152
:::{group-tab} Windows
@@ -145,7 +163,7 @@ The following agents are supported:
145163
When authenticating using Public Key Authentication with an SSH agent containing multiple identities, add `IdentitiesOnly yes` in `~/.ssh/config` to limit authentication attempts with this identity only. Otherwise, the server may deny the connection because of too many login failures, and you will receive the error _Too many authentication failures_.
146164
:::
147165

148-
Since the private key is not always available on the filesystem, specifying a public key as `IdentifyFile` is also supported. This can be used to authenticate using an SSH agent backed by a hardware token containing the private key for example.
166+
Since the private key is not always available on the filesystem, specifying a public key as `IdentifyFile` is also supported. This is particularly useful when the private key is saved in a password manager and only exposed by a custom SSH agent.
149167

150168
Example `~/.ssh/config` configuration:
151169

@@ -156,6 +174,8 @@ Host myhostname
156174
IdentitiesOnly yes
157175
```
158176

177+
Alternatively you can select the public key file in the [bookmark](../../cyberduck/bookmarks.md#edit-bookmark) configuration.
178+
159179
### One-Time Passcodes (2FA)
160180

161181
Using a challenge-response authentication with one-time password generators such as [*DUO*](https://duo.com/product/multi-factor-authentication-mfa), [*SecurID*](https://www.rsa.com/products/securid/) or [*Google Authenticator*](https://github.com/google/google-authenticator) is supported. After the initial login prompt for the username and password, a second login prompt is displayed to enter the one-time passcode.

0 commit comments

Comments
 (0)