SSH2 for the Amiga

   Author:       s.franke at bebbosoft.de
   Uploader:     s franke bebbosoft de
   Type:         comm/net
   Version:      1.21
   Architecture: m68k-amigaos
   Required:     bsdsocket.library (e.g AmiTCP)
   Date:         2024-06-01
   Readme:       http://aminet.net/comm/net/amigassh.readme
   Downloads:    2495

http://aminet.net/comm/net/amigassh.lha

===============================================================================

NAME

amigassh

SSH2 for the Amiga, 68000+. Needs a server that supports the used crypto stuff.

It will work on an unaccelerated Amiga but establishing the connection takes

about one minute.

An A3000 will

create an X25519 key pair in 2s
verify/verify a signature in ~5s

NOTE that this is *NOT* feature complete.

If you want more features: Support me.

If you want to see the code on github.com: Support me more^^

===============

amigassh

===============

USAGE: amigassh [options] [user at ]host[:port] [command [args]]

-? display this help

-p <port> define a port

-T don't allocate a pseudo terminal

-v <n> set verbosity, 0 = OFF, 7 = TRACE

<command> command to run instead of shell

Open a shell on the host using your console colors and mouse.

Or execute a command via SSH2.

===============

amigasshd

===============

Create the folder ENVARC:ssh
Copy the file sshd_config to ENVARC:ssh
Edit the file ENVARC:ssh/sshd_config at your needs
Create an unencrypted key file and name it as in ENVARC:ssh/sshd_config

* e.g. ENVARC:ssh/ssh_host_ed25519_key

Create and edit the file ENVARC:ssh/passwd

* create entries with

username password

* the passwords are getting hashed on first user logon

Start amigasshd to accept remote SSH2 connections.

A simple terminal emulation is provided. (Works now for some stuff on

ApolloOS)

You may also use sftp copy files from/to the Amiga. (This should work on

ApolloOS too)

===============

amigasshkeygen

===============

USAGE: amigasshkeygen [-f <output_keyfile>]

-? display this help

Create ed25519 key files.

===============================================================================

SUPPORT ME

If you want more features implemented: Support me!

Support me via PayPal: https://t.ly/N8WkB

also small monthly donations do help :-)

Thanks to all supporters!

It financed me an one year subscription of the Amiga Future magazine.

===============================================================================

TESTING

Many thanks to all testers, especially to

Patrik Axelsson
Javier de las Rivas

===============================================================================

ed/curve25519 code from Public Domain, Authors:

- Daniel J. Bernstein

- Niels Duif

- Tanja Lange

- lead: Peter Schwabe

- Bo-Yin Yang

* optimized, modified to use 16 bit integers

by Stefan "Bebbo" Franke

aes is now a modified fast-aes from Nate Wiger

gcm, sha256, sh512, amigassh itself:

- Stefan "Bebbo" Franke

Written in 2024 by Stefan "Bebbo" Franke <s.franke at bebbosoft>

To the extent possible under law, the author(s) have dedicated all copyright

and related and neighboring rights to this software to the public domain

worldwide. This software is distributed without any warranty.

You should have received a copy of the CC0 Public Domain Dedication along with

this software.

If not, see <https://creativecommons.org/publicdomain/zero/1.0/>.

===============================================================================

DISCLAIMER OF WARRANTY

Software is provided "AS IS," without a warranty of any kind.

You may use it on your own risk.

===============================================================================

LIMITATION OF LIABILITY

I SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY YOU OR ANY THIRD PARTY

AS A RESULT OF USING OR DISTRIBUTING SOFTWARE. IN NO EVENT WILL I BE LIABLE

FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL,

CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS

OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE

SOFTWARE, EVEN IF I HAVE ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

===============================================================================

HISTORY

amigassh V1.21

