IIS Listeners

IIS Listeners, the configured listeners for this Pointsharp Access Gateway. A listener is used to match a set of rules for a specific host and port.

The matching procedure can be described as follows:

A client makes a request towards a specific address and port.
The Internet Information Service (IIS) on the server accepts the request depending on its bindings.
If any binding matches, then the Pointsharp Access Gateway is trying to retrieve the listener corresponding to the request.
If any listener matches, then the list of rules for that listener is searched to find the corresponding rule matching the request (using the path of the rules).
The response is sent back to the client depending on the matched - if matched - binding, listener, and rule.

IIS Bindings

Since the Pointsharp Access Gateway is using the IIS bindings to retrieve a request, it is important to create the IIS bindings corresponding to each listener in the Pointsharp Access Gateway configuration.

See Tools > IIS > Create Bindings to create the required bindings. You will be asked to create the bindings when publishing if they are not to be found.

Configuration of a listener

A listener is used to match an incoming request to a set of rules.

Property	Description
Address	The incoming address for a host or service to listen to. NOTE: set to "*" to match any host. Example: local.company.com
Port	The specific port to listen to. Check Any Port to listen to all ports for the specified address. Default: 443
Enabled	Decides whether the listener is in use or not. The Pointsharp Access Gateway will respond with a HTTP 503 (Service Unavailable) to the client if the listener matched, but is disabled. Default: enabled

Cookie

The configuration of how to use the cookie of any client request matching the specific listener. A cookie is used to store information between requests.

Property	Description
Name	Name of the cookie. This name is used as an identifier for any cookie data for requests to current listener. Default: PS
Domain	With cookie domain set the cookie will only work for its defined domain and be shared between subdomains.
Cookie Timeout	Cookie expire time in seconds.
Send Cookie to Server	Forward the custom cookie to the back-end Server. Default: disabled
Persistent Cookie	Adds the cookie timeout value to the cookie expiration time. This enables the client to reuse its cookie between sessions. Default: disabled

Property

Description

Name

Name of the cookie. This name is used as an identifier for any cookie data for requests to current listener.

Default: PS

Domain

With cookie domain set the cookie will only work for its defined domain and be shared between subdomains.

Cookie Timeout

Cookie expire time in seconds.

Send Cookie to Server

Forward the custom cookie to the back-end Server.

Default: disabled

Persistent Cookie

Adds the cookie timeout value to the cookie expiration time. This enables the client to reuse its cookie between sessions.

Default: disabled

Listener Log

Log configuration - overrides settings in General tab. See also Log configuration.