SSH Wrapper

The SSH Wrapper is a tool that is used and accessed through the Extractors-Api and was developed to run commands in remote machines through SSH and capture their output. The SSH Wrapper was introduced in Timbus development to primarily address two situations:

  • Introduce an extra layer of security in the extraction process of businesses that contain sensitive information – In this case, a local extraction's output can be saved into a file in a machine and posteriorly access its content remotely through this module.
  • As the Context is being acquired through Extractors-Api (which might contain information captured from several extractors), all consequent processing of this information is performed from it. The SSH Wrapper allows to insert context acquired from any independent module which might be even developed in various programming languages.

 

Creator:
Caixa Magica Software

License:
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Find at opensourceprojects.eu
https://opensourceprojects.eu/p/timbus/context-population/extractors/wrapper-ssh

Go to the SSH Wrapper's page on opensourceprojects.eu for more details about requirements, interaction and source code by following the link above.

 

 

How to Install the SSH Wrapper

Requirements: Tools:

Git – Git is a distributed revision control and source code management (SCM) system with an emphasis on speed, data integrity, and support for distributed, non-linear workflows. In Timbus project, git is therefore utilized to facilitate distributed development and cooperation between partners. All tools are available inwww.opensourceprojects.eu website. To get this particular tool, once having Git installed run the following in the command line: git clone https://opensourceprojects.eu/git/p/timbus/context-population/extractors/wrapper-ssh It will save the project in a new folder.

Java 1.7 or over – A simple tutorial on how to install the required java on different platforms is available in https://opensourceprojects.eu/p/timbus/wiki/How%20to%20install%3A%20Java/ - Maven - Apache Maven is a software project management and comprehension tool. Based on the concept of a project object model (POM), Maven can manage a project's build, reporting and documentation from a central piece of information. It is used to manage all dependencies and build of the project. Besides fetching all required dependencies during build, it allows a fine-grain control over the whole build process.

Artifacts: - Maven pom parents: osgi (2-beta-4) and core (2-beta-3) – As various projects within Timbus utilize common dependencies and have similar build behaviour, a series of maven parents were created to facilitate the creation of new tools – Declaring a pom parent in the main project pom file states that the current project extends its parent and, therefore, follows its behaviour . However, it is possible tooverride certain build options in order to adapt the parent to the context of the tool being developed. As any other tool or artifact in Timbus, the parent is stored in opensourceprojects repository and can be fetched by running the following command: git clone https://opensourceprojects.eu/git/p/timbus/support/maven-parents timbus-support-maven-parents - Extractors-core (currently version 0.0.3-RELEASE) – This module sets the behaviour for all remote extractors in TIMBUS and it's necessary to invoke this artifact within Virgo environment (for more detail, see description of this tool). You can get it by running the command: git clone https://opensourceprojects.eu/git/p/timbus/context-population/extractors-core The project does have other dependencies, however all of them are fetched automatically from remote repositories during the build process. Step-by-step compilation

Once all requirements are met, the following steps are necessary to properly compile the project: - Install the maven parent in the local maven repository. All other project dependencies are available in remote accessible repositories, but the parent has to be installed so that maven is able to find it when compiling:

  • Go to timbus-support-maven-parents/core
  • Run “mvn install”. This command will recognize the pom.xml file in the folder and install it properly on the local repository.
  • Go to timbus-support-maven-parents/osgi and perform the same command. - Install the extractors-core artifact dependency in your local repository. For this, go to the root directory of the previously fetched project and run “mvn install”.
  • Go to the SSH Wrapper project's main folder, and run “mvn clean package” - This command will build the project appropriately and place it in a “target” folder. The [clean] option replaces the “target” folder if there is already any. If everything was successful, the compiled .jar file can now be found in the “target” folder.

Back to Context Population Framework