(DataFlex) SCP Download/Upload Binary Files as Encoded Strings

Demonstrates how to upload and download binary files as encoded strings (base64, hex, etc.) using the SCP protocol (Secure Copy Protocol over SSH).

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

Use ChilkatAx-win32.pkg

Procedure Test
    Variant vSsh
    Handle hoSsh
    String sHostname
    Integer iPort
    Boolean iSuccess
    Handle hoScp
    String sRemotePath
    String sEncodedJpg
    String sTemp1
    Boolean bTemp1

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    Get Create (RefClass(cComChilkatSsh)) To hoSsh
    If (Not(IsComObjectCreated(hoSsh))) Begin
        Send CreateComObject of hoSsh
    End

    // Hostname may be an IP address or hostname:
    Move "www.some-ssh-server.com" To sHostname
    Move 22 To iPort

    // Connect to an SSH server:
    Get ComConnect Of hoSsh sHostname iPort To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoSsh To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // Wait a max of 5 seconds when reading responses..
    Set ComIdleTimeoutMs Of hoSsh To 5000

    // Authenticate using login/password:
    Get ComAuthenticatePw Of hoSsh "myLogin" "myPassword" To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoSsh To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // Once the SSH object is connected and authenticated, we use it
    // in our SCP object.
    Get Create (RefClass(cComChilkatScp)) To hoScp
    If (Not(IsComObjectCreated(hoScp))) Begin
        Send CreateComObject of hoScp
    End

    Get pvComObject of hoSsh to vSsh
    Get ComUseSsh Of hoScp vSsh To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoScp To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Move "images/starfish.jpg" To sRemotePath

    // Download the binary file and return as a base64 string.
    // See <a href="http://www.cknotes.com/chilkat-binary-encoding-list/">List of Encodings</a> for a list of possible encodings.
    Get ComDownloadBinaryEncoded Of hoScp sRemotePath "base64" To sEncodedJpg
    Get ComLastMethodSuccess Of hoScp To bTemp1
    If (bTemp1 <> True) Begin
        Get ComLastErrorText Of hoScp To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Move "images/starfish2.jpg" To sRemotePath

    // Now upload from the base64 string to the SSH server.
    // Insided the call to UploadBinaryEncoded, the base64 string is decoded,
    // and the decoded bytes are uploaded.  The resulting starfish2.jpg on the
    // server will be identical to the original starfish.jpg
    Get ComUploadBinaryEncoded Of hoScp sRemotePath sEncodedJpg "base64" To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoScp To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Showln "SCP download/upload binary encoded success."

    // Disconnect
    Send ComDisconnect To hoSsh


End_Procedure