- 03 Jun 2022
- 2 Minutes to read
- Print
- DarkLight
Port Forwarding Actions
- Updated on 03 Jun 2022
- 2 Minutes to read
- Print
- DarkLight
Port Forwarding Actions
closeForwardedLocalPort
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 |
closeForwardedRemotePort
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 |
forwardLocalPort
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 |
forwardRemotePort
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 |
openPortForwardingSession
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 |
openPortForwardingSessionWithCert
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 |
# 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>)
Complete 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 {
}