Configuring a Web Portal

A web portal is configured at the global-portal web-portal level. For more details on the command structure, see Configuring Rules Using UPL.

To create a web portal page, use the following command:

Admin@nodename# create global-portal web-portal <position> upl-rule <parameters>

Parameters for configuring 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://.

To specify URL: 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.

To specify 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 specify a 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 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 an external URL.

additional_url

Supporting URLs necessary for the main URL to work (but not needed to be published to users). To specify: 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 the Configuring LDAP Connectors section).

Examples of adding users to a rule:

user = known user = "user" user = "testd.local\\user1" user = ("user", "testd.local\\user1")

To edit a web portal rule, use the following command:

Admin@nodename# set global-portal web-portal <position> upl-rule <parameters>

To view parameters of a web portal rule, use the following command:

Admin@nodename# show global-portal web-portal <position>

Example of creating a web portal rule using UPL:

Admin@nodename# create global-portal web-portal 1 upl-rule OK \ ...user = "CN=Default Group,DC=LOCAL" \ ...url = "http://www.intranet.loc" \ ...name("Test web portal") \ ...desc("Test web portal description") \ ...enabled(true) ... Admin@nodename# show global-portal web-portal 1 % ----------------- 1 ----------------- OK \ user = "CN=Default Group,DC=LOCAL" \ url = "http://www.intranet.loc" \ icon("default.svg") \ desc("Test web portal description") \ enabled(true) \ id("2fead5a1-29c3-4835-bbdb-1d0e07f84c28") \ name("Test web portal")

To delete a web portal rule, use the following command:

Admin@nodename# delete global-portal web-portal <position>