Attributes Validation Tab

Attributes Validation Tab

This feature is in alpha. Please report any issues or feedback as we progress to Beta and then GA.

This guide will help you make the most of the Attributes Validation feature in AGILITY. You’ll find step-by-step instructions on how to navigate the interface, interpret validation results, and understand the details presented in the AVP Validation tab.

By the end of this guide, you’ll be able to:


Feature Description

AGILITY now provides automated validation for RADIUS and DIAMETER protocol messages, giving operators and compliance engineers faster, more reliable insights into network health.

With this feature, AGILITY automatically checks for the presence and compliance of mandatory attributes in each message, ensuring consistency and accuracy across troubleshooting and compliance workflows.

By surfacing clear pass/fail results, detailed evidence, and direct links to protocol procedures in the UI—AGILITY significantly reduces troubleshooting time, improves compliance confidence, and streamlines operations.

This enhancement helps teams:

  • Resolve issues faster with instant visibility into validation results.

  • Ensure compliance by automatically enforcing protocol standards.

  • Standardize troubleshooting across teams and environments.

  • Scale for the future with a design that supports additional protocols.


🚪 Accessing the Attributes Validation Tab

The Attribute Validation feature is only available in analyses that contain RADIUS or DIAMETER protocols. If your analysis does not include these protocols, the content will not be displayed.

After you complete an analysis, you can view RADIUS and DIAMETER attribute validation details (when available) in two ways:

1. From the Analysis Hub

Includes all RADIUS and DIAMETER messages from flows extracted by AGILITY from the submitted network trace.

  • In the Analysis Hub page, click the Compliance button at the top.

    image-20251114-162353.png
    Analysis Hub: Compliance button
  • The icon indicates the validation status of the analysis:

    • Red icon → One or more message attributes failed validation.

    • Blue icon → All message attributes passed validation.

  • A pop-up window will appear, showing:

    • The complete list of messages in the analysis.

    • Key statistics, including the total number of validations, the count of attributes that passed or failed, and the overall pass rate.

2. From Flow Details

Includes only RADIUS and DIAMETER messages from the current flow.

  • In your analysis results, select the flow you want to inspect.

  • On the Flow Details page, scroll to the Core Features section.

  • Open the Attribute Validation tab to review validation results.

image-20250917-142453.png
Flow Details: Attribute Validation Tab

Understanding the Attributes Validation Table

This section provides detailed explanations for each data presented in the Attributes Validation sections, helping you understand the meaning and purpose behind every value.

Top-Level Data

The main rows present information at the message level, consistent with how data is displayed elsewhere in the interface.

Important

This feature displays only correlated frames that are part of the flow (Diameter or RADIUS messages). Frames that are ignored are still validated in the background, but their details are not shown in the AGILITY interface.

The pop-up displays the following details for each message in the analysis:

  • Frame Number – The sequence number of the message within the capture.

  • Network Elements (Source and Destination) – Identifies the originating and receiving network elements.

  • Protocol – The protocol used for the message.

  • Overall Result – Indicates whether the message passed or failed validation. A message is marked as failed if at least one attribute fails validation.

  • Message Type – Specifies whether the message is a Request or a Response.

  • Epoch Time – The timestamp of when the message was captured.

  • Message – The actual message content.

  • Matched Rules – Highlights the pre-defined rules applied during validation for this message.

Validation Results

This section, which presents the details about each attribute in the validation results, includes the following details:

  • Results Summary – Displays the overall validation results, the rules that were checked, and the count of elements that passed or failed.

  • Attribute – The name of the attribute.

  • Value – The actual value assigned to the attribute.

  • Validation Result / Status – Indicates whether the attribute meets the predefined rule for that field.


Understanding Result Indicators

Both messages and attributes are evaluated individually, with results marked as passed or failed. Below, you’ll find an explanation of what each element represents in the current implementation for both levels of information.

 

Passed

Failed

 

Passed

Failed

Message Level

All attributes in this message met the predefined criteria.

At least one attribute in this message did not meet the predefined criteria.

Attribute Level

The attribute meets the predefined criteria.

The attribute does not meet the predefined criteria.

When analyzing messages extracted from a PCAP, AVP Validation applies a set of checks to ensure that each attribute meets predefined criteria. The following checks are currently supported in AGLITY:

At this stage, Attribute Validation checks only whether the required attributes are present in the extracted messages.

  • Presence: Verifies that the attribute exists in the extracted message. enabled

  • Integer: Ensures the attribute’s value is a valid integer. disabled

  • String: Ensures the attribute’s value is a valid string. disabled

  • Range: Confirms that the attribute’s numeric value falls within a specified range. disabled

  • Equals: Checks whether the attribute’s value exactly matches the expected value. disabled

  • Contains: Verifies that the attribute’s value includes the specified substring. disabled

  • Regex: Validates the attribute’s value against a predefined regular expression pattern. disabled

  • JSON: Confirms that the attribute’s value is in a valid JSON format. disabled

  • Maximum Length: Ensures that the attribute’s value does not exceed the defined maximum length. disabled

  • Minimum Length: Ensures that the attribute’s value meets the defined minimum length. disabled


Feature Enablement (Admin Users only)

Admin users can access the Attribute Validation enabling/disabling feature from the Application Settings page within AGILITY:

  1. From the main navigation sidebar, click Applications.

    image-20250505-152744.png
    Main Navigation Menu: Application
  2. At the top of the list, locate the Feature Enablement card.

  3. Click on the Edit button to open the feature page.

image-20250527-140458.png
Applications Settings: Feature Enablement
  1. Click the Edit (✏️) button located near the Attribute Validation dropdown menu under the Feature Enablement page.

image-20250917-143848.png
Attribute Validation: Edit Button
  1. Select "True" from the dropdown list.

image-20250917-144201.png
Attribute Validation: Dropdown selection
  1. Click "Save" to apply your changes.

a. Or, click "Cancel" if you don’t want to make any changes.

image-20250917-144411.png
Feature Enablement: Action buttons
  1. When you save, a successful message will appear to confirm your action.

When this feature is enabled, it may take up to 5 minutes before new analyses have AVP applied. After switching the feature flag to True, refresh the Browser to see the changes.

To Disable the feature Globally

  1. Follow steps 1–2 above.

  2. Select "False" from the dropdown list.

  3. Click "Save" to apply your changes.

    • Or, click "Cancel" if you don’t want to make any changes.


What's Next

  • Interact directly from the Analysis Hub with an improved side panel experience.

  • Identify affected procedures more easily from the Network Plane View.

  • Access detailed packet information for each message within the interface.

  • Enhance rules by adding data type checks, value ranges, and other validation options.

  • Support for IETF and 3GPP standards.

  • Users will be able to define their own rules for attribute validation to meet specific needs.

  • Display interface and procedure details for each message.