Managing Kea client classification in Micetro - User Guide - Micetro - 25.2.0

Micetro Admin Guide
ft:locale
en-US
Product name
Micetro
Version
25.2.0

Client classification is a feature specific to ISC Kea DHCP servers, which enables the classification of different types of clients to treat them in different ways.

Incoming packets can be associated with a client class by selecting a vendor class option or another built-in condition, static host reservation, scope, or superscope, or by using a hook. You can use client classification to select scopes and pools, limit leases, or even rate limiting. For more information, refer to the official Kea documentation on client classification.

To manage Kea client classifications in Micetro:

  1. On the Admin page, select Kea under DHCP services in the left sidebar.
  2. Select the relevant service, and then select Manage client classes on either the Action or the Row … menu.
  3. The Client classifications dialog displays all existing client classes and whether they are built-in, global, and/or custom. Refer to Creating client classes below for more information on types of client classes.

    In the dialog, you can create, edit existing, or remove client classes as needed.



    • If any client classes are already defined on your server, they will be listed on the respective service type tab (DHCPv4/DHCPv6).
    • Any changes you make to client classifications are added to the audit trail in Micetro, which you can view by selecting View history from the Row ... menu.

Client classes can also be assigned and managed on DHCP superscopes. For more information, refer to Assigning client classes to superscopes.

Creating client classes

You can create client classes on your ISC Kea DHCP server directly through Micetro. To create client classes:

  1. Navigate to the Client Classifications dialog as described above and select Create.
  2. In the Create client classification dialog, enter the required information:

      • Client class type: Select whether the client class is built-in or custom.
      • Name: Enter a name for the client class.
      • Description: (Optional) Enter a description of the client class. The description is only saved in Micetro, and is not added to the Kea config.
      • Expression: Create an expression for the client class. Each DHCP packet will be evaluated against the expression to determine if it should belong to that client class. For information about how to create expressions, refer to the Kea documentation.
      • Global: Select the Global checkbox if you want to create the client class on all active Kea servers. Any modification or removal action on that client class will be replicated on all active Kea servers. Defining a client class as global is a Micetro-specific feature.
    2. Open the Options tab to set DHCP options on the client classes. Use the dropdown to select options and then enter the required information.
    3. For DHCPv4 client classes, you can specify BOOTP parameters on the BOOTP tab.
    4. Select Create.

Assigning client classes to scopes and pools

You can limit the access to specific scopes and address pools by assigning a client class to them. After assigning a client class, only packets that belong to that client class will have access to the scope or address pool. For instructions on assigning client classes to a superscope, refer to Assigning client classes to superscopes.

To assign a client class to an address pool:

  1. On the IPAM page, select a Kea scope in the data grid.
  2. Use either the Action or the Row … menu to select Manage DHCP pools.
  3. In the Manage DHCP Pools dialog box, select the pool and use the Row … menu to select Assign client classification.

  4. In the dropdown, select the client class to assign to the pool and select Save.
  5. Select Save.

To assign a client class to a scope:

  1. On the IPAM page, select a Kea scope in the data grid.
  2. Use either the Action or the Row … menu to select Assign client classification.
  3. In the dropdown, select the client class to assign to the scope. To unassign a client class, select Unassigned.
  4. Select Save.

When you assign client classes to scopes/pools, the assignment is included in the History for the respective ranges. You can filter ranges in the data grid based on their assigned client classes using the property clientClass.