SQL Server

POP3 over Multiple Hop SSH

Demonstrates how to read POP3 email (using TCP or TLS) tunneled through mulitple-hop SSH. The scheme looks like this:

Application => ServerSSH1 => ServerSSH2 => POP3Server

SQL Server

-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
    DECLARE @hr int
    -- Important: Do not use nvarchar(max).  See the warning about using nvarchar(max).
    DECLARE @sTmp0 nvarchar(4000)
    DECLARE @sTmp1 nvarchar(4000)
    DECLARE @success int
    SELECT @success = 0

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

    DECLARE @ssh1 int
    EXEC @hr = sp_OACreate 'Chilkat.Ssh', @ssh1 OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

    -- Connect directly to the 1st SSH server.
    EXEC sp_OAMethod @ssh1, 'Connect', @success OUT, 'serverssh1.com', 22
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @ssh1, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @ssh1
        RETURN
      END

    -- Authenticate using login/password:
    EXEC sp_OAMethod @ssh1, 'AuthenticatePw', @success OUT, 'ssh1Login', 'ssh1Password'
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @ssh1, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @ssh1
        RETURN
      END

    -- Connect through the 1st SSH connection to reach a 2nd SSH server.
    -- Note: Any number of SSH connections may be simultaneously tunneled through a single
    -- existing SSH connection.
    DECLARE @ssh2 int
    EXEC @hr = sp_OACreate 'Chilkat.Ssh', @ssh2 OUT

    EXEC sp_OAMethod @ssh2, 'ConnectThroughSsh', @success OUT, @ssh1, 'serverssh2.com', 22
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @ssh2, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @ssh1
        EXEC @hr = sp_OADestroy @ssh2
        RETURN
      END

    -- Authenticate with ssh2...
    EXEC sp_OAMethod @ssh2, 'AuthenticatePw', @success OUT, 'ssh2Login', 'ssh2Password'
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @ssh2, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @ssh1
        EXEC @hr = sp_OADestroy @ssh2
        RETURN
      END

    DECLARE @mailman int
    EXEC @hr = sp_OACreate 'Chilkat.MailMan', @mailman OUT

    -- Tell the mailman object to connect to the POP3 server though the ssh2 tunnel (which itself is routed through ssh1).
    -- The connection looks like this:  Application => ServerSSH1 => ServerSSH2 => POP3Server
    EXEC sp_OAMethod @mailman, 'UseSsh', @success OUT, @ssh2
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @mailman, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @ssh1
        EXEC @hr = sp_OADestroy @ssh2
        EXEC @hr = sp_OADestroy @mailman
        RETURN
      END

    -- Set the POP3 server's hostname
    EXEC sp_OASetProperty @mailman, 'MailHost', 'pop.example.com'

    -- Set the POP3 login/password.
    EXEC sp_OASetProperty @mailman, 'PopUsername', 'myLogin'
    EXEC sp_OASetProperty @mailman, 'PopPassword', 'myPassword'

    -- Establish the POP3 connection through the ssh2 tunnel.
    EXEC sp_OAMethod @mailman, 'Pop3BeginSession', @success OUT
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @mailman, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @ssh1
        EXEC @hr = sp_OADestroy @ssh2
        EXEC @hr = sp_OADestroy @mailman
        RETURN
      END

    -- Get the number of messages in the mailbox.
    DECLARE @numMessages int
    EXEC sp_OAMethod @mailman, 'GetMailboxCount', @numMessages OUT

    DECLARE @email int
    EXEC @hr = sp_OACreate 'Chilkat.Email', @email OUT

    DECLARE @i int
    SELECT @i = 1
    WHILE @i <= @numMessages
      BEGIN
        -- Fetch by the message number (not by the UIDL)
        EXEC sp_OAMethod @mailman, 'FetchOne', @success OUT, 0, 0, @i, @email
        IF @success = 0
          BEGIN
            EXEC sp_OAGetProperty @mailman, 'LastErrorText', @sTmp0 OUT
            PRINT @sTmp0
            EXEC @hr = sp_OADestroy @ssh1
            EXEC @hr = sp_OADestroy @ssh2
            EXEC @hr = sp_OADestroy @mailman
            EXEC @hr = sp_OADestroy @email
            RETURN
          END

        EXEC sp_OAGetProperty @email, 'From', @sTmp0 OUT

        EXEC sp_OAGetProperty @email, 'Subject', @sTmp1 OUT

        PRINT @sTmp0 + ': ' + @sTmp1 + CHAR(10)

        SELECT @i = @i + 1
      END

    -- Close the connection with the POP3 server.  (This closes the tunnel through ssh2)
    -- The connection with ssh2 is still alive, and may be used for more connections.
    EXEC sp_OAMethod @mailman, 'Pop3EndSession', @success OUT

    -- Close the connection with ssh2.  (This closes the the tunnel through ssh1.)
    -- The connection with ssh1 is still alive, and may be used for more connections.

    EXEC sp_OAMethod @ssh2, 'Disconnect', NULL

    EXEC sp_OAMethod @ssh1, 'Disconnect', NULL

    EXEC @hr = sp_OADestroy @ssh1
    EXEC @hr = sp_OADestroy @ssh2
    EXEC @hr = sp_OADestroy @mailman
    EXEC @hr = sp_OADestroy @email


END
GO