This is an automated email from the ASF dual-hosted git repository.
gnodet pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/mina-site.git
The following commit(s) were added to refs/heads/master by this push:
new 13508bf Update SSHD site for 2.5.0 release and point to the correct
location for various outdated docs
13508bf is described below
commit 13508bf299da69cac3d42741f9809c591e5b34c8
Author: Guillaume Nodet <gno...@gmail.com>
AuthorDate: Mon Jun 22 17:28:16 2020 +0200
Update SSHD site for 2.5.0 release and point to the correct location for
various outdated docs
---
source/downloads-sshd.md | 11 +++--
source/sshd-project/__index.md | 2 +
source/sshd-project/configuring_security.md | 36 --------------
source/sshd-project/documentation.md | 13 +----
source/sshd-project/download_2.4.0.md | 22 +++++++++
source/sshd-project/downloads.md | 11 +++--
source/sshd-project/embedding_ssh.md | 73 +---------------------------
source/sshd-project/faq.md | 2 +-
source/sshd-project/features.md | 2 +-
source/sshd-project/load_ssh_editor.md | 23 ---------
source/sshd-project/required_dependencies.md | 15 ------
source/sshd-project/sources.md | 2 +-
source/sshd-project/tips.md | 24 ---------
13 files changed, 41 insertions(+), 195 deletions(-)
diff --git a/source/downloads-sshd.md b/source/downloads-sshd.md
index 8b76fac..ad132ed 100644
--- a/source/downloads-sshd.md
+++ b/source/downloads-sshd.md
@@ -4,14 +4,14 @@ title: Downloads
# Latest SSHD Releases
-The latest release is the SSHD 2.4.0 release.
+The latest release is the SSHD 2.5.0 release.
* Source distributions:
- * [Apache Mina SSHD 2.4.0 Sources
(.tar.gz)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.4.0/apache-sshd-2.4.0-src.tar.gz)
[PGP](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.tar.gz.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.tar.gz.sha1)
- * [Apache Mina SSHD 2.4.0 Sources
(.zip)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.4.0/apache-sshd-2.4.0-src.zip)
[PGP](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.zip.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.zip.sha1)
+ * [Apache Mina SSHD 2.5.0 Sources
(.tar.gz)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.5.0/apache-sshd-2.5.0-src.tar.gz)
[PGP](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0-src.tar.gz.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0-src.tar.gz.sha1)
+ * [Apache Mina SSHD 2.5.0 Sources
(.zip)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.5.0/apache-sshd-2.5.0-src.zip)
[PGP](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0-src.zip.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0-src.zip.sha1)
* Binary distributions:
- * [Apache Mina SSHD 2.4.0 Binary
(.tar.gz)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.4.0/dist/apache-sshd-2.4.0.tar.gz)
[PGP](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.tar.gz.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.tar.gz.sha1)
- * [Apache Mina SSHD 2.4.0 Binary
(.zip)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.4.0/dist/apache-sshd-2.4.0.zip)
[PGP](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.zip.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.zip.sha1)
+ * [Apache Mina SSHD 2.5.0 Binary
(.tar.gz)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.5.0/dist/apache-sshd-2.5.0.tar.gz)
[PGP](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0.tar.gz.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0.tar.gz.sha1)
+ * [Apache Mina SSHD 2.5.0 Binary
(.zip)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.5.0/dist/apache-sshd-2.5.0.zip)
[PGP](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0.zip.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0.zip.sha1)
# Development snapshots
@@ -46,3 +46,4 @@ You can [build](sshd-project/building.html) the latest
version from [sources](ss
* [SSHD 2.1.0](sshd-project/download_2.1.0.html)
* [SSHD 2.2.0](sshd-project/download_2.2.0.html)
* [SSHD 2.3.0](sshd-project/download_2.3.0.html)
+* [SSHD 2.4.0](sshd-project/download_2.4.0.html)
diff --git a/source/sshd-project/__index.md b/source/sshd-project/__index.md
index 06279e6..b4a211b 100644
--- a/source/sshd-project/__index.md
+++ b/source/sshd-project/__index.md
@@ -10,3 +10,5 @@ Apache SSHD is a 100% pure java library to support the SSH
protocols on both the
This library is based on [Apache MINA](http://mina.apache.org/), a scalable
and high performance asynchronous IO library.
SSHD does not really aim at being a replacement for the SSH client or SSH
server from Unix operating systems, but rather provides support for Java based
applications requiring SSH support.
+
+The technical documentation is maintained in the [source
tree](https://github.com/apache/mina-sshd).
diff --git a/source/sshd-project/configuring_security.md
b/source/sshd-project/configuring_security.md
deleted file mode 100644
index dddd12f..0000000
--- a/source/sshd-project/configuring_security.md
+++ /dev/null
@@ -1,36 +0,0 @@
----
-type: sshd
-title: SSHD Configuring Security
----
-
-## Configuring Security
-
-The SSHD server needs to be integrated and the security layer has to be
customized to suit your needs.
-This layer is pluggable and use the following interfaces:
-
-*
[PasswordAuthenticator](http://svn.apache.org/repos/asf/mina/sshd/trunk/sshd-core/src/main/java/org/apache/sshd/server/PasswordAuthenticator.java)
for password based authentication
-*
[PublickeyAuthenticator](http://svn.apache.org/repos/asf/mina/sshd/trunk/sshd-core/src/main/java/org/apache/sshd/server/PublickeyAuthenticator.java)
for key based authentication
-
-Those custom classes can be configured on the SSHD server using the following
code:
-
-```java
-SshServer sshd = SshServer.setUpDefaultServer();
-sshd.setPasswordAuthenticator(new MyPasswordAuthenticator());
-sshd.setPublickeyAuthenticator(new MyPublickeyAuthenticator());
-```
-
-If only one of those class is implemented, only the related authentication
mechanism will be enabled.
-
-## JAAS integration
-
-SSHD provides a password based authentication that delegates to JAAS.
-This can be configured in the following way:
-
-```java
-SshServer sshd = SshServer.setUpDefaultServer();
-JaasPasswordAuthenticator pswdAuth = new JaasPasswordAuthenticator();
-pswdAuth.setDomain("myJaasDomain");
-sshd.setPasswordAuthenticator(pswdAuth);
-```
-
-The domain name must be set to the JAAS domain that will be used for
authentication.
diff --git a/source/sshd-project/documentation.md
b/source/sshd-project/documentation.md
index eefc855..63e6d80 100644
--- a/source/sshd-project/documentation.md
+++ b/source/sshd-project/documentation.md
@@ -5,15 +5,4 @@ title: SSHD Documentation
# Apache SSHD documentation
-## Resources
-
-* [API JavaDocs](apidocs/index.html)
-
-## Tutorials
-
-* [Configuring security](configuring_security.html)
-* [Embedding SSHD in 5 minutes](embedding_ssh.html)
-* [Loading SSHD in Eclipse or IDEA](load_ssh_editor.html)
-* [Required dependencies](required_dependencies.html)
-* [Tips](tips.html)
-
+See https://github.com/apache/mina-sshd for more informations.
diff --git a/source/sshd-project/download_2.4.0.md
b/source/sshd-project/download_2.4.0.md
new file mode 100644
index 0000000..da8c0d8
--- /dev/null
+++ b/source/sshd-project/download_2.4.0.md
@@ -0,0 +1,22 @@
+---
+type: sshd
+title: Apache SSHD 2.4.0 Release
+---
+
+# Overview
+
+Apache Mina SSHD 2.4.0 contains a number of [enhancements and
bug-fixes](https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310849&version=12347242).
+
+# Getting the Distributions
+
+* Source distributions:
+ * [Apache Mina SSHD 2.4.0 Sources
(.tar.gz)](https://archive.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.tar.gz)
[PGP](https://archive.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.tar.gz.asc)
[SHA](https://archive.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.tar.gz.sha1)
+ * [Apache Mina SSHD 2.4.0 Sources
(.zip)](https://archive.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.zip)
[PGP](https://archive.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.zip.asc)
[SHA](https://archive.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.zip.sha1)
+* Binary distributions:
+ * [Apache Mina SSHD 2.4.0 Binary
(.tar.gz)](https://archive.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.tar.gz)
[PGP](https://archive.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.tar.gz.asc)
[SHA](https://archive.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.tar.gz.sha1)
+ * [Apache Mina SSHD 2.4.0 Binary
(.zip)](https://archive.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.zip)
[PGP](https://archive.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.zip.asc)
[SHA](https://archive.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.zip.sha1)
+
+# Release Notes
+
+Apache Mina SSHD 2.4.0 contains a few enhancements and bug-fixes.
+Please report any feedback to
[us...@mina.apache.org](mailto:us...@mina.apache.org).
diff --git a/source/sshd-project/downloads.md b/source/sshd-project/downloads.md
index a33f981..f01a6ed 100644
--- a/source/sshd-project/downloads.md
+++ b/source/sshd-project/downloads.md
@@ -5,14 +5,14 @@ title: SSHD Downloads
# Latest SSHD Releases
-The latest release is the SSHD 2.4.0 release.
+The latest release is the SSHD 2.5.0 release.
* Source distributions:
- * [Apache Mina SSHD 2.4.0 Sources
(.tar.gz)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.4.0/apache-sshd-2.4.0-src.tar.gz)
[PGP](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.tar.gz.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.tar.gz.sha1)
- * [Apache Mina SSHD 2.4.0 Sources
(.zip)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.4.0/apache-sshd-2.4.0-src.zip)
[PGP](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.zip.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0-src.zip.sha1)
+ * [Apache Mina SSHD 2.5.0 Sources
(.tar.gz)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.5.0/apache-sshd-2.5.0-src.tar.gz)
[PGP](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0-src.tar.gz.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0-src.tar.gz.sha1)
+ * [Apache Mina SSHD 2.5.0 Sources
(.zip)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.5.0/apache-sshd-2.5.0-src.zip)
[PGP](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0-src.zip.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0-src.zip.sha1)
* Binary distributions:
- * [Apache Mina SSHD 2.4.0 Binary
(.tar.gz)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.4.0/apache-sshd-2.4.0.tar.gz)
[PGP](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.tar.gz.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.tar.gz.sha1)
- * [Apache Mina SSHD 2.4.0 Binary
(.zip)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.4.0/apache-sshd-2.4.0.zip)
[PGP](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.zip.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.4.0/apache-sshd-2.4.0.zip.sha1)
+ * [Apache Mina SSHD 2.5.0 Binary
(.tar.gz)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.5.0/apache-sshd-2.5.0.tar.gz)
[PGP](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0.tar.gz.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0.tar.gz.sha1)
+ * [Apache Mina SSHD 2.5.0 Binary
(.zip)](https://www.apache.org/dyn/closer.lua/mina/sshd/2.5.0/apache-sshd-2.5.0.zip)
[PGP](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0.zip.asc)
[SHA](https://www.apache.org/dist/mina/sshd/2.5.0/apache-sshd-2.5.0.zip.sha1)
# Development snapshots
@@ -47,3 +47,4 @@ You can [build](building.html) the latest version from
[sources](sources.html).
* [SSHD 2.1.0](download_2.1.0.html)
* [SSHD 2.2.0](download_2.2.0.html)
* [SSHD 2.3.0](download_2.3.0.html)
+* [SSHD 2.4.0](download_2.4.0.html)
diff --git a/source/sshd-project/embedding_ssh.md
b/source/sshd-project/embedding_ssh.md
index f23be20..27cfc83 100644
--- a/source/sshd-project/embedding_ssh.md
+++ b/source/sshd-project/embedding_ssh.md
@@ -5,75 +5,4 @@ title: Embedding SSHD in 5 minutes
# Embedding SSHD in 5 minutes
-SSHD is designed to be easily embedded in your application as an SSH server.
SSH Server needs to be configured before it can be started. Essentially, there
are three steps for creating the Server
-
-* Create an instance of SshServer class
-* Configure the Server
-* Start the Server
-
-Lets look at all these steps. Refer to this class for details
[SshServer.java](http://svn.apache.org/viewvc/mina/sshd/trunk/sshd-core/src/main/java/org/apache/sshd/SshServer.java?view=markup)
-
-## Creating an instance of SshServer
-
-This is as simple as creating a new object
-
-```java
-SshServer sshd = SshServer.setUpDefaultServer();
-```
-
-It will configure the server with sensible defaults for ciphers, macs, key
exchange algorithm, etc...
-If you want a different behavior, you can look at the code of the
setUpDefaultServer method and configure the SSH server the way you need.
-
-## Configuring the Server
-
-There are a few things that needs to be configured on the server before being
able to actually use it:
-
-### Port
-
-```java
-sshd.setPort(22);
-```
-
-### KeyPairProvider
-
-```java
-sshd.setKeyPairProvider(new SimpleGeneratorHostKeyProvider("hostkey.ser"));
-```
-
-It's usually a good idea to give the host key generator a path, so that if you
restart the SSHD server, the same key will be used to authenticate the server.
-
-### ShellFactory
-
-That's the part you will usually have to write to customize the SSHD server.
The shell factory will be used to create a new shell each time a user logs in.
SSHD provides a single implementation that you can use if you want. This
implementation will create a process and delegate everything to it, so it's
mostly useful to launch the OS native shell.
-
-```java
-sshd.setShellFactory(new ProcessShellFactory(new String[] { "/bin/sh", "-i",
"-l" }));
-```
-
-Note that the ShellFactory is not required. If none is configured, any request
for a shell will be denied to users.
-
-### CommandFactory
-
-The CommandFactory can be used in addition to the ShellFactory (it can also be
used instead of the ShellFactory). The CommandFactory is used when direct
commands are sent to the SSH server, as this is the case when running __ssh
localhost shutdown__ or __scp xxx__
-
-SSHD provides a CommandFactory to support SCP that can be configure in the
following way:
-
-```java
-sshd.setCommandFactory(new ScpCommandFactory());
-```
-
-You can also use the ScpCommandFactory on top of your own CommandFactory:
-
-```java
-sshd.setCommandFactory(new ScpCommandFactory(myCommandFactory));
-```
-
-Note that the CommandFactory is optional. If none is configured, any direct
command sent by users will be rejected.
-
-## Start the Server
-
-Once we have configured the Server, we need to call start(), to start the
Server
-
-```java
-sshd.start();
-```
+See https://github.com/apache/mina-sshd for more informations.
diff --git a/source/sshd-project/faq.md b/source/sshd-project/faq.md
index 1c17d55..db16aaa 100644
--- a/source/sshd-project/faq.md
+++ b/source/sshd-project/faq.md
@@ -5,4 +5,4 @@ title: SSHD FAQ
# FAQ
-TODO
+See https://github.com/apache/mina-sshd for more informations.
diff --git a/source/sshd-project/features.md b/source/sshd-project/features.md
index 52ca78a..4b118fb 100644
--- a/source/sshd-project/features.md
+++ b/source/sshd-project/features.md
@@ -5,4 +5,4 @@ title: SSHD Features
# Features
-TODO
+The list of features implemented by Mina SSHD is available at
https://github.com/apache/mina-sshd.
diff --git a/source/sshd-project/load_ssh_editor.md
b/source/sshd-project/load_ssh_editor.md
deleted file mode 100644
index 9321933..0000000
--- a/source/sshd-project/load_ssh_editor.md
+++ /dev/null
@@ -1,23 +0,0 @@
----
-type: sshd
-title: Loading SSHD in Eclipse or IDEA
----
-
-# Loading SSHD in Eclipse or IDEA
-
-If you want to debug or develop on SSHD, chances are you want to load it in
your IDE. Most IDE now have some maven support (either natively or through
plugins), but if you don't have those plugins installed, you can create the
required project files using one of the following command:
-
- mvn eclipse:eclipse
-
-or
-
- mvn idea:idea
-
-If you want to have the source code for the various dependencies available for
debugging, you can add the -DdownloadSources=true parameter on the command line.
-
-Next step is to load the generated project from Eclipse or IDEA.
-
-Note that you may have to set up some global variables to point to the local
maven repository.
-
-
-
diff --git a/source/sshd-project/required_dependencies.md
b/source/sshd-project/required_dependencies.md
deleted file mode 100644
index f1db6ff..0000000
--- a/source/sshd-project/required_dependencies.md
+++ /dev/null
@@ -1,15 +0,0 @@
----
-type: sshd
-title: SSHD Required dependencies
----
-
-# Required dependencies
-
-SSHD has 2 compile-time dependencies:
-
-* [MINA Core
2.0.x](http://repo1.maven.org/maven2/org/apache/mina/mina-core/2.0.7/mina-core-2.0.7.jar)
:
http://repo1.maven.org/maven2/org/apache/mina/mina-core/2.0.7/mina-core-2.0.7.jar
-* [SLF4J API
1.6.4](http://repo2.maven.org/maven2/org/slf4j/slf4j-api/1.6.4/slf4j-api-1.6.4.jar)
: http://repo2.maven.org/maven2/org/slf4j/slf4j-api/1.6.4/slf4j-api-1.6.4.jar
-
-Note that since SSHD 0.9.0, the Mina Core library is optional when running in
JDK 1.7 and SSHD will default to using nio2 if available.
-
-To be able to run SSHD, you will also need one SLF4J Logger implementation.
The simplest one is the one using java.util.logging underneath which can be
downloaded at
<http://repo2.maven.org/maven2/org/slf4j/slf4j-jdk14/1.6.4/slf4j-jdk14-1.6.4.jar>
diff --git a/source/sshd-project/sources.md b/source/sshd-project/sources.md
index a807464..f1355e8 100644
--- a/source/sshd-project/sources.md
+++ b/source/sshd-project/sources.md
@@ -32,4 +32,4 @@ You will not be able to commit into the project if you are
not a committer.
# Documentation
The Website documentation is published via Apache SVN pubsub. The website
source resides at
-[https://svn.apache.org/repos/asf/mina/site/trunk/content/sshd-project/](https://svn.apache.org/repos/asf/mina/site/trunk/content/sshd-project/)
+[https://github.com/apache/mina-site/](https://github.com/apache/mina-site/)
diff --git a/source/sshd-project/tips.md b/source/sshd-project/tips.md
deleted file mode 100644
index 80fb616..0000000
--- a/source/sshd-project/tips.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-type: sshd
-title: SSHD Tips
----
-
-# How to execute commands as processes on the server side?
-
-If you want the SSH server to support direct command execution, you need to
configure it with a Factory<Command> which will allow that.
-
-It can be done using the following code:
-
-```java
-sshd.setCommandFactory(new ScpCommandFactory(new CommandFactory() {
- public Command createCommand(String command) {
- return new ProcessShellFactory(command.split(<SPAN
class="code-quote">" ")).create();
- }
-}));
-```
-
-This way, you can use the following:
-
-```bash
-ssh -p 8202 localhost ls -l
-```
