# README

*sshdo* - controls which commands may be executed via incoming ssh

# DESCRIPTION

*sshdo* provides an easily configurable way of controlling which commands
may be executed via incoming *ssh* connections.

An *ssh* public key in a `~/.ssh/authorized_keys` file can have a
`command=""` option which forces a particular command to be executed when
the key is used to authenticate an *ssh* connection. This is a security
control that mitigates against private key compromise.

This is great when you only need to execute a single command. But if you
need to perform multiple tasks, you would normally need to create and
install a separate key pair for each command, or just not bother making use
of forced commands and allow the key to be used to execute any command.

Instead, you can make *sshdo* act as the forced command, and when an *ssh*
connection tries to execute a command, *sshdo* will consult the
configuration files, `/etc/sshdoers` and `/etc/sshdoers.d/*`, to decide
whether or not the user and key are allowed to execute the command. The
requested command is only executed if it is allowed by the configuration.

This makes it possible to use a single authorized key for any number of
commands and still prevent its use for any other purpose.

You will need to identify which commands need to be allowed by each user and
authorized key. To make this easy, *sshdo* can be put into *training* mode
where it will allow (and log) the execution of all commands.

After some time, *sshdo* can then *learn* from the logs and create the
configuration necessary to allow the commands that were encountered during
training mode.

It can also *unlearn* occasionally and create a new configuration that will
no longer allow commands that no longer appear to be in use. This can help
to maintain strict least privilege.

# FROM

    URL: https://raf.org/sshdo
    GIT: https://github.com/raforg/sshdo
    GIT: https://codeberg.org/raforg/sshdo
    Date: 20230619
    Author: raf <raf@raf.org>