Skip to content

Client Groups:

Overview

Client group can be used for restricting access of the HyWorks resources such as Desktop Pool, Application and Reservation. Once client groups are defined and configured on HyWorks resources , the resources will be accessible from the endpoints belonging to the allowed client groups.

Following types of parameters can be used to define a client group:

  • LAN IP (Applicable for HyWorks Clients only)

  • WAN IP (Applicable HyWorks Clients and HyLite for future releases)

  • MAC Address (Applicable for HyWorks Clients only)

As part of client group management, following operations can be done:

Add new client group

Step by step process to Add client group:

Following are steps to add new client group:

  1. Goto Administrator-> Client Group.

  2. Click on Add button. It will open Add Client Group wizard.

  3. Enter Name for the client group to uniquely identified in system. This is compulsory field.

  4. Enter Description for the client to describe the purpose of the client group.

  5. Check Active to enable client group.

  6. Click on Add New Rule to add new rule in client group, It will open rule pop-up.

  7. Then Select Rule Type from list, click on Add New Rule to add rule for selected type, click on Cancel to close popup.

  8. Enter values for selected Rule Types:

    • MAC Address: Enter multiple comma separated MAC addresses. Maximum 500 MAC addresses are supported at a time. Examples of valid MAC format: 48:2C:6A:1E:59:3D, 48-2C-6A-1E-59-3D.

    • LAN IP Address: Enter multiple comma separated LAN IP addresses. Maximum 500 IP addresses are supported at a time. Examples of valid IP format: 192.168.0.241, 192.168.0.1/16, 192.168.0.1-192.168.0.255.

    • WAN IP Address: Enter multiple comma separated WAN IP addresses. Maximum 500 IP addresses are supported at a time. Examples of valid IP format: 192.168.0.241, 192.168.0.1/16, 192.168.0.1-192.168.0.255.

  9. To delete rule, click on bin button from header of particular rule which is in red back colour. After clicking on delete button, it will show confirmation box. Click on confirmation box to delete rule type.

  10. After configuring required rule(s), click on Save button to save client group.

  11. on saving client groups, it will show list of client which is already configured.

Note

If any rule type is added, then this type will removed from Select Rule Type List. So any rule type can be configured only one time.

Update already configured client group

Following are steps to update/edit existing client group:

  1. Select particular client group which want to update.

  2. Click on Edit button.

  3. Change Name, Description as per the requirement.

  4. Un-select Active option to disable client group.

  5. Updating configured Rules: It is showing configured rules.

    • Delete value : Select particular value that want to remove then click on Delete Section button.

    • Search value: To search value in particular rules, enter text in Search box and click on Go button, To refresh original list click on Refresh button.

    • Delete Rules: To delete particular rules, Click on Bin button, which is at header of the rule.

    • Add More rules: Find Open box below rule text area, and click inside the box. It will turn into textbox, then enter values with comma separated for rule.

  6. After configuration of basic information and rules, click on update button to update client group.

Delete existing client group

following are the steps to delete client group:

  1. Select particular client group which want to delete.

  2. Click on Delete button.

  3. Then it will open confirmation box, enter minimum first 5 letters from client group name.

  4. Click on Delete button on pop-up.

  5. Then it will show success message, and remaining configured client groups will be show in grid.

List view of client group

Following field is show from client group details:

  1. Name: Name of the client group.

  2. Description: Description of the client group.

  3. Rule Types: Types rules configured in client group.

  4. Active: Client group is enabled or disabled.

  5. Search: Enter search string, which want to search into name, description and rule type.

  6. Sorting and pagination:

    • Sorting: click on headers to sort records ascending or descending order.

    • Pagination: At bottom shows Page Size to number of records show in single page, default value is auto(based on page size), change as per requirement. At right side show page numbers, click on Page Number to jump on page.

Association of client groups

Client can be applied on following objects of HyWorks:

  1. Administration Portal:

  2. Reservation Management Portal (HyLabs):

    • Reservation - Gold Master.

