From a42ccd2d165c4872962b591280198acb77d7a7ca Mon Sep 17 00:00:00 2001
From: Greg Alexander
Date: Sun, 16 Oct 2016 19:12:28 -0400
Subject: [PATCH] update document for single use passwords
---
doc/index.html | 34 ++++++++++++++++++-------------
res/layout/authkeys.xml | 45 -----------------------------------------
2 files changed, 20 insertions(+), 59 deletions(-)
delete mode 100644 res/layout/authkeys.xml
diff --git a/doc/index.html b/doc/index.html
index 2296d0a..40ad1a4 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -12,34 +12,38 @@ pre {
SimpleSSHD is an SSH2 server based on dropbear that supports scp,
sftp, and rsync. It only supports public-key based authentication (no
-password/interactive auth). It does not use root, which means it must
-listen on a port over 1024 (defaults to port 2222).
+password/interactive auth except for bootstrapping). It does not use
+root, which means it must listen on a port over 1024 (defaults to port
+2222).
Quick start
Install SimpleSSHD.
-
Either:
-
-
Go to SimpleSSHD -> Menu (upper right) -> Authorized Keys, and
-either cut and paste an SSH public key or "Fetch" one via HTTP.
-
OR: Make a directory /sdcard/ssh, and put an
-authorized_keys file in that directory.
-
On any computer which will connect to your Android device, set the
-port to 2222. With OpenSSH, this can be done by putting these lines in
+port to 2222. With OpenSSH, this can be done by putting these lines in
~/.ssh/config:
Host myphone
Port 2222
-
Launch SimpleSSHD, and in Settings enable "Start on Boot", and
+
Launch SimpleSSHD, and in Settings enable "Start on Boot", then
manually start it for the first time.
-
You might want to put a .profile in /sdcard/ssh,
-too.
+
Create /sdcard/ssh/authorized_keys
+
Optionally make /sdcard/ssh/.profile
-
Voila! You can use ssh/scp/sftp/rsync to talk to your Android device!
+
If SimpleSSHD does not find a authorized_keys file when a
+client connects, then it generates a single-use password at that time and
+displays it in the console log. So the procedure to login the first time
+is to initiate the ssh connection, then look at the phone and type in the
+password that is on the screen in the SimpleSSHD app. It is recommended
+to use that shell session to install the authorized_keys
+file.
+
+
Once authorized_keys exists, only public key authentication
+is supported. If you screw up your authorized_keys file, use
+the options menu (upper right) -> Reset Keys.
Settings
@@ -107,6 +111,8 @@ commandline.
Change Log
+
2016/10/xx Version 14: Support single-use passwords for
+bootstrapping.
2016/10/16 Version 13: Support foreground service (fewer
stalls with newer Android). Add "Start on Open" mode.
2016/08/08 Version 1.11: Fix stall initializing random number generator.
diff --git a/res/layout/authkeys.xml b/res/layout/authkeys.xml
deleted file mode 100644
index a8d2c5e..0000000
--- a/res/layout/authkeys.xml
+++ /dev/null
@@ -1,45 +0,0 @@
-
-
-
-
-
-
-
-
-