Back to product page

PortBindRequest method


Called when user wants to bind specific port on the server.

Type

None

Syntax

  • Basic
object.PortBindRequest Owner, User, BindIP, BindPort, Action 
The PortBindRequest(object,Owner,User,BindIP,BindPort,Action) syntax has these parts:
objectAn expression evaluating to an object of type IwodSSHDNotify.
OwnerA wodSSHDcom object. Instance of wodSSHServer that called this notification method.
UserA SSHUser object. Reference to user who wants to bind a port.
BindIPA String value. Holds interface address that will be used for listening.
BindPortA Long value. Specifies port number that will be used for listening.
ActionA SSHActions enumeration, as described in settings. Return variable you should set to Allow or Deny, depending if you will allow or deny access for the user.

Remarks

The settings for Action are:

Constant Value Description
Deny0 Deny execution of the action.
Allow 1 Allow to execute action.


This method is called only if you implemented IwodSSHNotify interface in your application, and wodSSHD.Notification property has received reference to instance of your implementation.

This notification method is called when connected user requests service from wodSSHD to open specified port (BindPort value) for listening. If you set Action to Allow, wodSSHD will open this port and listen for incoming connections, if possible. When connection arrives, notification method PortForwardConnect will be called where you can see the Hostname of user who's trying to use this opened port. If all is Allowed, remote client will receive message about this connection, and it will be able to receive forwarded data for this connection.

Bind requests are typically used to protect plain communication from 3rd party sniffing (eavesdropping). For example, instead of opening local port on his computer, client can request server to open port. Complete traffic between wodSSHD server and the client will be encrypted (it's traveling through already established SSH connection).

If wodSSHD should initiate outgoing connection, notification method PortForwardRequest will be called.

Platforms

Windows