Форк JSch-0.1.55

См. оригинальный README

Почему стоит использовать эту библиотеку?

Как я объяснил в записи в блоге, основные причины таковы:

• OpenSSH по умолчанию отключил ssh-rsa в релизе 8.8, и вам нужна библиотека, поддерживающая rsa-sha2-256 и rsa-sha2-512.
• Замена без изменений кода: просто поменяйте координаты зависимости — и всё готово.
• JSch на SourceForge больше активно не поддерживается.
• Остаётся в синхронизации с возможностями OpenJDK, поэтому нет необходимости в дополнительных зависимостях.

Есть ли какая-либо документация?

Немного. Посмотрите примеры кода в папке examples. Также есть несколько вики-страниц, например Jsch-Configuration и Jsch-Logging.

Версионирование

Вплоть до 0.2.26 версионирование следовало оригинальной схеме jsch; начиная с 2.27.0 мы перешли на семантическое версионирование, что говорит о стабильности API библиотеки и её использовании в продакшене.

Как использовать эту библиотеку в качестве замены com.jcraft:jsch

Убедитесь, что в вашем classpath только одна зависимость jsch. Например, можно проверить вывод mvn dependency:tree.

замена прямой maven-зависимости

замените

<dependency>
    <groupId>com.jcraft</groupId>
    <artifactId>jsch</artifactId>
    <version>0.1.55</version>
</dependency>

на

<dependency>
  <groupId>com.github.mwiede</groupId>
  <artifactId>jsch</artifactId>
  <version>2.28.0</version>
</dependency>

замена jsch как транзитивной maven-зависимости

Если у вас есть артефакт foo:bar, содержащий com.jcraft:jsch как транзитивную зависимость, вам нужно добавить com.github.mwiede:jsch как ещё одну зависимость и исключить зависимость jcraft:

<dependency>
  <groupId>com.github.mwiede</groupId>
  <artifactId>jsch</artifactId>
  <version>2.28.0</version>
</dependency>
<dependency>
  <groupId>foo</groupId>
  <artifactId>bar</artifactId>
  <exclusions>
        <exclusion>  
          <groupId>com.jcraft</groupId>
          <artifactId>jsch</artifactId>
        </exclusion>
      </exclusions> 
</dependency>

Дополнение: вы также можете исключить любую из зависимостей com.jcraft:jsch.agentproxy.jsch, com.jcraft:jsch.agentproxy.core или com.jcraft:jsch.agentproxy.pageant, поскольку эти модули были интегрированы в этот форк (см. примечания к релизу 0.1.66).