Aruba ClearPass
  • 10 Dec 2024
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Aruba ClearPass

  • Dark
    Light
  • PDF

Article summary

Aruba ClearPass is a network access control (NAC) solution that allows enterprises to identify devices, enforce policies, and remediate threats.

Types of Assets Fetched

This adapter fetches the following types of assets:

  • Devices

Parameters

  1. Aruba ClearPass Domain (required) - Use your Aruba ClearPass domain.

  2. Client ID and Client Secret (required) - The client ID and client secret you created to use the Aruba ClearPass API. For more details, see the Create an Aruba ClearPass RestAPI Client section below.

  3. Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

  4. HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

ArubaCLearPass

Advanced Settings

Note:

Advanced settings can either apply for all connections for this adapter, or you can set different advanced settings and/or different scheduling for a specific connection, refer to ​Advanced Configuration for Adapters.

  1. Get extended agent information (required, default: true) - Select whether to fetch extended agent information from the ClearPass agent.

  2. Get device fingerprint information - Select this option to add the fingerprint information to devices.

  3. Do not fetch endpoint devices without 'Last Seen' -

    • If selected, endpoint devices without 'Last Seen' are ignored during the fetch.
    • If cleared, endpoint devices without 'Last Seen' are also fetched by Axonius.
  4. Fetch network devices (required, default: true) -

    • If selected, all connections for this adapter will fetch Network type devices, regardless of the Do not fetch endpoint devices without 'Last Seen' setting.
    • If cleared, all connections for this adapter won’t fetch network devices.
  5. Fetch Endpoint devices (required, default: true) - By default Axonius fetches endpoint devices. Clear this option to not fetch endpoint devices.

  6. Set endpoint devices as network infrastructure device - Select whether to set endpoint devices as network infrastructure devices.

  7. Results per page (required, default: 100) - Set the number of results per page received for a given request to gain better control on the performance of connections for this adapter.

  8. Asynchronous request chunk size (required, default: 100) - Set the number of async requests to do at once.

  9. Wait time between Asynchronous chunks (required, default: 0) - Set how many seconds to wait between each batch of async requests.

  10. Show Only Devices with Attributes - Select this option to fetch only devices with attributes.

Note:

For details on general advanced settings under the Adapter Configuration tab, see Adapter Advanced Settings.

Create an Aruba ClearPass RestAPI Client

You must create a client to use the Aruba ClearPass API. Consider this client as the App definition on Aruba ClearPass. Without this client, access to the API isn't possible.

To create the client

  1. Open Aruba ClearPass Guest and go to Administration –> API Services –> API Clients and click Create API Client.
  2. Provide the following information:
    • Client ID - Creates the connection between the user and the API.
    • Operator Profile - Includes the API Services access rights. Axonius required read-only permissions.
    • Grant Type - Set the OAuth2 authentication method as 'Client Credentials'.
    • Public Client - Make sure this option is cleared.
Note:

Read Only Administrator Operator Profile doesn't give API permissions by default.

  1. Save changes and copy the Client ID and the Client Secret.
  2. Add the IP address of the Axonius instance to the ClearPass API Access List.

Create a ClearPass Profile

To create a Profile in ClearPass

  1. From Operator Logins > Profile, select Edit to edit the profile that the user created.

ClearPAssConfig1.png

  1. From Policy Manager, select Custom.
  2. Allow Read access to the following:
    • Administrator
    • API Services
    • Devices
    • Insight
    • Onboard
    • Platform
    • Policy Manager
Note:

The 'Insight Module' needs to be enabled in order to fetch device IP addresses.



Was this article helpful?