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

# Integración con ServiceNow: descripción general

> Sincroniza el inventario de dispositivos Apple de Iru Endpoint con ServiceNow en tiempo real mediante OAuth 2.0, con sincronización nocturna opcional de datos de apps para tenants con SAM Pro.

### Acerca de la integración con ServiceNow

La integración con ServiceNow envía el inventario de dispositivos Apple de Iru Endpoint a ServiceNow en tiempo real para que tus registros de ServiceNow se mantengan actualizados.

Si tu tenant de ServiceNow tiene licencia de Software Asset Management Professional (SAM Pro), también puedes enviar cada noche datos de instalación y uso de aplicaciones.

### Cómo funciona

La integración conecta Iru Endpoint con tu instancia de ServiceNow mediante OAuth 2.0 con una cuenta de servicio dedicada.

**Autenticación**: OAuth 2.0 con una cuenta de servicio en ServiceNow.

**Sincronización de datos**: Iru Endpoint detecta los dispositivos Apple administrados y sincroniza con ServiceNow campos como el número de serie, el modelo, la versión del sistema operativo y el usuario asignado. Con SAM Pro, también puedes enviar cada noche datos de inventario y uso de aplicaciones.

### Resumen de la configuración

Sigue estos pasos de un vistazo.

<Steps>
  <Step title="Instalar la app de ServiceNow">
    Instala la [app Kandji ServiceNow](https://store.servicenow.com/sn_appstore_store.do#!/store/application/e330778897bfe150f89bf7021153af52/1.0.0?referer=%2Fstore%2Fsearch%3Flistingtype%3Dallintegrations%25253Bancillary_app%25253Bcertified_apps%25253Bcontent%25253Bindustry_solution%25253Boem%25253Butility%25253Btemplate%25253Bgenerative_ai%25253Bsnow_solution%26q%3Dkandji\&sl=sh) en el integration hub de ServiceNow.
  </Step>

  <Step title="Configurar el cliente OAuth">
    Configura una app cliente OAuth para que Iru Endpoint pueda llamar a la Import Set API de ServiceNow.
  </Step>

  <Step title="Crear un usuario de ServiceNow">
    Crea una cuenta de usuario de ServiceNow que pueda acceder a la API de ServiceNow.
  </Step>

  <Step title="Configurar la integración en Iru Endpoint">
    En Iru Endpoint, completa la integración con ServiceNow usando la app OAuth y la cuenta de servicio que creaste.
  </Step>
</Steps>

Cuando se completa la configuración, Iru Endpoint comienza a enviar datos de activos de dispositivos a ServiceNow.

<Warning>
  El usuario asignado en Iru Endpoint ya debe existir en ServiceNow para que aparezca en el registro del equipo.
</Warning>

### Flujo de datos de alto nivel

Cuando un dispositivo se inscribe en Iru Endpoint o su registro cambia, la integración hace lo siguiente:

<Steps>
  <Step title="Detectar cambios">
    Iru Endpoint detecta cambios en el inventario de dispositivos. Si activaste la sincronización de apps de SAM Pro en Iru Endpoint, el inventario y el uso de apps se preparan cada noche.
  </Step>

  <Step title="Enviar a las tablas de staging">
    Iru Endpoint envía estos cambios a las tablas de staging de ServiceNow mediante la Import Set API de ServiceNow.
  </Step>

  <Step title="Transformar los datos">
    Para los datos de dispositivos, ServiceNow ejecuta un [transform map](https://www.servicenow.com/docs/r/zurich/integrate-applications/system-import-sets/c_CreatingNewTransformMaps.html) para asignar las columnas de staging a las tablas de destino. Los datos de aplicaciones usan una [definición ETL](https://www.servicenow.com/docs/r/zurich/integrate-applications/system-import-sets/etl-definition-overview.html) con el [Robust Transform Engine](https://www.servicenow.com/docs/r/zurich/integrate-applications/system-import-sets/define-rte-operations.html).
  </Step>

  <Step title="Actualizar registros">
    Luego, ServiceNow crea o actualiza los registros de dispositivos y de MDM, y también puede actualizar los registros de instalación y uso de software cuando la sincronización de datos de SAM Pro está habilitada.
  </Step>
</Steps>

```mermaid actions={false} theme={null}
%%{init: {'theme': 'base', 'themeVariables': { 'lineColor': '#8b93a6', 'primaryTextColor': '#1f2937', 'fontSize': '13px'}}}%%
flowchart TD
    A["Iru Endpoint (externo)<br/>API / exportación / integración"] --> B["ServiceNow - staging<br/>Import set: MDM"]
    A --> C["ServiceNow - staging<br/>Import set: Computer"]
    A --> D["ServiceNow - staging<br/>Import set: Apps"]

    B --> E["Carril MDM<br/>Transform: Iru Endpoint MDM Transformer"]
    E --> F["x_kandj_kandji_mdm"]

    C --> G["Carril de equipos<br/>Transform: Iru Endpoint CI Transformer"]
    G --> H["CMDB IRE<br/>discovery_source = Kandji"]
    H --> I["cmdb_ci_computer"]

    D --> J["Carril de apps: RTE y luego ETL<br/>Iru Endpoint Apps RTE"]
    J --> K["Iru Endpoint Apps ETL"]
    K --> L["ETL: Import"]
    L --> M["ETL: Temp"]
    M --> N["cmdb_sam_sw_install"]

    N --> O["Uso de SAM<br/>Programado: Software Usage Publisher"]
    O --> P["samp_sw_usage"]

    I -. "Resolución de CI para instalaciones" .-> J

    classDef source fill:#eef6ff,stroke:#3b82f6,stroke-width:1.5px,color:#1f2937;
    classDef mdm fill:#f5f3ff,stroke:#8b5cf6,stroke-width:1.5px,color:#1f2937;
    classDef computer fill:#ecfdf5,stroke:#10b981,stroke-width:1.5px,color:#1f2937;
    classDef apps fill:#fff7ed,stroke:#f97316,stroke-width:1.5px,color:#1f2937;
    classDef usage fill:#fef9c3,stroke:#ca8a04,stroke-width:1.5px,color:#1f2937;

    class A source;
    class B,E,F mdm;
    class C,G,H,I computer;
    class D,J,K,L,M,N apps;
    class O,P usage;
```

### Tablas de ServiceNow

Las siguientes tablas se usan en la integración de Iru Endpoint con ServiceNow.

| <Icon icon="list-check" size={14} /> **Tabla** | <Icon icon="circle-info" size={14} /> **Descripción** |
| - | - |
| `cmdb_ci_computer` | Tabla integrada de ServiceNow con detalles de hardware de dispositivos Mac, iPhone, iPad y tvOS. |
| `cmdb_sam_sw_install` | Tabla de ServiceNow SAM Pro que se usa para registrar instalaciones de software cuando la sincronización del inventario y uso de apps está habilitada en Iru Endpoint. |
| `samp_sw_usage` | Tabla de uso de ServiceNow SAM Pro que se completa mediante un trabajo nocturno de publicación de uso en ServiceNow. |
| `x_kandj_kandji_mdm` | Tabla personalizada creada por Iru Endpoint para almacenar datos adicionales relacionados con MDM sobre los activos de dispositivos. |
| `x_kandj_kandji_kandji_import_set_computer` | Tabla de staging de import set que se usa para preparar la información de activos de dispositivos antes de enviarla a la tabla `cmdb_ci_computer`. |
| `x_kandj_kandji_kandji_import_set_mdm` | Tabla de staging de import set que se usa para preparar la información de activos de dispositivos relacionada con MDM antes de enviarla a la tabla `x_kandj_kandji_mdm`. |
| `x_kandj_kandji_kandji_import_set_apps` | Tabla de staging de import set que se usa para preparar la información de inventario y uso de aplicaciones antes del procesamiento RTE/ETL. |

### Atributos de dispositivos de Iru Endpoint

Iru Endpoint envía los campos de activos de dispositivos que se indican a continuación. Es posible que se agreguen más campos con el tiempo.

#### Tabla: `cmdb_ci_computer`

| <Icon icon="tag" size={14} /> **Iru Endpoint** | <Icon icon="list-check" size={14} /> **ServiceNow** | <Icon icon="circle-info" size={14} /> **Descripción** |
| - | - | - |
| `assigned_user` | `assigned_to` | Usuario asignado al activo del dispositivo |
| `device_capacity` | `disk_space` | Capacidad total de almacenamiento |
| `device_name` | `name` | Nombre del dispositivo |
| `Discovery source` (no se muestra en Iru) | `discovery_source` | Valor constante establecido en "Kandji" |
| `model_name` | `model` | Nombre del modelo del dispositivo |
| `os_type` | `os` | Nombre del sistema operativo (por ejemplo, macOS, iOS, iPadOS o tvOS) |
| `os_version` | `os_version` | Versión del sistema operativo |
| `serial_number` | `serial_number` | Número de serie del dispositivo; también se usa para hacer coincidir (coalesce) el registro de la tabla de equipos en ServiceNow |
| `manufacturer` | `manufacturer` | Valor constante establecido en "Apple" |

#### Tabla: `x_kandj_kandji_mdm`

| <Icon icon="tag" size={14} /> **Iru Endpoint** | <Icon icon="list-check" size={14} /> **ServiceNow** | <Icon icon="circle-info" size={14} /> **Descripción** |
| - | - | - |
| `device_id` | `kandji_device_id` | ID del dispositivo en Iru Endpoint |
| `blueprint_id` | `kandji_blueprint_id` | ID del Blueprint en Iru Endpoint; también se usa para hacer coincidir (coalesce) el registro de la tabla MDM en ServiceNow. |
| `serial_number` | `computer` | Hace referencia al registro de CI del equipo en ServiceNow. |
| `Discovery source` (no se muestra en Iru) | `discovery_source` | Valor constante establecido en "Kandji" |

#### Tabla: `cmdb_sam_sw_install`

| <Icon icon="tag" size={14} /> **Iru Endpoint (Prism)** | <Icon icon="list-check" size={14} /> **ServiceNow** | <Icon icon="circle-info" size={14} /> **Descripción** |
| - | - | - |
| `App ID` (no se muestra en Iru) | `instance_key` | Clave única que se usa para identificar un software en un dispositivo específico |
| `name` | `name` | Nombre de la app |
| `developer_name` | `publisher` | Desarrollador del software |
| `version` | `version` | Versión del software |
| `path` | `install_location` | Ruta de instalación en el dispositivo |
| `serial_number` | `installed_on` | Referencia al registro de CI del equipo |
| `last_opened` | `last_used` | Fecha en que se usó el software por última vez |
| `is_removed` (las apps eliminadas no se muestran en Iru) | `active` | **Instalación activa** en `cmdb_sam_sw_install`: `true` mientras la app está en el dispositivo; `false` cuando Iru informa que se eliminó. Las apps eliminadas se siguen sincronizando con `active` = `false` para que ServiceNow conserve la fila de instalación como historial (consulta [Inventario de aplicaciones](#application-inventory)). |
| `Discovery source` (no se muestra en Iru) | `discovery_source` | Valor constante establecido en "Kandji" |

#### Tabla: `samp_sw_usage`

| <Icon icon="list-check" size={14} /> **ServiceNow** | <Icon icon="circle-info" size={14} /> **Descripción** |
| - | - |
| `configuration_item` | Referencia al registro de CI del equipo |
| `norm_product` | Registro normalizado de la app en ServiceNow |
| `reclamation_type` | `'last_used'`. Iru completa las entradas de `last_used`. |
| `last_used_time` | Fecha y hora en que se usó el software por última vez. Iru envía aquí solo fechas para evitar tablas personalizadas adicionales en ServiceNow. |

### Inventario de aplicaciones

<Note>
  Cuando el inventario de aplicaciones está habilitado, Iru Endpoint sigue enviando a ServiceNow las apps eliminadas con `active` establecido en `false`. ServiceNow conserva esas filas de instalación como historial en lugar de eliminarlas cuando la app sale del dispositivo.
</Note>

## Consideraciones

<CardGroup cols={2}>
  <Card title="Usuarios asignados en ServiceNow" icon="user">
    Para que el registro del equipo en ServiceNow muestre el usuario asignado en Iru Endpoint, esa persona ya debe existir en ServiceNow.
  </Card>

  <Card title="Sincronización del inventario de dispositivos" icon="arrows-rotate">
    El inventario de dispositivos se sincroniza en tiempo real. Los datos de inventario y uso de apps se sincronizan cada noche cuando esa opción está habilitada.
  </Card>

  <Card title="Inventario de aplicaciones" icon="layer-group">
    SAM Pro debe tener licencia en ServiceNow y debes habilitar la opción en la configuración de la integración de Iru Endpoint. Las apps eliminadas se siguen sincronizando con `active` = `false` para que ServiceNow conserve las filas históricas de instalación en lugar de eliminarlas.
  </Card>

  <Card title="Vencimiento de credenciales y reautenticación" icon="bell">
    Cuando las credenciales OAuth de ServiceNow están por vencer, Iru Endpoint muestra un banner en el tenant y envía recordatorios por correo electrónico a los miembros del equipo con permisos de Admin o Account Owner a partir de 30 días antes del vencimiento. Vuelve a autenticarte desde la [página de detalles de la integración con ServiceNow](/es/endpoint/integrations/servicenow/servicenow-integration-iru-endpoint-configuration#reauthentication) en Iru Endpoint.
  </Card>

  <Card title="Tablas en ServiceNow" icon="table">
    La integración escribe en tablas integradas de ServiceNow y en tablas personalizadas de Kandji para que las vistas de CMDB y MDM estén completas.
  </Card>

  <Card title="Import Set API" icon="plug">
    Los datos se transfieren mediante la Import Set API y los flujos de transformación de ServiceNow.
  </Card>
</CardGroup>

### Artículos relacionados

<CardGroup cols={2}>
  <Card title="Integración con ServiceNow: configuración de ServiceNow" icon="wrench" href="/es/endpoint/integrations/servicenow/servicenow-integration-servicenow-configuration">
    Instala la app Kandji ServiceNow, crea un cliente OAuth y una cuenta de servicio, y verifica la fuente de detección (discovery source) en ServiceNow.
  </Card>

  <Card title="Integración con ServiceNow: configuración de Iru Endpoint" icon="plug" href="/es/endpoint/integrations/servicenow/servicenow-integration-iru-endpoint-configuration">
    Conecta Iru Endpoint con tu tenant, ingresa las credenciales de OAuth y de la cuenta de servicio y, opcionalmente, habilita el inventario y uso nocturno de apps para SAM Pro.
  </Card>
</CardGroup>