> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-es/integrar-y-administrar/integrations/asset-discovery/armis.md).
# Armis
Conecta tu inquilino de Armis para incorporar a Dispel los activos administrados y no administrados detectados, asignar los sitios de Armis a Wickets y mantener sincronizados los datos de los dispositivos y los hallazgos de vulnerabilidades.
## Resumen
La integración de Armis permite a Dispel extraer los activos que Armis ha descubierto en todo tu entorno —tanto gestionados como no gestionados— e incorporarlos como dispositivos de Dispel. Te conectas a tu tenant de Armis una sola vez, asignas cada sitio de Armis a una instalación y un Wicket de Dispel, y Dispel importa los dispositivos coincidentes y los mantiene actualizados mediante una sincronización recurrente.
Armis es una **de descubrimiento de activos** integración nativa en la nube. No hay ningún appliance local: Dispel se conecta a tu tenant de Armis en la nube y solo lee de él.
#### Qué importa Dispel
* Activos descubiertos (nombre, dirección IP, dirección MAC, marca/modelo, sistema operativo, tipo de dispositivo) como dispositivos de Dispel.
* Protocolos y puertos de red observados para cada activo.
* Un enlace de regreso al activo en Armis, almacenado en el dispositivo.
* **Hallazgos de vulnerabilidades** para cada dispositivo importado, actualizados en cada sincronización.
{% hint style="info" %}
**Dónde encontrarlo.** Inicie sesión como administrador de la organización y abra **Configuración → Integraciones**. Armis aparece en la **Descubrimiento de activos / Visibilidad de red** sección. Haga clic en **Conectar** en la tarjeta de Armis para comenzar.
{% endhint %}
## Antes de comenzar
Necesitarás lo siguiente de tu tenant de Armis:
* Una **clave API** (clave secreta), creada en tu consola de Armis en la configuración de tu API.
* Tu **URL del tenant de Armis** — por ejemplo `https://acme.armis.com`.
{% hint style="warning" %}
**Agregue la IP de Dispel a la lista permitida.** Cuando abre el formulario de conexión, Dispel muestra un **IP de lista blanca** valor. Si tu tenant de Armis restringe el acceso a la API por IP de origen, añade esta dirección a la lista de permitidos para que Dispel pueda conectarse.
{% endhint %}
## Conectando Armis
1. Vaya a **Configuración → Integraciones** y haga clic en **Conectar** en la tarjeta de Armis.
2. Opcionalmente, establezca un **Nombre para mostrar** para distinguir esta integración de otras (puedes conectar más de un tenant de Armis).
3. Complete los campos de conexión:
| Campo | Tipo | Notas |
| --------------------------- | ------------- | --------------------------------------------------------------------------------- |
| **URL del tenant de Armis** | Configuración | La URL base de tu tenant de Armis (p. ej. `https://acme.armis.com`). |
| **Clave API** | Credencial | Tu clave API (secreta) de Armis. Se almacena cifrada y nunca se vuelve a mostrar. |
4. Haga clic en **Probar conexión** para confirmar que Dispel puede autenticarse en Armis. Corrige cualquier error informado antes de guardar.
5. Haga clic en **Guardar**. Dispel guarda la integración y ejecuta de inmediato la sincronización inicial para descubrir tus sitios de Armis.
{% hint style="info" %}
**Sus credenciales están cifradas.** La clave API está cifrada en reposo y no se vuelve a mostrar después de guardar. Al editar más tarde, deje en blanco el campo de credencial para conservar el valor almacenado.
{% endhint %}
## Asignación de sitios a Wickets
Una vez finalizada la sincronización inicial, abra la integración para encontrar la **Asignación de sitios** sección. Armis muestra los sitios configurados en tu tenant, y aquí es donde decides cuáles se convierten en dispositivos de Dispel y dónde se ubican.
> Asigne cada sitio del proveedor a una instalación y un wicket de Dispel. Los dispositivos de los sitios asignados se sincronizarán en Dispel.
Para cada sitio que quieras importar:
1. Elija una **Instalación**.
2. Elija una **Wicket**. Si la instalación tiene solo un Wicket, Dispel lo selecciona por usted.
3. Haga clic en **Guardar asignaciones e importar**.
Dispel procesa cada sitio asignado — verás cómo el progreso de cada sitio pasa de esperando, a obteniendo, a sincronizando, a completado — y luego informa cuántos dispositivos se importaron (por ejemplo, **"12 dispositivos importados"** o un desglose de dispositivos nuevos frente a ya importados). Los dispositivos importados aparecen en el Wicket asignado junto con los dispositivos que haya agregado manualmente.
## Mantener su inventario actualizado
* Dispel **vuelve a sincronizar automáticamente** según un horario recurrente, de modo que los activos descubiertos recientemente y los detalles modificados se recogen sin que tengas que hacer nada.
* Para obtener el inventario más reciente de inmediato, abra la integración y elija **Actualizar**.
* Para cambiar los detalles de conexión o rotar las credenciales, edite la integración y use **Guardar y sincronizar**. Deje en blanco el campo de credencial para conservar la clave actual.
## Hallazgos de vulnerabilidades
Armis informa de vulnerabilidades conocidas para los activos que supervisa. Después de cada sincronización correcta, Dispel extrae los hallazgos de vulnerabilidades de tus dispositivos importados y los adjunta a esos dispositivos, para que puedas ver los problemas conocidos de un dispositivo sin salir de Dispel. Los hallazgos se actualizan en cada sincronización, y los hallazgos resueltos desaparecen automáticamente.
## Estado de conexión
Cada integración muestra un estado para que siempre sepa en qué punto se encuentra:
| Estado | Significado |
| -------------------------- | -------------------------------------------------------------------------------------- |
| **No inicializado** | Guardado, pero la primera sincronización aún no se ha ejecutado. |
| **Inicializando** | Ejecutando la primera sincronización y descubriendo sitios. |
| **Listo** | Conectado y sincronizado; se aplican las asignaciones. |
| **Necesita actualización** | Hay nuevos datos del proveedor disponibles; ejecute una actualización para obtenerlos. |
| **Actualizando** | Hay una sincronización en curso. |
| **Cambios pendientes** | Los cambios de asignación se han guardado pero aún no se han aplicado. |
| **Aplicando** | Importando dispositivos para tus asignaciones guardadas. |
| **Fallido** | La última operación falló; consulte la guía del error. |
Una **insignia de estado** (Conectado, Degradado, Inalcanzable) refleja si Dispel puede alcanzar actualmente la API de Armis.
## Solución de problemas
Si una sincronización o una prueba de conexión falla, Dispel clasifica el error y sugiere una solución:
| Error | Qué suele significar y cómo solucionarlo |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Falló la autenticación** | La clave de API fue rechazada. Es posible que la clave se haya rotado, expirado o revocado; genera una nueva y actualiza la integración. |
| **Endpoint inalcanzable** | Dispel no pudo alcanzar la API. Verifica la URL del tenant y que la IP de Dispel esté en la lista de permitidos si tu tenant restringe el acceso a la API. |
| **Se agotó el tiempo de conexión** | Armis tardó demasiado en responder — normalmente una latencia de red transitoria. |
| **Límite de tasa** | Armis limitó las solicitudes. La próxima sincronización programada debería funcionar. |
| **Error de configuración** | La URL del tenant parece incorrecta. Vuelve a comprobar que apunte a tu tenant de Armis. |
## Preguntas frecuentes
¿Puedo conectar más de un tenant de Armis?
Sí. Armis admite varias integraciones, así que puedes conectar varios tenants en paralelo. Dale a cada uno un nombre distinto **Nombre para mostrar** para distinguirlas.
¿Hay una opción local para Armis?
No. Armis es una plataforma en la nube, así que Dispel siempre se conecta a tu tenant de Armis a través de Internet. No hay ningún appliance al que apuntar.
¿Conectar Armis cambia algo en mi tenant de Armis?
No. Dispel solo lee de Armis. Nunca crea, modifica ni elimina datos del lado de Armis.
¿Con qué rapidez aparecen los nuevos activos?
Los nuevos activos aparecen en la siguiente sincronización — automáticamente según el horario recurrente, o de inmediato si eliges **Actualizar**.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.dispel.com/documentation/documentation-es/integrar-y-administrar/integrations/asset-discovery/armis.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.