kisscommunity

kisscommunity.bvnf.space site sources
git clone git://bvnf.space/home/kiss/kisscommunity.git
Log | Files | Refs | Submodules | README | LICENSE

index.txt (7363B)


      1
      2
      3
      4
      5
      6
      7
      8
      9
     10
     11
     12
     13
     14
     15
     16
     17
     18
     19
     20
     21
     22
     23
     24
     25
     26
     27
     28
     29
     30
     31
     32
     33
     34
     35
     36
     37
     38
     39
     40
     41
     42
     43
     44
     45
     46
     47
     48
     49
     50
     51
     52
     53
     54
     55
     56
     57
     58
     59
     60
     61
     62
     63
     64
     65
     66
     67
     68
     69
     70
     71
     72
     73
     74
     75
     76
     77
     78
     79
     80
     81
     82
     83
     84
     85
     86
     87
     88
     89
     90
     91
     92
     93
     94
     95
     96
     97
     98
     99
    100
    101
    102
    103
    104
    105
    106
    107
    108
    109
    110
    111
    112
    113
    114
    115
    116
    117
    118
    119
    120
    121
    122
    123
    124
    125
    126
    127
    128
    129
    130
    131
    132
    133
    134
    135
    136
    137
    138
    139
    140
    141
OPENSSH [0]
________________________________________________________________________________

OpenSSH (also known as OpenBSD Secure Shell) is a suite of secure networking
utilities based on the Secure Shell (SSH) protocol, which provides a secure 
channel over an unsecured network in a client-server architecture.


Remote Server Configuration
________________________________________________________________________________

Begin by first verifying that you have openssh installed on the remote server:

+------------------------------------------------------------------------------+
|                                                                              |
|   $ kiss b openssh && kiss i openssh                                         |
|                                                                              |
+------------------------------------------------------------------------------+

Using busybox's runsv, create a new managed service for the ssh daemon:

+------------------------------------------------------------------------------+
|                                                                              |
|   $ ln -s /etc/sv/sshd /var/service                                          |
|                                                                              |
+------------------------------------------------------------------------------+

At this point, you can either restart the remote server or manually start the 
SSH daemon:

+------------------------------------------------------------------------------+
|                                                                              |
|   $ sv up sshd                                                               |
|                                                                              |
+------------------------------------------------------------------------------+


Client Authentication
________________________________________________________________________________

From an SSH client, use the following command to connect to the remote SSH 
server:

+------------------------------------------------------------------------------+
|                                                                              |
|   $ ssh USERNAME@SERVER                                                      |
|                                                                              |
+------------------------------------------------------------------------------+

Replace USERNAME with the name of a regular user and SERVER with the hostname or 
IP address of the SSH remote server. Upon pressing return, you will also be
prompted to enter the password of the regular user specified.


Passwordless Authentication (Optional)
________________________________________________________________________________

Passwordless login to a remove server can be achieved by creating a key pair. 
From the SSH client, use the following command to generate the key:

+------------------------------------------------------------------------------+
|                                                                              |
|   $ ssh-keygen -t rsa                                                        |
|                                                                              |
+------------------------------------------------------------------------------+

Copy the id_rsa.pub file generated from the previous step into the remote 
server's ~/.ssh/authorized_keys with the following command:

+------------------------------------------------------------------------------+
|                                                                              |
|   $ ssh-copy-id USERNAME@SERVER                                              |
|                                                                              |
+------------------------------------------------------------------------------+

Replace USERNAME with the name of a regular user and SERVER with the hostname or 
IP address of the SSH remote server. Upon pressing return, you will also be
prompted to enter the password of the regular user specified.

Verify that the key was copied to the remote server and passwordless login works
by entering the following command from the previous section:

+------------------------------------------------------------------------------+
|                                                                              |
|   $ ssh USERNAME@SERVER                                                      |
|                                                                              |
+------------------------------------------------------------------------------+

Once passwordless login has been verified, disable password authentication on
the remote server:

+------------------------------------------------------------------------------+
|                                                                              |
|   $ echo "PasswordAuthentication no" >> /etc/ssh/sshd_config                 |
|                                                                              |
+------------------------------------------------------------------------------+


Tips and Tricks
________________________________________________________________________________

* When connecting to an SSH server, there are three different levels of debug
  modes that can help with troubleshooting issues. Use the "-v" switch when
  connecting to print the debugging messages:

+------------------------------------------------------------------------------+
|                                                                              |
|   $ ssh USERNAME@SERVER -v                                                   |
|   $ ssh USERNAME@SERVER -vv                                                  |
|   $ ssh USERNAME@SERVER -vvv                                                 |
|                                                                              |
+------------------------------------------------------------------------------+

* If you are looking to forward GUI-based applications through an SSH tunnel,
  refer to the #/wiki/xorg/x11-forwarding article.


troubleshooting
________________________________________________________________________________

* you can fix errors such as this one

+------------------------------------------------------------------------------+
|                                                                              |
|  top error: Error opening terminal: xterm-256color                           |
|                                                                              |
+------------------------------------------------------------------------------+

By running this command in your ssh session

+------------------------------------------------------------------------------+
|                                                                              |
|  $ export TERM=xterm                                                         |
|                                                                              |
+------------------------------------------------------------------------------+

References
________________________________________________________________________________

[0] https://www.openssh.com/openbsd.html
[1] https://wiki.gentoo.org/wiki/SSH