more AES tuning (that's it)

A3000 ~ 32kB/s

V4SA ~ 630kB/s

remove the missing key file ERROR message
refactored amigassh, and hopefully it still works...

amigassh V1.20

removed some debug output
switched the AES implementation to gain more speed

A3000 ~ 30kB/s

V4SA ~ 580kB/s

create the lib using a .def file to only export used functions/data

amigassh V1.19

add support for the public key authentication to client and server.

Note that only unprotected key files do work with amigassh.

improved AES/GCM encryption speed resulting in higher upload/download rates:

A3000 ~ 20kB/s

V4SA ~ 400kB/s

this twice as fast as before!

amigassh V1.18

fixed an enforcer hit during library unloading
reworked terminal I/O handling:

Normal Amiga applications do work on ApolloOS

Stuff from C:bin/ is still broken. /shrug

amigassh V1.17

added a sftp subsystem to amigasshd: copy files from/to the Amiga.

not available volumes are denied and result into: not found.

An A3000 will copy with ~10kb/s, a Vampire with up to ~180kb/s.

crypto code moved into the library libcryptossh.library:

The libcryptossh.library was built using my new simple library approach

https://franke.ms/amiga/so.wiki

amigassh V1.16

added example ssd_config file
added example passwd
fixed an enforcer hit
now compiled with -regparms
improved some messages and the program return code
ignore unknown shell CHANNEL_REQUESTS

amigassh V1.15

added amigasshd, amigasshkeygen

amigassh V1.14

use all 16 bits of a WORD
enhanced C code with some asm statements
creating a key pair is down to ~15s
verifying the host is down to ~35s

amigassh V1.13

compute the private key before establishing the connection

This increases the chance to establish a connection on slow Amigas

some speed improvements measured with WinUAE cycle exact A500:

* creating a key pair is down to 43,2s!

* verifying the host is down to 2:14,6!

removed CTRL+F
removed using c stdio
add -v switch

amigassh V1.12

fixed some bus errors, now it really runs on 68000
CTRL+F is now used to ***Break
support sending CTRL+A/CTRL+E
better mapping of backspace and delete
stack usage is now below 4000 bytes
added -T switch to run without pseudo terminal

amigassh V1.11

reworked and combined the ed25519 and curve25519 code.

Now 16 bit integers are sufficient!

the resulting program can now be used on a 68000.

amigassh V1.10

fix an enforcer hit (using updated binutils/gcc)

amigassh V1.9

renamed `mono` to `xterm-amiga`. Install it!

Necessary since too many stuff checks for the string `xterm`...

added mouse support
patch the window title, like xterm
suppres right mouse button stuff, also during login

amigassh V1.8

support tooltype CONSOLE
modify __chkabort: use CTRL+E to interrupt amigassh,

CTRL+C is handled only by the host

TERM can be set by an environment variable or define it in the icon
fixed an enforcer hit

amigassh V1.7

fix broken window resize - was filtered too...

amigassh V1.6

add key mappings for CTRL+ALT+CURSOR -> PgUp/Down,Pos1/End
pass CTRL+D and make it work
print preauth banner
support CTRL+S/CTRL+Q
suppress menu messages from KingCON

amigassh V1.5

fix build...
support redirected stdin/stdout

amigassh V1.4

bad version...

amigassh V1.3

amigassh is now pure. set the flag and make it resident!
internal setting of a suitable stack size
verbose error messages
unify ed25519/curve25519 code
properly create ENVARC:.ssh if missing
some terminal improvements

amigassh V1.2

properly exit after logout, no CTRL+D required
mono now supports 8 colors - update that file!
handle key stroke repetition
bind local, needed by roadshow
fix reading after buffer pointer changed

amigassh V1.1

some support for CTRL/ALT,
better cursor keys,
better terminfo `mono`
fix if stdin is a file/pipe

amigassh V1.0

initial version

===============================================================================

SYNOPSIS

amigassh [-p port] [user at ]host[:port]

The port defaults to 22.

The user is read from the environment variable `USER`.

===============================================================================

DESCRIPTION

amigassh is an implementation of SSH2. The supported cryptographic methods are

curve25519-sha256
ssh-ed25519
aes128-gcm at openssh.com
hmac-sha2-256
sha512

Only password based authentication is supported for now.

Install the terminfo `xterm-amiga` on the remote system!

Feel free to improve it!

On many systems you have to copy it as root into `/usr/share/terminfo/x`

Pimp your `.bash_profile` to unset `LANG` since the Amiga doesn't like UTF8...

A convenient way is to add this to `.bash_profile`:

```

if [ "$TERM" == "xterm-amiga" ]; then

unset LANG

```

===============================================================================

RANDOM HINTS

the know hosts are stored in `ENVARC:.ssh/known-hosts`

the random generator is not the best...

It's rand() pimped with time and vpos. Then SHA256 is applied. Good enough?

But who would talk about security on an unprotected system like the Amiga?

preset your username with

set USER=<yourname>

you can do this in `s:shell-startup`

you can start it from the workbench!

Use the icon tooltypes to set

COMMAND a remote command to execute instead of a shell

CONSOLE an Amiga console string (defaults to CON://///AUTO/CLOSE/WAIT)

HOST the host name

PORT the port (defaults to 22)

TERM the terminal emulation (defaults to xterm-amiga)

USER the user name

no console graphics?

install the `xterm-amiga` terminfo!

no console colors?

install the `xterm-amiga` terminfo!

no mouse in mc or other applications?

install the `xterm-amiga` terminfo!

keys not working properly?

install the `xterm-amiga` terminfo!

some key does still not work

try pimping the xterm-amiga terminfo.

use `tic -xsv9 -o. xterm-amiga.src`

console displays trash? text look blank? lines are bogus?

unset the variable `LANG`

scp to amigasshd: closed remote port

ensure you are using the sftp subsystem, on some systems it's the `-s` flag

`scp -s ...`

your remote Amiga is blocking because you accessed a volume that doesn't

exist?

e.g.: list foobar:

Get https://aminet.net/util/boot/Requester.lha and run "Cancel 5" from your

startup-sequence!

public key authentication does not work!?

Check the file ENVARC:.ssh/authorized_keys if your public key is listed there.

Contents of comm/net/amigassh.lha

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 May 31 08:48 amigassh/
-rw-r--r--  1000/1000     2857    7169  39.9% -lh5- dded May 31 08:48 amigassh/COPYING
-rwxr-xr-x  1000/1000    13777   23856  57.8% -lh5- daa8 May 31 08:48 amigassh/amigassh
-rw-r--r--  1000/1000      455     906  50.2% -lh5- 5a43 May 31 08:48 amigassh/amigassh.info
-rw-r--r--  1000/1000     4669   10757  43.4% -lh5- bc97 May 31 08:48 amigassh/amigassh.readme
-rwxr-xr-x  1000/1000    27279   53784  50.7% -lh5- f1eb May 31 08:48 amigassh/amigasshd
-rwxr-xr-x  1000/1000     3878    6112  63.4% -lh5- 73e4 May 31 08:48 amigassh/amigasshkeygen
-rwxr-xr-x  1000/1000    24989   37884  66.0% -lh5- 6455 May 31 08:48 amigassh/libcryptossh.library
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 May 31 08:48 amigassh/template/
-rw-r--r--  1000/1000       32      32 100.0% -lh0- e79e May 31 08:48 amigassh/template/passwd
-rw-r--r--  1000/1000      290     447  64.9% -lh5- ae49 May 31 08:48 amigassh/template/sshd_config
-rw-r--r--  1000/1000      587    1433  41.0% -lh5- 8c0d May 31 08:48 amigassh/xterm-amiga
-rw-r--r--  1000/1000      717    1398  51.3% -lh5- 3bfa May 31 08:48 amigassh/xterm-amiga.src
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        13 files   79530  143778  55.3%            Jun  2 00:58