12.11.1. Configuring a web portal

You configure the web portal at the global-portal web-portal level. For more details on the command structure, see Configuring rules using UPL.

When setting the web portal bookmarks





Action to create a rule using UPL.


Enable/disable a rule:

  • enabled(yes) or enabled(true).

  • enabled(no) or enabled(false).


The name of the bookmark.

Example: name("Example of bookmark publishing").


A description of the bookmark.

Example: desc("Example of bookmark publishing configured in CLI").


The URL of the resource to be published via the web portal. Specify the full URL starting with http://, https://, ftp://, ssh:// or rdp://.

Example: url = "http://www.example.com".


Direct domain is an optional field, which allows access to the published resource from the Internet directly via specified domain name.

Specify a direct domain: url.domain = "example.com".


Disconnect the RDP session after authentication on the web portal is complete:

  • rdp_check_session_alive(yes) or rdp_check_session_alive(true): disconnect session.

  • rdp_check_session_alive(no) or rdp_check_session_alive(false): do not disconnect session.


SSL profile to establish a secure channel to display the web portal. Example: ssl_profile("SSL profile example").


The certificate that will be used to establish an HTTPS connection. To set the certificate: certificate("Certificate example").


Icon to display on the web portal for this bookmark. You can select one of the predefined icons, specify an external URL at which the icon is available, or upload a custom icon.

You can specify:

  • icon("Default icon name"): use the default icon (specify the name of the default icon in parentheses).

  • icon("Icon encoded with Base64"): use custom icon. Specify file contents in Base64 encoding.

  • icon("http://www.icon-url-example.com"): specify a URL of a third-party icon.


Supporting URLs necessary for the main URL to work (but not needed to be published to users). Example: additional_url("http://additional-url-example.com").


Users and user groups allowed to display the bookmark on the web portal and to access the main and supporting URLs.

To add LDAP groups and users, you need to have a correctly configured LDAP connector (for more information about configuring LDAP connectors via the CLI, see Configuring LDAP connectors).

The following line describes how to add a local user (local_user) and group (Local Group), a user (example.local\AD_user), and an LDAP group (AD group):

user = (local_user, "CN=Local Group, DC=LOCAL", "example.loc\\AD_user", "CN=AD group, OU=Example, DC= example, DC=loc")

The Active Directory domain example.loc has been already configured. When adding LDAP users and groups, you can specify a list of paths on the server, starting from which the system will search for users and groups.