Autenticación de ServiceNow

UiPath admite los siguientes tipos de autenticación para ServiceNow:

Tipo de Autenticación	Descripción	Mejor para
Básico (nombre de usuario/contraseña)	Inicio de sesión directo con un usuario de ServiceNow a través de la autenticación básica HTTPS.	Configuraciones simples, sin OAuth, perfectas para pruebas de concepto rápidas
Código de autorización OAuth 2.0	El usuario inicia sesión en ServiceNow y concede acceso a un cliente OAuth configurado en ServiceNow.	Escenarios delegados por el usuario en producción que necesitan un control sólido y una revocación fácil.
Concesión de contraseña OAuth 2.0	Nombre de usuario/contraseña de la cuenta de servicio más credenciales de cliente OAuth intercambiadas por tokens.	Integraciones de servicio a servicio en las que se requiere OAuth pero el inicio de sesión interactivo no es práctico.

Básico (nombre de usuario/contraseña)

Campos de conexión

Campo	Descripción
URL del sitio	URL completa de la instancia de ServiceNow, por ejemplo https://your-instance.service-now.com.​
Nombre de usuario	Nombre de usuario de integración de ServiceNow.​
Contraseña	Contraseña para el usuario de integración.​

Problemas comunes

Errores 4XX

• Verifique la URL de la instancia, el nombre de usuario y la contraseña; asegúrese de que la cuenta esté activa y no esté bloqueada o bloqueada por políticas de IP/inicio de sesión.​
• Comprueba que el usuario puede leer sys_db_object , sys_dictionary y tiene las ACL necesarias en las tablas de destino (leer/insertar/actualizar/eliminar).
• Asegúrate de que tu instancia de ServiceNow no esté hibernando.

Código de autorización OAuth 2.0

Este método otorga acceso a UiPath emitiendo un token de acceso en lugar de requerir tu nombre de usuario y contraseña como campos de conexión.

Nota:

• El flujo de concesión de código de autorización OAuth 2.0 solo es compatible con ServiceNow Istambul y versiones posteriores.
• La URL de devolución de llamada para su aplicación debe ser https://{baseURL}/provisioning_/callback . Consulta Configurar OAuth para obtener más información.

Campos de conexión

