RapidIdentity Product Guide

Port Forwarding Actions

Close a forwarded a local TCP port.

Property

Value

Description

session*

expression, variable

the SSH port forwarding session

localAddress

text, expression, variable

the bound local source IP address(default: 127.0.0.1, i.e. localhost of RapidIdentity Connect server)

localPort*

expression, variable

the forwarded local source TCP port

returnVariable

expression, variable

name of the variable to be assigned to the return value

Close a forwarded a remote TCP port

Property

Value

Description

session*

expression, variable

the SSH port forwarding session

remotePort*

expression, variable

the forwarded remote source TCP port

returnVariable

expression, variable

name of the variable to be assigned to the return value

Forward a TCP port on the RapidIdentity Connect server through a remote CLI connection to a TCP port on a remote server.

Property

Value

Description

session*

expression, variable

the SSH port forwarding session

localAddress

text, expression, variable

the local source IP address (default: 127.0.0.1, i.e. localhost of RapidIdentity Connect server)

localPort*

expression, variable

the local source TCP port

remoteAddress

text, expression, variable

the remote destination IP address (default: 127.0.0.1, i.e. localhost of remote CLI server)

remotePort*

expression, variable

the remote destination TCP port

returnVariable

expression, variable

name of the variable to be assigned to the return value

Forward a TCP port from a remote CLI server to a TCP port through the RapidIdentity Connect server.

Property

Value

Description

session*

expression, variable

the SSH port forwarding session

remoteAddress

text, expression, variable

the remote source IP address (default: 127.0.0.1, i.e. localhost of remote CLI server)

remotePort*

expression, variable

the remote source TCP port

localAddress

text, expression, variable

the local destination IP address (default: 127.0.0.1, i.e. localhost of RapidIdentity Connect server)

localPort*

expression, variable

the local destinatin TCP port

returnVariable

expression, variable

name of the variable to be assigned to the return value

Open an SSH port forwarding session.

Property

Value

Description

host*

text, expression, variable

the SSH host name or address

port

expression, variable

the SSH port (default: 22)

user*

text, expression, variable

the username for the SSH host

password*

password, string, expression, variable

the password for the SSH host

returnVariable

expression, variable

name of the variable to be assigned to the return value

Open an SSH port forwarding session using public/private key authentication.

Property

Value

Description

host*

text, expression, variable

the SSH host name or address

port

expression, variable

the SSH port (default: 22)

user*

text, expression, variable

the username for the SSH host

privateKey*

text, expression, variable

the path of the private key file within the project file store or the private key loaded as a byte array

publicKey

text, expression, variable

the path of the public key file within the project file store or the public key loaded as a byte array

passPhrase

password, string, expression, variable

the passPhrase for private key (default: none)

returnVariable

expression, variable

name of the variable to be assigned to the return value

Example

# assumes public and private key have been uploaded to project 
    files store,
# and public key has been added as a trusted identity on 
    SSH remote server 
session = openPortForwardingSessionWithCert("host1.acme.org", 
    22, "root", "/.ssh/id_rsa", "/.ssh/id_rsa.pub",<Password>)

Example

# open SSH session to server inside firewall
portForwardSession = openPortForwardingSession("my-ssh-server", 
    "root",<Password>)
if(portForwardSession) {
# forward port 8389 on a loopback address to the ldap server 
server: port behind firewall
portForwarded = forwardLocalPort(portForwardSession, "127.0.0.50", 
    8389, "my-ldap-server", 389)
if (portForwarded) {
    # connect to the LDAP server through the forwarded port
    ldapConnection = openLDAPConnection("127.0.0.50", 8389, false, 
        "cn=admin,ou=users,o=system", < Password > )
    #...
    # < do ldap stuff here > 
    #...
    #close the ldap connection
    closeLDAPConnection(ldapConnection)
    # close the forwarded port
    closeForwardedRemotePort(portForwardSession, 8389)
} else {
}
    # close the ssh session
    close(portForwardSession)
} else {
}