Redbex Reference Manual

Zoom Window Out
Larger Text | Smaller Text
Hide Page Header
Show Expanding Text
Printable Version
Save Permalink URL

Navigation: Administrator's manual > Tips for Windows administration

Configuring Namespace Reservations

The Redbex Application Server can communicate with clients communicate over HTTP and HTTPS. For this it is necessary that the user running the Application Server must have the access rights for that a portion of the HTTP URL namespace that used by the Redbex Application Server.

These access rights are usually configured by the Redbex Application Server Setup Program. If you manually configure or re-configure your installation of the Redbex Application Server (e.g. if you want the service to be provided on a different port or if you change the instance name) you will have to manually configure these access rights with so called namespace reservations.

The Windows command-line tool netsh.exe can be used to configure namespace reservations.

Namespace reservation assigns the rights for a portion of the HTTP URL namespace to a particular group of users. In addition a namespace reservation will modify the Windows routing database that is used to determine which application receives an incoming HTTP / HTTPS request. This way it is also possible that multiple services can use the same port (e.g. Redbex Application Server and IIS).

This manual does not provide a complete documentation on how to use netsh or how to build your HTTPS routing table, but in the following you find some examples that should get you started. For more information refer to Microsoft's MSDN documentation

Basic syntax

netsh http add urlacl url=http://+:80/<InstanceName> user=<WindowsUser>

the url= parameter defines which urls will be reserved. The + is a wildcard that will match any dns name or ip address. For more information on wildcards see Routing Incoming Requests on MSDN.

The InstanceName is the instance name of your Application Server.

The user parameter specifies the Windows user that runs the Redbex Application Server this can be a local Windows user or an Active Directory user.

Examples

netsh http add urlacl url=http://+:80/Instance01 user=RedbexService

netsh http add urlacl url=https://+:443/Instance01 user="ad\RedbexService"

netsh http add urlacl url=http://redbex.mydomain.com:80/Instance01 user=.\RedbexService