Aruba ClearPass icon

Aruba ClearPass

Interact with Aruba ClearPass API

Actions34

Devices → Get By MAC

AI-generated

Overview

This node interacts with the Aruba ClearPass API to retrieve device information based on a MAC address within the 'Devices' resource under the 'Identities' domain. It is useful for scenarios where you need to fetch detailed data about a specific device registered in the ClearPass system by providing its MAC address, such as in network management, security auditing, or device tracking.

Use Case Examples

  1. Retrieve device details by MAC address to verify device identity and status in a network.
  2. Fetch device information to automate network access policies based on device attributes.

Properties

Name Meaning
Domain Specifies the API domain to access, such as 'Identities' for device-related data.
MAC Address The MAC address of the device account to retrieve information for. This is required and must be provided when the domain is 'Identities' and the resource is 'Device' with the operation 'Get By MAC'.

Output

JSON

  • deviceDetails - The JSON object containing the details of the device retrieved by the MAC address from the ClearPass API.

Dependencies

  • Aruba ClearPass API
  • An API key credential for ClearPass API authentication

Troubleshooting

  • Ensure the MAC address is correctly formatted and exists in the ClearPass system; otherwise, the node may return an error or empty result.
  • Verify that the API credentials are valid and have sufficient permissions to access the 'Identities' domain and 'Device' resource.
  • Common error messages may include authentication failures, resource not found, or invalid MAC address format. Resolving these involves checking credentials, input values, and API endpoint availability.

Links

Discussion