Campo	Descripción
URL del sitio	URL completa de la instancia de ServiceNow (por ejemplo https://your-instance.service-now.com).​
ID de cliente	ID de cliente del cliente OAuth de registro de aplicaciones de ServiceNow utilizado por UiPath.​
Secreto de cliente	Secreto de cliente del mismo cliente OAuth.​

Problemas comunes

• La URL de redireccionamiento no coincide o se produce un error de redireccionamiento no válido

  Confirma que la URL de redirección configurada en el cliente OAuth de ServiceNow coincide exactamente con la URL de devolución de llamada que se muestra en UiPath (esquema, host, ruta y barra final).​

• Ya autenticado en ServiceNow: aparece la página Aceptar/Denegar en lugar de la pantalla de inicio de sesión

  Este comportamiento se espera cuando tu navegador ya tiene una sesión activa de ServiceNow. En este caso, ServiceNow omite la pantalla de inicio de sesión y muestra directamente la página de consentimiento OAuth (Aceptar/Denegar).

  • Si esta es la cuenta correcta, haz clic en Aceptar para completar la conexión.
  • Si necesitas utilizar una cuenta diferente, cierra la sesión de ServiceNow en otra pestaña del navegador o vuelve a intentar el flujo en una ventana de incógnito/privada y, a continuación, inicia sesión con el usuario deseado.

  Cuando SSO está habilitado

  En algunas configuraciones de SSO, no aparece ni la pantalla de inicio de sesión ni la página Aceptar/Denegar consentimiento. ServiceNow asume el usuario actualmente autenticado y procede con la creación de la conexión, que puede fallar debido a la falta de permisos.

  En este escenario, utiliza una ventana de incógnito/privada para asegurarte de que puedes autenticarte con el usuario correcto y los permisos necesarios.

• El inicio de sesión y el consentimiento se han realizado correctamente, pero ha fallado la creación de la conexión

  El usuario que autoriza carece de ACL en una o más tablas utilizadas por el conector. Otorgue acceso de lectura a los metadatos (sys_db_object, sys_dictionary) y lea/escriba las ACL en las tablas de negocios relevantes, luego vuelva a probar.​

• La conexión funcionaba anteriormente, pero ahora falla con errores de autenticación o token

  Los tokens de acceso o actualización pueden haber caducado o haber sido revocados (por ejemplo, después de cambios en la contraseña o en el cliente OAuth). Vuelve a abrir la conexión en UiPath y vuelve a autorizar. Si los problemas persisten, comprueba si el cliente OAuth de ServiceNow se ha modificado o eliminado.

Contraseña OAuth 2.0

Campos de conexión

Campo	Descripción
URL del sitio	URL completa de la instancia de ServiceNow.
Nombre de usuario	Nombre de usuario de la cuenta de servicio de ServiceNow.
Contraseña	Contraseña para esa cuenta de servicio.
ID de cliente	ID de cliente del cliente OAuth de ServiceNow.​
Secreto de cliente	Secreto de cliente del mismo cliente OAuth.​

Configurar OAuth

Completa los pasos de Configuración de OAuth en la documentación de ServiceNow.

Aunque es probable que los pasos documentados sean los mismos en todas las regiones de la plataforma ServiceNow, se recomienda que sigas los pasos para tu región específica en caso de que haya diferencias.

Como referencia, el siguiente procedimiento explica cómo configuramos OAuth para nuestros ejemplos.

1. Inicie sesión en su instancia de ServiceNow (por ejemplo, https://<span>dev74293.service-now.com/login</span>)

2. Ve a Definiciones del sistema > Complementos y verifica que el Estado del complemento OAuth esté establecido en Activo.

   

3. Ve a Sistema OAuth > Registro de aplicaciones y selecciona Nuevo.

   • Cuando se le pregunte ¿Qué tipo de aplicación OAuth?, selecciona Crear un punto final de la API OAuth para clientes externos.

     

4. Introduzca un nombre para su aplicación (p. ej. UiPathQuickstart) y selecciona Enviar (si se realiza correctamente, se te redirigirá a tu lista de Registros de aplicaciones ).

   

5. En la lista Registros de aplicaciones , busca tu nueva aplicación y selecciona el Nombre para abrir la página de detalles.

6. Selecciona en el icono de candado junto a Secreto de cliente para mostrar el valor.

7. Take note of the Client Id and Client Secret values.

8. Escribe la siguiente URL de redirección en su campo correspondiente: https://{baseURL}/provisioning_/callback (por ejemplo, https://cloud.uipath.com/provisioning_/callback).

   

Ciclo de vida del token para OAuth2.0 Código de autorización

Durante la creación de la conexión, UiPath redirige al usuario a ServiceNow; el usuario inicia sesión y aprueba el cliente OAuth. UiPath intercambia el código de autorización por un token de acceso y un token de actualización, almacenándolos de forma segura.​ Los tokens de acceso son de corta duración; UiPath utiliza automáticamente el token de actualización para obtener nuevos tokens de acceso hasta que el token de actualización caduque o se revoque el consentimiento.​ Si se elimina el cliente OAuth o se revocan los tokens en ServiceNow, la conexión de UiPath debe volver a autorizarse.

Roles y permisos de ServiceNow

La siguiente tabla enumera los roles y permisos mínimos necesarios para crear una conexión y utilizar el conector ServiceNow. Los requisitos se aplican a todos los tipos de autenticación.

Tabla de ServiceNow	Operación	Motivo de acceso
Tablas (sys_db_object)	Leer	El módulo/tabla de Tablas funciona como un repositorio que contiene una fila correspondiente a cada tabla en tu instancia de ServiceNow. Se utiliza para compilar una lista de tablas con el propósito de ejecutar acciones o desencadenar eventos. Esto es necesario para cargar todas las tablas al utilizar el menú desplegable Seleccionar objeto para tus actividades CRUD. Imagen de documentos
Diccionario (sys_dictionary)	Leer	Esta tabla abarca datos sobre las columnas respectivas de una tabla en particular dentro de tu instancia de ServiceNow. Esta tabla es necesaria para cargar los campos de entrada y salida cuando seleccionas una tabla para llevar a cabo una acción.
Opciones (sys_choice)	Leer	La tabla Elección contiene valores para las opciones que aparecen en las listas de opciones y también para las búsquedas en nuestras actividades seleccionadas. Sin esto, las búsquedas de tiempo de diseño en nuestras actividades no se cargarán.
Usuario (sys_user)	Leer	La tabla Elección contiene texto traducido para las opciones que aparecen en las listas de opciones y también para las búsquedas en nuestras actividades seleccionadas. Sin esto, las búsquedas de usuario en tiempo de diseño en nuestras actividades no se cargarán.

Además, el usuario también debe poseer el control de acceso necesario para las tablas esenciales para el escenario de integración. Por ejemplo, si pretendes establecer un usuario de integración capaz de ejecutar acciones típicas de la mesa de ayuda de ITIL (por ejemplo, abrir, actualizar y cerrar incidentes, problemas, cambios y elementos de gestión de configuración), debes asignar el rol itil .

Crear roles personalizados

Ciertos roles del sistema base, como admin , ya incluyen el control de acceso para estas tablas. Pero, si no quieres asignar roles básicos del sistema y pretendes proporcionar solo el control de acceso esencial necesario para utilizar el conector ServiceNow, puedes considerar la posibilidad de crear un rol personalizado con los permisos de acceso necesarios.

Para conceder acceso exclusivamente a tablas específicas o tablas no cubiertas por los roles del sistema base predeterminados, recomendamos la creación de roles personalizados y la asignación del control de acceso adecuado según sea necesario.

Debes proporcionar a los nuevos roles los controles de acceso enumerados en la siguiente tabla para utilizar el conector/las actividades de ServiceNow. Por ejemplo, un usuario sin permisos de administrador requiere el rol personalize_dictionary para acceder a la tabla sys_dictionary .

Tabla	Tipo	Operación
Tablas (sys_db_object)	Grabar	Leer
Diccionario (sys_dictionary)	Grabar	Leer
Opciones (sys_choice)	Grabar	Leer
Usuario (sys_user)	Grabar	Leer
Clases de campo (sys_glide_object)	Grabar	Leer

Nota:

Editar o crear control de acceso es una capacidad exclusiva de un usuario que posee el rol security\_admin . Si tienes alguna duda, se recomienda consultar a tu administrador de ServiceNow. Puedes encontrar información adicional en los roles con privilegios elevados.

Para llevar a cabo ejecuciones de actividades o desencadenadores, también debes proporcionar otros controles de acceso.

Por ejemplo, si tu escenario específico implica iniciar un flujo de trabajo con un incidente de ServiceNow o crear un incidente de ServiceNow, es necesario conceder los siguientes controles de acceso.

Tabla	Tipo	Operación
Incident	Grabar	Leer
Incident	Grabar	Escribir

Agregar la conexión de ServiceNow

Para crear una conexión a su instancia de ServiceNow, debe realizar los siguientes pasos:

1. Selecciona Integration Service en la barra izquierda.
2. En la lista Conectores , selecciona ServiceNow. También puedes utilizar la barra de búsqueda para acotar el conector.
3. Selecciona el botón Conectar a ServiceNow .
4. Selecciona tu tipo de autenticación preferido e introduce las credenciales necesarias.
5. Select Connect.
6. A continuación, introduce tu nombre de usuario y contraseña de ServiceNow. La aplicación te pide permiso para conectarse a tu cuenta de ServiceNow e interactuar con los registros. Selecciona Permitir.

Para obtener más información sobre la creación de conexiones con ServiceNow, consulta Documentación del producto ServiceNow.