Object groups

This help contains the following topics:

Introduction

Object groups

An object group is a group of objects that can be used by other service modules to identify packets. Object groups are divided into the following types:

A packet is considered matching an object group if it matches an object in the group.

For simplicity purposes, object groups support object group nesting to allow one object group to use another object group as an object.

Time ranges

You can implement a service based on the time of the day by applying a time range to it. A time-based service takes effect only in time periods specified by the time range. If a time range does not exist, the service based on the time range does not take effect.

The following basic types of time ranges are available:

A time range is uniquely identified by the time range name. You can create a maximum of 1024 time ranges, each with a maximum of 32 periodic statements and 12 absolute statements. The active period of a time range is calculated as follows:

  1. ‍Combining all periodic statements.

  2. Combining all absolute statements.

  3. Taking the intersection of the two statement sets as the active period of the time range.

NAT groups

A NAT address group contains a group of IP segments or port ranges. It can be used by NAT for dynamic NAT translation.

For the PAT mode, you must specify address group members and a port range. For NAT444 dynamic translation, you must also specify the port block size and configure port block extending.

For the NO-PAT mode, you must specify address group members.

For more information about the PAT and NO-PAT modes, see "NAT."

NAT address group probing

NAT address group probing uses an NQA template to detect the reachability of the addresses in the group.

The device periodically sends probe packets to the specified destination address in the NQA template. The source IP addresses in the probe packets are the IP addresses in the NAT address group.

AFT address group

An AFT address group contains a group of IP segments. It can be used by AFT for dynamic AFT translation. For more information about AFT, see "AFT."

Support for the AFT address group depends on the device model.

With high availability configured, specify a VRRP group for each AFT address group for the master in the VRRP group to respond to ARP requests with the virtual IP address and MAC address. Support for this feature varies by device model.

Location

Security policies support filtering packets by source and destination locations. Each location defines a mapping between a country, province, or city and a set of IP address ranges. A packet is considered from or to a location if the source or destination IP address of the packet is within the IP range specified for the location.

The following types of locations are available:

You can add multiple locations to a location group for security policies to process packets by location group. Packets matching a location in a location group are considered matching the location group.

DNS aging

In load-sharing scenarios where a host name corresponds to multiple IP addresses, the IP address converted from a host name might change frequently. By default, the object group module notifies relevant policies (including security policies) every time the converted address changes, which might cause frequent policy acceleration and consume many memory resources.

To resolve this issue, you can enable DNS aging for IP addresses converted from a host name to age out.

With this feature enabled, the object group module maintains an IP address group for each host name. If an address converted from a host name does not exist in the group, the system adds the address to the group and notifies the new IP address range to relevant policies. If a converted address already exists in the group, the system does not notify policies but updates the address aging time instead. After an address ages out, the system notifies the relevant policies of the address deletion. This reduces policy acceleration and memory consumption.

Support for DNS aging depends on the device model.

Restrictions and guidelines

Configure object groups

Configure an IPv4 address object group

  1. ‍Select Objects > Object Groups > IPv4 Address Object Groups.

  2. Click Create.

  3. Configure the IPv4 address object group.

    Table-1 Configuration items for creating an IPv4 address object group

    Item

    Description

    Name

    Object group name, a case-insensitive string of 1 to 63 characters. Make sure the object group name is globally unique.

    Description

    Object group description, a case-sensitive string of 1 to 127 characters.

    Security zone

    Security zone to which the address object group belongs.

  4. Click Add in the Objects section to add objects.

    Table-2 Configuring items for adding an object

    Item

    Description

    Object

    Object type. Options include:

    • Network segment: Subnet IPv4 address.

    • Object group: Other IPv4 object group.

    • IP address range: IPv4 address range.

    • Host IP address: Host IPv4 address.

    • Host name: Host name.

    • IP address/wildcard mask: IPv4 address with a wildcard mask.

    Excluded addresses

    Excluded IPv4 addresses in the address object. This field is optional and is only available when the object type is network segment, IP address range, or IP address/wildcard mask.

    Description

    Object description, a case-sensitive string of 1 to 127 characters.

  5. Click Apply. The newly created IPv4 address object group will be displayed on the IPv4 Address Object Groups page.

