> ## 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: configuración de ServiceNow

> Instala la app Kandji ServiceNow, crea credenciales OAuth y una cuenta de servicio, y verifica la configuración de la fuente de detección para la integración con Iru Endpoint.

### Instalar la app Kandji ServiceNow

Si la app aún no está instalada, instala la app Kandji ServiceNow en tu instancia de ServiceNow. La instalación agrega las dependencias que tu tenant necesita para la integración.

<Steps>
  <Step title="Acceder a la tienda de ServiceNow">
    Ve a la [tienda de ServiceNow](https://store.servicenow.com/sn_appstore_store.do#!/store/home).
  </Step>

  <Step title="Buscar la app Kandji ServiceNow">
    En la tienda, busca **Kandji** para encontrar la **Kandji ServiceNow app**.
  </Step>

  <Step title="Instalar la app Kandji ServiceNow">
    Instala la app Kandji ServiceNow seleccionando **Get**. Inicia sesión en la tienda de ServiceNow si se te solicita. La cuenta que uses debe tener permiso para instalar apps de la tienda de Integration Hub.
  </Step>
</Steps>

### Crear una app OAuth

Iru Endpoint usa un cliente de API OAuth de ServiceNow con el tipo de concesión **Resource Owner Password Credentials (ROPC)** para obtener tokens de acceso y de actualización para tu instancia.

<Note>
  En ServiceNow **Zurich** y versiones posteriores, establece **Scope Restriction** en **Broadly scoped** cuando crees el endpoint de API OAuth para clientes externos. Si este campo se establece en un alcance más limitado, las llamadas de API entrantes desde Iru Endpoint pueden fallar con errores como *OAuth client does not have unrestricted access to unscoped APIs is not allowed*. Para obtener más información, consulta el artículo de ServiceNow [KB2731346](https://support.servicenow.com/kb?id=kb_article_view\&sysparm_article=KB2731346).
</Note>

<Steps>
  <Step title="Acceder a ServiceNow">
    Con una cuenta de administrador de ServiceNow, inicia sesión en tu tenant de ServiceNow ({yourtenant}.service-now\.com).
  </Step>

  <Step title="Ir a System OAuth">
    En el **Filter navigator**, busca **System OAuth**.
  </Step>

  <Step title="Abrir Application Registry">
    Selecciona **Application Registry**.
  </Step>

  <Step title="Crear el endpoint OAuth">
    Selecciona **Create an OAuth API endpoint for external clients**.
  </Step>

  <Step title="Configurar la app OAuth">
    Asigna un nombre a la app OAuth (por ejemplo, `kandji_oauth_api`).
  </Step>

  <Step title="Establecer la URL de redirección">
    En el campo **Redirect URL**, ingresa [**https://kandji.io**](https://kandji.io).
  </Step>

  <Step title="Enviar la configuración">
    Selecciona **Enviar**.
  </Step>

  <Step title="Acceder a la app OAuth">
    Vuelve a la app OAuth que acabas de crear.
  </Step>

  <Step title="Copiar el Client ID">
    Resalta y copia el **Client ID**.
  </Step>

  <Step title="Mostrar el Client Secret">
    Muestra el **Client Secret** seleccionando el candado.
  </Step>

  <Step title="Copiar el Client Secret">
    Copia el **Client Secret**. Si estableciste tu propio client secret, selecciona **Actualizar** para guardarlo.
  </Step>
</Steps>

### Agregar una cuenta de servicio

Las credenciales del usuario de la cuenta de servicio se usan para configurar la integración con ServiceNow en Iru Endpoint.

<Note>
  Se puede usar cualquier cuenta de usuario de ServiceNow siempre que tenga acceso a los servicios web y los roles **cmdb\_read**, **import\_transformer** y **rest\_api\_explorer**. Cuando sea posible, crea una cuenta de servicio dedicada para esta integración.
</Note>

<Steps>
  <Step title="Acceder a ServiceNow">
    Con una cuenta de administrador de ServiceNow, inicia sesión en tu tenant de ServiceNow ({yourtenant}.service-now\.com).
  </Step>

  <Step title="Ir a Users">
    En el **Filter navigator**, busca **Usuarios**.
  </Step>

  <Step title="Abrir User Administration">
    En User Administration, selecciona **Usuarios**.
  </Step>

  <Step title="Crear un usuario nuevo">
    Selecciona **New** para agregar un usuario nuevo.
  </Step>

  <Step title="Configurar los detalles del usuario">
    Ingresa un nombre descriptivo para el usuario (por ejemplo, `kandji_rest_api_user`). Copia el nombre de usuario en una ubicación segura. Lo necesitarás cuando configures la integración en Iru Endpoint.

    * Opcionalmente, ingresa cualquier información adicional que requiera tu organización.
  </Step>

  <Step title="Establecer el acceso a servicios web">
    Selecciona **Web service access only**.
  </Step>

  <Step title="Enviar la creación del usuario">
    Selecciona **Enviar**.
  </Step>

  <Step title="Establecer la contraseña del usuario">
    Abre el usuario que acabas de crear y selecciona **Set Password**.
  </Step>

  <Step title="Generar la contraseña">
    Selecciona **Generar** para crear la nueva contraseña.
  </Step>

  <Step title="Copiar la contraseña">
    Copia la nueva contraseña.
  </Step>

  <Step title="Guardar la contraseña">
    Selecciona **Save Password**. Guarda la contraseña en una ubicación segura. La ingresarás en Iru Endpoint cuando configures la integración con ServiceNow.
  </Step>

  <Step title="Cerrar el diálogo de contraseña">
    Selecciona **Cerrar** para volver a la página Users.
  </Step>

  <Step title="Acceder a los roles del usuario">
    Sin salir de la página del usuario, ve a **Roles**.
  </Step>

  <Step title="Editar roles">
    Selecciona **Editar**.
  </Step>

  <Step title="Agregar los roles requeridos">
    Agrega los siguientes roles al usuario de la cuenta de servicio:

    * cmdb\_read
    * import\_transformer
    * rest\_api\_explorer
  </Step>

  <Step title="Verificar la asignación de roles">
    Deberías ver seis roles en total: tres que agregaste directamente y tres heredados.
  </Step>

  <Step title="Guardar la configuración del usuario">
    Para completar la creación del usuario, selecciona **Guardar**.
  </Step>
</Steps>

### Solución de problemas

#### Verificar que Kandji sea una fuente de detección

<Steps>
  <Step title="Acceder a Dictionary">
    En ServiceNow, ingresa **Dictionary** en el **Filter navigator**.
  </Step>

  <Step title="Abrir Dictionary">
    En System Definition, selecciona **Dictionary**.
  </Step>

  <Step title="Buscar la fuente de detección">
    En Dictionary Entries, selecciona **Column name** e ingresa **discovery\_source**.
  </Step>

  <Step title="Seleccionar la tabla CMDB">
    Selecciona la tabla **cmdb\_ci**.
  </Step>

  <Step title="Acceder a la pestaña Choices">
    Desplázate hacia abajo y selecciona la pestaña **Choices**.
  </Step>

  <Step title="Verificar Kandji">
    Confirma que **Kandji** aparezca en la lista. Si no aparece, busca la etiqueta **Kandji**.
  </Step>
</Steps>

#### Si Kandji no aparece como fuente de detección

Ejecuta **kandji\_fix\_script** manualmente si **Kandji** no aparece como fuente de detección después de instalar la app Kandji ServiceNow.

<Steps>
  <Step title="Acceder a Fix Scripts">
    En ServiceNow, ingresa **Fix Script** en el **Filter navigator**.
  </Step>

  <Step title="Abrir Fix Scripts">
    En System Definition, selecciona **Fix Scripts**.
  </Step>

  <Step title="Buscar el fix script">
    En Fix Scripts, selecciona **Nombre** e ingresa **kandji\_fix\_script**.
  </Step>

  <Step title="Seleccionar el fix script">
    Abre el registro **kandji\_fix\_script**.
  </Step>

  <Step title="Ejecutar el fix script">
    Selecciona **Run Fix Script**.
  </Step>

  <Step title="Ejecutar en segundo plano">
    En el modal Run Fix Script, selecciona **Proceed in Background**.
  </Step>
</Steps>

Kandji debería aparecer ahora como una opción de fuente de detección en ServiceNow.

## Consideraciones

<CardGroup cols={2}>
  <Card title="Cuentas de servicio" icon="user">
    Es preferible usar una cuenta dedicada para esta integración en lugar de reutilizar un usuario interactivo, para que el acceso y los cambios sean más fáciles de auditar.
  </Card>

  <Card title="OAuth" icon="key">
    En **Zurich** y versiones posteriores, establece **Scope Restriction** en **Broadly scoped** cuando crees la app OAuth (consulta [Crear una app OAuth](#creating-an-oauth-app)). Establece la URL de redirección en `https://kandji.io` y guarda las credenciales del cliente de forma segura.
  </Card>

  <Card title="Roles" icon="shield">
    La cuenta de servicio necesita **cmdb\_read**, **import\_transformer** y **rest\_api\_explorer**.
  </Card>

  <Card title="Fuente de detección" icon="magnifying-glass">
    Después de la instalación, confirma que **Kandji** aparezca entre las opciones de fuente de detección para **cmdb\_ci** en Dictionary.
  </Card>

  <Card title="Solución de problemas" icon="wrench">
    Si la fuente de detección o la sincronización no se ven correctas, ejecuta el fix script **kandji\_fix\_script** y confirma que la cuenta de servicio tenga los tres roles anteriores.
  </Card>
</CardGroup>

### Artículos relacionados

<CardGroup cols={2}>
  <Card title="Integración con ServiceNow: descripción general" icon="book-open" href="/es/endpoint/integrations/servicenow/servicenow-integration-overview">
    Cómo fluye el inventario de Iru Endpoint a las tablas y transformaciones de ServiceNow, y cómo fluyen los datos de SAM Pro cuando están habilitados.
  </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 app OAuth y tu cuenta de servicio, y administra la integración una vez que ServiceNow esté listo.
  </Card>
</CardGroup>