Requisitos previos para el conector ServiceNow v2 (Beta) en Jitterbit Studio

Introducción

Para configurar una conexión ServiceNow v2 (Beta) y utilizar sus actividades, se debe tener un usuario autenticado con permisos específicos asociados a su instancia de ServiceNow. Si se utiliza autenticación OAuth 2.0, también se requiere un endpoint API de OAuth y su ID de cliente y secreto de cliente.

Requisitos de autenticación básica

• Crear un usuario autenticado y establecer permisos

Requisitos de autenticación OAuth 2.0

• Crear un usuario autenticado y establecer permisos

• Crear un endpoint API de OAuth y recuperar su ID de cliente y secreto de cliente

Crear un usuario autenticado y establecer permisos

Esta sección describe cómo crear un usuario autenticado y establecer los permisos requeridos para su uso con el conector ServiceNow v2 (Beta). Este paso es necesario tanto para la autenticación básica como para la autenticación OAuth 2.0. El conector requiere estos permisos para recuperar metadatos de ServiceNow cuando se configura una actividad.

Siga estos pasos:

1. Elevar su rol: Se requiere temporalmente el rol elevado security_admin para completar los otros pasos en esta sección.

2. Crear un rol personalizado para el usuario autenticado: Se requiere un rol personalizado con permisos específicos para el usuario autenticado.

3. Crear un usuario autenticado: Las credenciales del usuario autenticado se ingresan en la conexión ServiceNow v2 (Beta) durante la configuración del conector.

4. Crear listas de control de acceso para las actividades: Se requieren dos registros separados de Lista de Control de Acceso (ACL) utilizando el rol personalizado para que cada actividad de ServiceNow v2 (Beta) funcione como se espera.

5. Asignar roles al usuario autenticador: Se debe asignar el rol personalizado y dos roles de sistema adicionales al usuario autenticador.

Elevar su rol

El rol elevado security_admin es temporalmente necesario para completar los otros pasos en esta sección. Siga estos pasos para obtener el rol elevado:

1. Desde cualquier lugar dentro de la instancia de ServiceNow, haga clic en el ícono de usuario ubicado en la esquina superior derecha de la página y luego haga clic en Elevar rol.

2. Seleccione security_admin y haga clic en Actualizar.

Crear un rol personalizado para el usuario autenticador

Se requiere un rol personalizado con permisos específicos para el usuario autenticador. Siga estos pasos para crear el rol personalizado:

1. Haga clic en el menú Todo y navegue a Administración de Usuarios > Roles.

2. Cree un nuevo rol personalizado que el usuario autenticador utilizará en nombre del agente de Jitterbit haciendo clic en Nuevo.

3. Complete el formulario con la siguiente información:

   • Nombre: Ingrese un nombre apropiado para el rol, como jitterbit_harmony_agent.

     Nota

     El nombre de un rol no se puede cambiar una vez que el rol ha sido creado.

   • Aplicación: Deje como el predeterminado Global.

   • Requiere Suscripción: Deje como el predeterminado No especificado.

   • Privilegio elevado: Deje como el predeterminado sin seleccionar.

   • Descripción: Ingrese una descripción apropiada, como Utilizado por el usuario autenticador en nombre del agente de Jitterbit.

4. Haga clic en Enviar para crear el nuevo rol.

Crear un usuario autenticador

Las credenciales del usuario autenticador se ingresan en la conexión ServiceNow v2 (Beta) durante la configuración del conector. Se recomienda crear un usuario separado con un nombre apropiado en lugar de utilizar un usuario existente. Siga estos pasos para crear el usuario autenticador:

1. Haga clic en el menú Todos y navegue a Seguridad del sistema > Usuarios y grupos > Usuarios.

2. Cree un nuevo usuario que será el usuario autenticador en nombre del agente de Jitterbit haciendo clic en Nuevo.

3. Complete el formulario, ingresando un ID de usuario apropiado (como jitterbit_harmony_agent).

4. Establezca una contraseña para el nuevo usuario haciendo clic en Establecer contraseña y siguiendo las instrucciones en la pantalla resultante.

Crear listas de control de acceso para las actividades

Se requieren dos registros de Lista de Control de Acceso (ACL) separados utilizando el rol personalizado para que cada actividad de ServiceNow v2 (Beta) funcione como se espera. Siga estos pasos para configurar ambas ACL con los registros correctos:

1. Haga clic en el menú Todos y navegue a Seguridad del sistema > Control de acceso.