Configure an IPv6 address object group

  1. ‍Select Objects > Object Groups > IPv6 Address Object Groups.

  2. Click Create.

  3. Configure the IPv6 address object group.

    Table-3 Configuration items for creating an IPv6 address object group

    Item

    Description

    Name

    Object group name, a case-insensitive string of 1 to 63 characters. Make sure the object group name is globally unique.

    Description

    Object group description, a case-sensitive string of 1 to 127 characters.

    Security zone

    Security zone to which the address object group belongs.

  4. Click Add in the Objects section to add objects.

    Table-4 Configuring items for adding an object

    Item

    Description

    Object

    Object type. Options include:

    • Network segment: Subnet IPv6 address.

    • Object group: Other IPv6 object group.

    • IP address range: IPv6 address range.

    • Host IP address: Host IPv6 address.

    • Host name: Host name.

    Excluded addresses

    Excluded IPv6 addresses in the address object. This field is optional and is only available when the object type is network segment or IP address range.

    Description

    Object description, a case-sensitive string of 1 to 127 characters.

  5. Click Apply. The newly created IPv6 address object group will be displayed on the IPv6 Address Object Groups page.

Configure a MAC address object group

  1. ‍Select Objects > Object Groups > MAC Address Object Groups.

  2. Click Create.

  3. Configure the MAC address object group.

    Table-5 Configuration items for creating a MAC address object group

    Item

    Description

    Name

    Object group name, a case-insensitive string of 1 to 63 characters. Make sure the object group name is globally unique.

    Description

    Object group description, a case-sensitive string of 1 to 127 characters.

  4. Click Add in the Objects section to add objects.

    Table-6 Configuring items for adding an object

    Item

    Description

    Type

    Object type. Options include:

    • Object group: Other MAC address object group.

    • MAC address: MAC address.

    Object group

    Name of the referenced MAC address object group, a case-insensitive string of 1 to 63 characters. This field is available only when the object type is set to object group.

    MAC address

    MAC address in the H-H-H format. This field is available only when the object type is MAC address.

    Description

    Object description, a case-sensitive string of 1 to 127 characters.

  5. Click Apply. The newly created MAC address object group will be displayed on the MAC Address Object Groups page.

Configure a service object group

  1. ‍Select Objects > Object Groups > Service Object Groups.

  2. Click Create.

  3. Configure the service object group.

    Table-7 Configuration items for creating a service object group

    Item

    Description

    Name

    Object group name, a case-insensitive string of 1 to 63 characters. Make sure the object group name is globally unique.

    Description

    Object group description, a case-sensitive string of 1 to 127 characters.

  4. Click Add in the Objects section to add objects.

    Table-8 Configuring items for adding an object

    Item

    Description

    Object

    Object type. Options include:

    • Protocol type.

    • Object group: Other service object group.

    Type

    Protocol type. Options include:

    • TCP: Protocol number is 6.

    • UDP: Protocol number is 17.

    • ICMP: Protocol number is 1.

    • ICMPv6: Protocol number is 58.

    • SCTP: Protocol number is 132.

    • IP protocol number: Protocol number is in the range of 0 to 255.

    Protocol number

    IP protocol number in the range of 0 to 255. This field is available only when the protocol type is IP protocol.

    Message type

    ICMP/ICMPv6 message type in the range of 0 to 255. This field is available only when the protocol type is ICMP or ICMPv6.

    Message code

    ICMP/ICMPv6 message code in the range of 0 to 255. This field is available only when the protocol type is ICMP or ICMPv6 and the message type is configured.

    Source port

    Source port range in the range. Both the start port number and end port number are in the range of 0 to 65535. This field is available only when the protocol type is TCP, UDP, or SCTP.

    Destination port

    Destination port range in the range. Both the start port number and end port number are in the range of 0 to 65535. This field is available only when the protocol type is TCP, UDP, or SCTP.

    Description

    Object description, a case-sensitive string of 1 to 127 characters.

  5. Click Apply. The newly created service address object group will be displayed on the Service Address Object Groups page.

