This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
plugins:instantssh [2015/06/06 05:07] nuxwin |
plugins:instantssh [2017/09/04 08:28] (current) theemstra python-magic was missing from list of |
||
---|---|---|---|
Line 2: | Line 2: | ||
<WRAP center round important 60%> | <WRAP center round important 60%> | ||
- | This documentation is for to the latest version available in our plugins store. For an oldest documentation, see the **README** file inside the plugin archive. | + | This documentation is for the latest version available in our plugins store. For an oldest documentation, see the **README** file inside the plugin archive. |
</WRAP> | </WRAP> | ||
===== Introduction ===== | ===== Introduction ===== | ||
- | This plugin allows to give your customers a full or restricted shell. | + | This plugin allows to give your customers a full or restricted shell access. |
A customer to which SSH permissions are given can create SSH users and use them to login on the server. | A customer to which SSH permissions are given can create SSH users and use them to login on the server. | ||
Line 18: | Line 18: | ||
* openSSH server with both, password and key-based authentication support enabled | * openSSH server with both, password and key-based authentication support enabled | ||
- | **Note:** If you want allow only the key-based authentication, you can set the passwordless_authentication | + | <WRAP center round tip 80%> |
- | configuration option to TRUE in the plugin configuration file. | + | If you want allow only the key-based authentication, you can set the **passwordless_authentication** configuration option to **TRUE** in the plugin configuration file. Once you did the needed change, you must not forget to update the plugin list through the plugins management interface, else, the new value will not be taken into account. |
+ | </WRAP> | ||
==== Debian / Ubuntu packages ==== | ==== Debian / Ubuntu packages ==== | ||
Line 31: | Line 33: | ||
* psmisc | * psmisc | ||
* python | * python | ||
+ | * python-magic | ||
* strace | * strace | ||
Line 37: | Line 40: | ||
# aptitude update | # aptitude update | ||
# aptitude install bash build-essential busybox-static flex \ | # aptitude install bash build-essential busybox-static flex \ | ||
- | # libpam-chroot psmisc python strace | + | libpam-chroot psmisc python strace python-magic |
===== Installation ===== | ===== Installation ===== | ||
Line 61: | Line 64: | ||
==== Authentication options ==== | ==== Authentication options ==== | ||
- | Default authentication options are set as follow: no-agent-forwarding,no-port-forwarding,no-X11-forwarding | + | Default authentication options are set as follow; |
+ | |||
+ | no-agent-forwarding,no-port-forwarding,no-X11-forwarding | ||
which in order: | which in order: | ||
Line 69: | Line 74: | ||
* Forbids X11 forwarding | * Forbids X11 forwarding | ||
- | You can override default authentication options by editing the default_ssh_auth_options option which is defined in the plugin configuration file. In that file, you can also restrict the list of authentication options that your customers can add by editing the allowed_ssh_auth_options option. You must note that any authentication option appearing in the the default authentication string must also be specified in the allowed_ssh_auth_options option. | + | You can override default authentication options by editing the **default_ssh_auth_options** option which is defined in the plugin configuration file. In that file, you can also restrict the list of authentication options that your customers can add by editing the **allowed_ssh_auth_options** option. You must note that any authentication option appearing in the the default authentication string must also be specified in the **allowed_ssh_auth_options** option. |
==== Jailed shells ==== | ==== Jailed shells ==== | ||
Line 84: | Line 89: | ||
**Note:** When changing a configuration parameter in the plugin configuration file, do not forget to trigger plugin change by updating the plugin list through the plugin management interface. | **Note:** When changing a configuration parameter in the plugin configuration file, do not forget to trigger plugin change by updating the plugin list through the plugin management interface. | ||
- | |||
- | ===== Translation ===== | ||
- | |||
- | You can translate this plugin through the Transifex Localization Platform at: | ||
- | |||
- | https://www.transifex.com/organization/i-mscp/dashboard/instantssh | ||
===== Troubleshootings ===== | ===== Troubleshootings ===== |