Scroll to navigation

PAM_SSH_ADD(8) pam_ssh_add PAM_SSH_ADD(8)

NAME

pam_ssh_add - PAM module to auto load ssh keys into an agent

DESCRIPTION

pam_ssh_add provides authentication and session modules that allow users to start their session with a running ssh-agent with as many ssh keys loaded as possible.

If used, the authentication module simply stores the authentication token for later use by the session module. Because this module performs no actual authentication it returns PAM_CRED_INSUFFICIENT on success and should always be accompanied by an actual authentication module in your pam configuration.

By default the session module will start a new ssh-agent and run ssh-add, loading any keys that exist in the default path for the newly logged in user. If any keys prompt for a password, and a authentication token was successfully stored, that token will be provided as the password.

OPTIONS

debug

This option will turn on debug logging to syslog.

EXAMPLES


auth required pam_unix.so
auth optional pam_ssh_add.so
session optional pam_ssh_add.so

AUTHOR

Cockpit has been written by many contributors[1].

BUGS

Please send bug reports to either the distribution bug tracker or the upstream bug tracker[2].

NOTES

1.
contributors
2.
upstream bug tracker
06/02/2023 pam_ssh_add