hissh-agent implements an SSH agent which provides access to SSH keys stored in a himitsu(7) key store.
hissh-agent
The hissh-agent command will place an SSH agent socket at $XDG_RUNTIME_DIR/hissh-agent. The user should set the SSH_AUTH_SOCK environment variable to this path.
hissh-agent
&
export SSH_AUTH_SOCK=$XDG_RUNTIME_DIR/hissh-agent
SSH keys stored in the Himitsu key store will be provided automatically. To add new keys, see hissh-import(1). It is recommended to run these commands for your entire session using a suitable system-specific service manager or startup script.
The agent can be configured in the himitsu config himitsu.ini(5) at $XDG_CONFIG_HOME/himitsu/config.ini.
Options related to remembering consent are placed into the [ssh.remember] section. The available options are:
persist
A comma separated list of remember options that are passed to the prompter when requesting persistent access to the proto=ssh query. Leaving this option blank is equivalent to skip and will cause the agent to skip this request.
Possible options are session, skip, refuse or a timeout in seconds as integer. session will remember consent until himitsu or hissh-agent terminates. skip will postpone the decision until the next prompt and refuse will deny the request and future requests won’t be shown.
The first value will be considered as the default one by the prompter.
Default value, if the option is omitted: session,300,refuse
disclose
A comma separated list of remember options that are passed to the when requesting private key disclosure (e.g.: in signing operations). Leave blank, if not applicable.
Uses the same syntax as the persist option.
Default value, if the option is omitted: skip,session,300
The following example skips remembering
[ssh.remember]
persist=skip
disclose=skip
hissh-import(1), hissh-export(1)
Maintained by Drew DeVault <[email protected]>, who is assisted by other contributors. Up-to-date source code can be found at https://git.sr.ht/˜sircmpwn/himitsu-ssh, and bugs/patches can be submitted by email to ˜sircmpwn/[email protected].