Workflow in reservation management (HyLabs)

Following flow can be used to define and use client group restrictions:

  • Import client group CSV with appropriate entries or Add using Client Group screen
  • Configure gold master access to selected client groups: To restrict all the reservations from the gold master
  • Configure reservations with client groups: To restrict the reservation access to selected client groups only

Import Client Group CSV

In existing RMS – CSV Configurations, option to import Client Group CSV has been added. Rest of the configurations e.g. CSV Format, CSV Location details will remain same.

Following types of parameters can be used to define a client group:

  • LAN IP (Applicable for HyWorks Clients only)

  • MAC Address (Applicable for HyWorks Clients only)

  • WAN IP (Applicable for HyLite and HyWorks Clients)

  • A single client group can have one or multiple types of parameters

  • Below are some examples of CSV entries:
ClientGroupName Para-Type Add / Delete Para-Value RealmName
CG_LAB-AE-MAC M A aa-bb-cc-dd-ee-11
CG_LAB-AE-MAC M A aa-bb-cc-dd-ee-11
CG_LAB-AE-MAC M A aa:bb:cc:dd:ee:12
CG_LAB-AE-MAC M A aa:bb:cc:dd:ee:13
CG_LAB-BE-LAN L A 172.16.0.16
CG_LAB-BE-LAN L A 172.16.0.0/24
CG_LAB-BE-LAN L A 172.16.1.2-172.16.1.127
CG_LAB-BE-WAN W A 192.168.0.0/16
CG_LAB-BE-WAN W A 123.201.54.132
CG_LAB-BE-WAN W A 123.201.54.133
CG_LAB-BE-WAN W A 123.201.54.134
CG_LAB-CSE-MIX L A 172.17.0.1-172.17.0.254
CG_LAB-CSE-MIX L A 192.168.0.10
CG_LAB-CSE-MIX M A aa:bb:cc:dd:xy:13
CG_LAB-CSE-MIX M A aa:bb:cc:dd:xy:14

So now there will be four client group definitions:

  1. CG_LAB-AE-MAC: aa-bb-cc-dd-ee-11 aa:bb:cc:dd:ee:12 aa:bb:cc:dd:ee:13

  2. CG_LAB-BE-LAN: 172.16.0.16 172.16.0.0/24 172.16.1.2-172.16.1.127

  3. CG_LAB-BE-WAN: 192.168.0.0/16 123.201.54.132 123.201.54.133 123.201.54.134

  4. CG_LAB-CSE-MIX: (172.17.0.1-172.17.0.254 192.168.0.10) aa:bb:cc:dd:xy:13 aa:bb:cc:dd:xy:14

CSV Import Wizard

Following options are available in CSV import wizard in HyLabs. To enable Client Group import, option should be checked in CSV Import Profile and appropriate file should be placed at defined location of CSVs. Please see more details about CSV import in section CSV Configurations

Client Group Examples

Consider the above client groups are associated with different reservations as described below: 1. RES#1 - CG_LAB-AE-MAC 2. RES#2 - CG_LAB-BE-LAN 3. RES#3 - CG_LAB-BE-WAN 4. RES#4 - CG_LAB-CSE-MIX 5. RES#5 – CG_LAB-AE-MAC, CG_LAB-BE-LAN

  • RES#1: Users logging-in from device with having MAC addresses defined for Client Group “CG_LAB-AE-MAC” will have access whereas any user logging in from HyLite or other devices will not be able to access

  • RES#4: will only be accessible from clients where the MAC address is either aa:bb:cc:dd:xy:14 or aa:bb:cc:dd:xy:13 and having the IP as 172.17.0.1-172.17.0.254 or 192.168.0.10

    • With multiple types of parameters defined in single client group, both types of conditions should meet to give the access

  • RES#5: Will be accessible from clients having MAC addresses defined in CG_LAB-AE-MAC or clients having IP defined in CG_LAB-BE-LAN

    • If a reservation is having multiple client groups, then member of any client group will be able to access the reservations.