InterSystems IRIS Data Platform 2019.2  /  Using Internet Utility Classes

Using Internet Utility Classes
Using SSH
Previous section           Next section
InterSystems: The power behind what matters   

The %Net.SSH package provides support for SSH (Secure Shell) communications. This chapter briefly introduces the classes in this package.
Creating an SSH Session
%Net.SSH.Session represents an SSH session. To use this class:
  1. Create an instance of the class.
  2. Use the Connect() instance method to connect to a server.
  3. Use either AuthenticateWithKeyPair() or AuthenticateWithUsername() to authenticate yourself to the server. For details, see the class reference for %Net.SSH.Session.
  4. Use additional methods of %Net.SSH.Session to perform SCP (Secure Copy) operations of single files to and from the remote system, execute remote commands, tunnel TCP traffic, or perform SFTP operations. See the class reference for %Net.SSH.Session.
    For example, use OpenSFTP to use the session for SFTP operations. This method returns, by reference, an instance of %Net.SSH.SFTP that you can use for SFTP operations. See the example in the next section.
For information on the supported platforms where you can use these classes, see the class reference for %Net.SSH.Session and %Net.SSH.SFTP.
Example: Listing Files via SFTP
The following method shows how you can write a list of the files on a server, via SFTP:
Method SFTPDir(ftpserver, username, password) As %Status
    set ssh = ##class(%Net.SSH.Session).%New()
    do ssh.Connect(ftpserver)
    do ssh.AuthenticateWithUsername(username,password)
    //open an SFTP session and get that returned by reference
    do ssh.OpenSFTP(.sftp)
    //get a list of files
    do sftp.Dir(".",.files)
    set i=$ORDER(files(""))
    while i'="" {
        write $listget(files(i),1),!
        set i=$ORDER(files(i))
    quit $$$OK
Additional Examples
For additional SSH examples, open %Net.SSH.Session in Studio and see the TestExecute() and TestForwardPort() methods of this class.

Previous section           Next section
Send us comments on this page
View this book as PDF   |  Download all PDFs
Copyright © 1997-2019 InterSystems Corporation, Cambridge, MA
Content Date/Time: 2019-09-18 06:45:48