2. Cree un nuevo registro de ACL haciendo clic en Nuevo.

3. Configure estos ajustes para el nuevo registro de ACL:

   • Tipo: Seleccione registro del menú.

   • Operación: Seleccione la operación de ServiceNow apropiada del menú. La operación lectura es el tipo de operación mínima requerida para hacer una conexión ServiceNow v2 (Beta). Estas son las operaciones de ServiceNow que se requieren para cada actividad de ServiceNow v2 (Beta):

     Actividad del conector ServiceNow v2 (Beta)	Operación de ServiceNow
     Consulta	lectura
     Crear	crear
     Actualizar	escribir
     Eliminar	eliminar

     Nota

     Si la operación de ServiceNow apropiada para una actividad no está configurada en la instancia de ServiceNow, se devolverá un error en tiempo de ejecución por el conector.

   • Nombre: Para otorgar acceso al sys_db_object, ingrese sys_db_object y seleccione Tabla [sys_db_object] del menú. Deje el segundo menú configurado en --Ninguno--.

   • Requiere rol: Bajo Rol, haga doble clic en Insertar una nueva fila y luego ingrese el rol personalizado creado previamente (como jitterbit_harmony_agent). Haga clic en la marca de verificación verde para agregar el rol al ACL.

4. Haga clic en Enviar para crear el nuevo ACL. Se le pedirá que verifique la configuración para completar la creación de la nueva lista.

5. Repita los tres pasos anteriores y otorgue acceso al sys_glide_object para las cuatro operaciones de ServiceNow especificando Clase de campo [sys_glide_object] en el campo Nombre. Asigne el mismo rol personalizado creado previamente como se mencionó arriba.

Si crea un registro de ACL para cada actividad de conector en cada una de las dos tablas, habrá creado ocho nuevos registros al finalizar. Puede ordenar la tabla de Controles de Acceso por la fecha de Actualizado y estos nuevos registros aparecerán en la parte superior.

Asignar roles al usuario autenticador

El rol personalizado y dos roles de sistema adicionales deben ser asignados al usuario autenticador. Siga estos pasos para asignar los roles:

1. Asigne roles al usuario autenticador navegando a Administración de Usuarios > Usuarios y abriendo el usuario autenticador (como jitterbit_harmony_agent) que creó previamente.

2. En su pestaña Roles, haga clic en Editar y haga doble clic en el rol personalizado creado arriba para agregarlo a los roles de Enlaces Relacionados del usuario autenticador. En la misma pantalla, también debe agregar los dos roles personalize_dictionary y itil a la lista de Roles para habilitar el acceso a las tablas sys_dictionary y itil.

3. Haga clic en Actualizar para guardar la configuración del usuario autenticador.

Crear un endpoint de API OAuth y recuperar su ID de cliente y secreto de cliente

Si utiliza la autenticación OAuth 2.0, siga estos pasos para crear un punto final de API OAuth y recuperar su ID de cliente y secreto de cliente para usar en la conexión ServiceNow v2 (Beta):

1. Inicie sesión en el Portal de Desarrolladores de ServiceNow y haga clic en Comenzar a construir para su instancia de ServiceNow.

2. Desde cualquier lugar dentro de la instancia de ServiceNow, abra el menú Todo y navegue a Sistema OAuth > Registro de Aplicaciones.

3. En la página de Registros de Aplicaciones, haga clic en el botón Nuevo.

4. Haga clic en Crear un punto final de API OAuth para clientes externos.

5. Ingrese estos detalles para su aplicación:

   • Nombre: Ingrese un nombre único para la aplicación, como agente Jitterbit.

   • ID de Cliente: Copie este valor. Este será el ID de Cliente en la conexión ServiceNow v2 (Beta).

   • Secreto de Cliente: Ingrese un valor o deje en blanco para que ServiceNow genere un valor. Este será el secreto de cliente en la conexión ServiceNow v2 (Beta).

   • Activo: Asegúrese de que Activo esté seleccionado.

6. Haga clic en Enviar para crear el nuevo punto final de API OAuth.

7. Si dejó el Secreto de Cliente en blanco para que ServiceNow generara un valor, vuelva a abrir la entrada para ver y copiar el secreto de cliente.

Siguientes pasos

Después de completar los pasos descritos en esta página, puede usar el nombre de usuario del usuario autenticado con su contraseña y el ID de cliente y secreto de la aplicación OAuth creada (si corresponde) en la conexión ServiceNow v2 (Beta).