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

Parameter

Description

PASS

OK

Action to create a rule using UPL.

enabled

Enable/disable a rule:

  • enabled(yes) or enabled(true).

  • enabled(no) or enabled(false).

name

The name of the bookmark.

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

desc

A description of the bookmark.

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

url

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".

url.domain

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".

rdp_check_session_alive

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

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

certificate

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

icon

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.

additional_url

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").

user

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.