> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Aruba Switch

> Connect an Aruba (AOS-CX / ArubaOS-Switch) switch to Myrmex over SSH — create the CLI account and add the integration.

import { Note, Steps, Step, CardGroup, Card, Tip } from '@mintlify/components';

Connect your **Aruba** switch (AOS-CX or ArubaOS-Switch) so Myrmex can read the running configuration, document the device, and — with approval — run CLI operations. Myrmex reaches the switch over **SSH** through a [Collector](/documentation/agent-endpoint-security/collector-mode) on your network and queries it in real time.

## What Myrmex Can Do

<CardGroup cols={2}>
  <Card title="Read & document" icon="magnifying-glass">
    Run show commands to inspect ports, VLANs, and the running configuration — read on demand.
  </Card>

  <Card title="Port operations" icon="terminal">
    Execute port and configuration commands, with changes applied on approval.
  </Card>

  <Card title="Inventory" icon="network-wired">
    Track the switch model, OS version, and interfaces — nothing stored on the Myrmex side.
  </Card>
</CardGroup>

## Before You Start

* A **Collector** that can reach the switch's management IP over SSH. See [Deploying the agent](/documentation/agent-endpoint-security/installation) and [Collector mode](/documentation/agent-endpoint-security/collector-mode).
* An **account with CLI access** to the device — read-only is enough for analysis; read-write is required to run configuration changes.

## Step 1 — Create the Credential in Aruba

<Steps>
  <Step title="Enable SSH">
    On AOS-CX, the SSH server is enabled by default on the management VRF — confirm it is running. On ArubaOS-Switch, generate host keys with `crypto key generate ssh` and enable SSH with `ip ssh`.
  </Step>

  <Step title="Create a user">
    Create a user for Myrmex with a strong password. On AOS-CX, assign the `administrators` group for read-write or `operators` for read-only. On ArubaOS-Switch, create a manager-level account for read-write, or an operator account for analysis. Note the username and password.
  </Step>
</Steps>

<Tip>
  Prefer least privilege: start with an operator/read-only account, and grant manager/administrator access only when you want the agents to run changes for you.
</Tip>

## Step 2 — Add the Integration in Myrmex

From the [Directory](/documentation/ai-workspace/overview#the-directory), choose **Add Integration → Aruba Switch**, then fill in:

| Field           | Description                                                                                           |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| **Name**        | A unique name for this switch.                                                                        |
| **Description** | Optional note to identify the device.                                                                 |
| **IP**          | The IP address or hostname of the Aruba switch the Collector can reach.                               |
| **SSH Port**    | The SSH port (default `22`).                                                                          |
| **Username**    | The Aruba SSH username with manager/admin (or operator) privileges from Step 1.                       |
| **Password**    | The SSH password for the user.                                                                        |
| **Model**       | Your Aruba switch model series (CX or ArubaOS).                                                       |
| **Version**     | The Aruba OS version running on the device, or **Other**.                                             |
| **Collector**   | The [Collector](/documentation/agent-endpoint-security/collector-mode) that opens the SSH connection. |

## Connect

Click **Connect** to validate the SSH connection and finish. The switch then appears under **Environment → Integrations**, and you can ask the [Integration Specialist](/documentation/multi-agent-system/integration-specialist-agent) about it in the Workspace.

<Note>
  Myrmex queries the switch in real time over SSH and acts only on approval. It does not store or retain the device's configuration or data on the Myrmex side.
</Note>