Skip to content

Organization Configurations

Configuration of organization defines how:

  • users will get authenticated and authorized in HyWorks

  • Workspace settings eill be applied while allowing the user access

Create or modify an existing organization from Configuration > Workspace > Organizations.

Organization Details

Basic configurations of an organization is as follows:

  1. Name: Provide a logical short name for a new organization. Following special characters are supported: _(Underscore) SPACE () {} # @ : -(Hyphen) .(dot).

  2. Code: A short code for organization. The organization code is used for communication between the Controller and the HyWorks endpoints/HyLite. Following special characters are supported: _(Underscore), -- (Hyphen), . (dot) and space (not trailing or leading spaces).

  3. Description: A logical description of the new organization

  4. Parent Organization: The name of the parent organization

  5. Inherit Resources: Select the checkbox if the parent organization's resources are to be shared with this child organization.

  6. Select Active to activate the organization. Inactive organizations are not listed on the client end upon logon.

  7. Select Create Realm to define the realm settings specific to this organization (keep it unchecked to use the parent organization's realm settings; If the Create Realm option is unchecked, all the realm settings i.e : UI setting, Portal Setting and Desktop Client Setting will be hidden)

  8. Select Create Auth Domain to specify Auth Domain settings for this organization (if the Create Auth Domain option is unchecked, the tab for the authentication domain will not be displayed, and the authentication domain of the parent or default organization will be used)

    If the Create Auth Domain option is checked, the authentication Domain tab will be enabled and will require appropriate configurations for the child organization. If the Inherit Resources option is checked, then the Administrator will also be able to see and view the authentication servers added for the default organization.

Authentication Domain

The Authentication domain defines authentication and authorization configurations of an organization.

  1. Authentication Server: The server to be used for authentication. All authentication servers added in this organization or inherited from the parent organization can be used.

  2. Authorization Server: The server to be used to authorize application and desktop access. It can be the same as the authentication server or can be a different server to authorize HyWorks queries or for the user's membership. Consolidated list of applications and desktops can be assigned to the user based on the assignment to the user, it's groups or OU.

  3. Domain Name for Remote Desktop Session: While accessing assigned application or desktops, HyWorks provide, domain name prefix to be used for connecting to respective remote desktop server, this authentication domain, can be auto fetched from authentication server configuration or authorization server configuration or custom defined. For deployments using remote desktop servers in workgroup, domain name can be set as dot ".".

  4. Use Credentials for Remote Desktop Server: When the authorization server is set as the Built-in, which is presumably for workgroup configurations, the Administrator can set the options for which credentials are to be used when connecting to the remote desktop server.

    1. User provided credentials: Credentials provided by the user for authentication will be used when connecting

    2. Built-in directory credentials: Credentials of users from the built-in directory

  5. User Creation on RDS(s): If the remote desktop servers are in a workgroup, a new user's creation method can be defined, as:

    1. Manual Synchronization: The Administrator will initiate the user syncing process between the remote desktop servers and the built-in directory

    2. Automatically on logon: No manual synchronization but the users will be created at the next logon event

    3. Do not create: Users will not be created and the Administrator must manage the availability of users on the remote desktop servers

    If the remote desktop servers are in the Active Directory and LDAP, a new user's creation method can be defined, as:

    1. Manual Synchronization: (Disabled and does not get used)

  6. Populate Users into built-in directory: This is a method to push users into the built-in directory

    1. Create users in built-in directory: Users can be created by importing CSVs or specifying the details in the user creation wizard

    2. Import users from the authentication server: Users can be fetched into the built-in directory from the authentication server.

Realm Settings

Realm settings in an organization defines the client and user workspace portal behavior and the user interface. In the Organization wizard, no such controls or sections with the name Realm Settings are displayed, but the combination of the following sections is termed as Realm Settings:

  1. UI Settings: UI Settings for the Client and User Workspace portal have the following settings:

    1. System Tray Pop-up Text: This option defines the text to be displayed for the HyWorks Client in the system tray

    2. Language Configurations: This option defines the language to be used by the HyWorks Clients

  2. Portal Settings: For defining the User Workspace Portal settings

    1. Enable Portal: For activating the logon through the User Workspace Portal

    2. Exit Application Session on Close: This section defines if the remote sessions are to be closed upon exiting the portal

    3. Use Custom Logo: This option helps to change the logo displayed in the Client and User Workspace Portal

      1. This provides the option to select, crop and upload custom logos for the organization

    4. Hide System Tray Icon: This options helps to hide the system tray entry of the client when accessed through the user workspace portal

    5. Use Custom Portal Title: This option is for specifying the custom portal title

    6. Tile Color: This option defines the tile color of the application's user workspace portal

    7. Font Color: This section defines the font color to be used by the applications on the user workspace portal

    8. Default Client Type: This option defines the type of client to be used by the default with User Workspace portal. If client is not installed, at the logon event, a dialog to install the client will be displayed and the specific type of client will be downloaded. The same settings also govern the type of client to be provided on the logon screen with the Client Download Link.

  3. Desktop Client Settings: Configurations for HyWorks clients:

    1. Enable desktop client: This option allows activating the logon through HyWorks Clients

    2. Allow Save Username: This section helps with enabling the user to save their username. The username used at the last successful logon will be cached and will be displayed at the next logon event.

    3. Allow Save Password: This option helps to enable the caching of the password used at the last successful logon event for the user on the client

    4. Hide App Launcher: This option helps to hide the application tray after logon

    5. Use Custom Title for Client: This option helps to configure a custom title for the client

    6. Tile Color: This option helps to define the tile color for the applications on the client application tray

    7. Font Color: This option helps to define the font color to be used for the applications on the client application tray

    8. Application Shortcuts Settings

      1. Do Not Create Shortcuts: This option helps to disable the shortcut creation to the applications on the user's desktops

      2. Delete Shortcuts on Exit: This option removes the shortcuts when the client exits