Configure a location or location group

Configure a location

  1. ‍Select Objects > Object Groups > Location.

  2. Click Create.

  3. Configure the location.

    Table-9 Configuration items for creating a location

    Item

    Description

    Name

    Location name, a case-insensitive string of 1 to 63 characters. Hyphens (-) are not supported.

    Longitude

    Location longitude in the range of –180.00 to 180.00, measured in degrees. Eastern longitude is positive, and western longitude is negative.

    Latitude

    Location latitude in the range of –90.00 to 90.00, measured in degrees. Northern latitude is positive, and southern latitude is negative.

    Description

    Location description, a case-sensitive string of 1 to 127 characters.

    IPv4 address

    Location IPv4 address, a single address or an address range.

  4. Click Apply. The newly created location will be displayed on the Locations page.

Configure a location group

  1. ‍Select Objects > Object Groups > Location.

  2. Click the Location Groups tab.

  3. Click Create.

  4. Configure the location group.

    Table-10 Configuration items for creating a location group

    Item

    Description

    Location Group Name

    Location group name, a case-insensitive string of 1 to 63 characters. Hyphens (-) are not allowed.

    Description

    Location group description, a case-sensitive string of 1 to 127 characters.

    Selected Locations and Location Groups

    Location group members.

  5. Click Apply. The newly created location group will be displayed on the Location Groups page.

Configure an NAT address group

  1. ‍Select Objects > Object Groups > NAT Address Groups.

  2. Click Create.

  3. Configure the NAT address group.

    Table-11 Configuration items for creating a NAT address group

    Item

    Description

    Address group ID

    Address group ID.

    Address group name

    Address group name.

    Description

    Address group description.

    VRRP group

    With a VRRP group specified, the master device in the VRRP group responds to ARP requests using the virtual IP address and virtual MAC address. Specify a VRRP group for an environment that requires high availability.

    Support for this field depends on the device model.

    Port range

    Make sure all public IP addresses in this NAT address group have their ports for NAT within the specified port range.

    Port block size

    Number of ports included in the allocated port block. When the port resources in the allocated port block are exhausted (all ports are in use), if the corresponding private IP address initiates a new connection to the public network, it will not be able to obtain a port from the allocated port block.

    Number of extended port blocks

    When the port resources in the allocated port block are exhausted (all ports are in use), you can perform incremental port block allocation for the corresponding private IP address.

    Address probe

    This function is used to detect the availability of addresses in the NAT address group, and it is implemented by referencing an NQA template in the address pool. This function only detects the availability of address members used for outbound address translation.

    Address group members

    When the system performs address translation for data packets reaching the external network, the source address of the packets will be converted to one of the addresses in the address group.

    Exclude address group members

    If certain address members cannot be used for address translation, exclude the IP addresses from address translation.

  4. Click Apply.

Configure an AFT address group

  1. ‍Select Objects > Object Groups > AFT Address Groups.

  2. Click Create.

  3. Configure the AFT address group.

    Table-12 Configuration items for creating an AFT address group

    Item

    Description

    Address group ID

    Address group ID.

    VRRP group

    With a VRRP group specified, the master device in the VRRP group responds to ARP requests using the virtual IP address and virtual MAC address. Specify a VRRP group for an environment that requires high availability.

    Support for this field depends on the device model.

    Group members

    When the system performs address translation for data packets reaching the external network, the source address of the packets will be converted to one of the addresses in the address group.

  4. Click Apply.

Configure an AFT address group

  1. ‍Select Objects > Object Groups > AFT Address Groups.

  2. Click Create.

  3. Configure the AFT address group.

    Table-13 Configuration items for creating an AFT address group

    Item

    Description

    Address group ID

    Address group ID.

    VRRP group

    With a VRRP group specified, the master device in the VRRP group responds to ARP requests using the virtual IP address and virtual MAC address. Specify a VRRP group for an environment that requires high availability.

    Support for this field depends on the device model.

    Group members

    When the system performs address translation for data packets reaching the external network, the source address of the packets will be converted to one of the addresses in the address group.

  4. Click Apply.