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.1
Acceder a la tienda de ServiceNow
Ve a la tienda de ServiceNow.
2
Buscar la app Kandji ServiceNow
En la tienda, busca Kandji para encontrar la Kandji ServiceNow app.
3
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.
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.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.
1
Acceder a ServiceNow
Con una cuenta de administrador de ServiceNow, inicia sesión en tu tenant de ServiceNow (.service-now.com).
2
Ir a System OAuth
En el Filter navigator, busca System OAuth.
3
Abrir Application Registry
Selecciona Application Registry.
4
Crear el endpoint OAuth
Selecciona Create an OAuth API endpoint for external clients.
5
Configurar la app OAuth
Asigna un nombre a la app OAuth (por ejemplo,
kandji_oauth_api).6
Establecer la URL de redirección
En el campo Redirect URL, ingresa https://kandji.io.
7
Enviar la configuración
Selecciona Enviar.
8
Acceder a la app OAuth
Vuelve a la app OAuth que acabas de crear.
9
Copiar el Client ID
Resalta y copia el Client ID.
10
Mostrar el Client Secret
Muestra el Client Secret seleccionando el candado.
11
Copiar el Client Secret
Copia el Client Secret. Si estableciste tu propio client secret, selecciona Actualizar para guardarlo.
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.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.
1
Acceder a ServiceNow
Con una cuenta de administrador de ServiceNow, inicia sesión en tu tenant de ServiceNow (.service-now.com).
2
Ir a Users
En el Filter navigator, busca Usuarios.
3
Abrir User Administration
En User Administration, selecciona Usuarios.
4
Crear un usuario nuevo
Selecciona New para agregar un usuario nuevo.
5
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.
6
Establecer el acceso a servicios web
Selecciona Web service access only.
7
Enviar la creación del usuario
Selecciona Enviar.
8
Establecer la contraseña del usuario
Abre el usuario que acabas de crear y selecciona Set Password.
9
Generar la contraseña
Selecciona Generar para crear la nueva contraseña.
10
Copiar la contraseña
Copia la nueva contraseña.
11
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.
12
Cerrar el diálogo de contraseña
Selecciona Cerrar para volver a la página Users.
13
Acceder a los roles del usuario
Sin salir de la página del usuario, ve a Roles.
14
Editar roles
Selecciona Editar.
15
Agregar los roles requeridos
Agrega los siguientes roles al usuario de la cuenta de servicio:
- cmdb_read
- import_transformer
- rest_api_explorer
16
Verificar la asignación de roles
Deberías ver seis roles en total: tres que agregaste directamente y tres heredados.
17
Guardar la configuración del usuario
Para completar la creación del usuario, selecciona Guardar.
Solución de problemas
Verificar que Kandji sea una fuente de detección
1
Acceder a Dictionary
En ServiceNow, ingresa Dictionary en el Filter navigator.
2
Abrir Dictionary
En System Definition, selecciona Dictionary.
3
Buscar la fuente de detección
En Dictionary Entries, selecciona Column name e ingresa discovery_source.
4
Seleccionar la tabla CMDB
Selecciona la tabla cmdb_ci.
5
Acceder a la pestaña Choices
Desplázate hacia abajo y selecciona la pestaña Choices.
6
Verificar Kandji
Confirma que Kandji aparezca en la lista. Si no aparece, busca la etiqueta Kandji.
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.1
Acceder a Fix Scripts
En ServiceNow, ingresa Fix Script en el Filter navigator.
2
Abrir Fix Scripts
En System Definition, selecciona Fix Scripts.
3
Buscar el fix script
En Fix Scripts, selecciona Nombre e ingresa kandji_fix_script.
4
Seleccionar el fix script
Abre el registro kandji_fix_script.
5
Ejecutar el fix script
Selecciona Run Fix Script.
6
Ejecutar en segundo plano
En el modal Run Fix Script, selecciona Proceed in Background.
Consideraciones
Cuentas de servicio
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.
OAuth
En Zurich y versiones posteriores, establece Scope Restriction en Broadly scoped cuando crees la app OAuth (consulta Crear una app OAuth). Establece la URL de redirección en
https://kandji.io y guarda las credenciales del cliente de forma segura.Roles
La cuenta de servicio necesita cmdb_read, import_transformer y rest_api_explorer.
Fuente de detección
Después de la instalación, confirma que Kandji aparezca entre las opciones de fuente de detección para cmdb_ci en Dictionary.
Solución de problemas
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.
Artículos relacionados
Integración con ServiceNow: descripción general
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.
Integración con ServiceNow: configuración de Iru Endpoint
Conecta Iru Endpoint con tu app OAuth y tu cuenta de servicio, y administra la integración una vez que ServiceNow esté listo.