Fork de JSch-0.1.55

Voir le README original

Pourquoi devriez-vous utiliser cette bibliothèque ?

Comme je l'ai expliqué dans un article de blog, les principaux points sont :

• OpenSSH a désactivé ssh-rsa par défaut dans la version 8.8 et vous avez besoin d'une bibliothèque qui prend en charge rsa-sha2-256 et rsa-sha2-512.
• Remplacement direct : il suffit de changer les coordonnées de la dépendance et vous êtes prêt.
• Plus de maintenance active de JSch sur SourceForge.
• Rester en phase avec les fonctionnalités d'OpenJDK afin qu'aucune dépendance supplémentaire ne soit nécessaire.

Y a-t-il une documentation ?

Pas beaucoup. Consultez le code d'exemple dans le dossier examples. Et il existe quelques pages wiki, par exemple Jsch-Configuration et Jsch-Logging.

Gestion des versions

Jusqu'à 0.2.26, la gestion des versions suivait le schéma du jsch d'origine ; à partir de 2.27.0, nous sommes passés au versionnement sémantique, indiquant que l'API de la bibliothèque est stable et utilisée en production.

Comment utiliser cette bibliothèque en remplacement de com.jcraft:jsch

Assurez-vous de n'avoir qu'une seule dépendance jsch sur votre classpath. Par exemple, vous pouvez vérifier la sortie de mvn dependency:tree.

en remplaçant une dépendance Maven directe

remplacez

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

par

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

en remplaçant jsch comme dépendance Maven transitive

Lorsque vous avez un artefact foo:bar, qui contient com.jcraft:jsch comme dépendance transitive, vous devez ajouter com.github.mwiede:jsch comme autre dépendance et exclure celle de 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>

Ajout : Vous pouvez également exclure com.jcraft:jsch.agentproxy.jsch, com.jcraft:jsch.agentproxy.core ou com.jcraft:jsch.agentproxy.pageant, car ces modules ont été intégrés dans ce fork (voir les notes de version de 0.1.66).