Configura una instancia de ServiceNow para CDC

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Puedes usar Datastream para replicar datos de una instancia de ServiceNow en un destino compatible, como BigQuery o Cloud Storage. Antes de crear un perfil de conexión, debes configurar un usuario de integración dedicado, configurar la autenticación básica o de OAuth 2.0 y agregar a la lista de entidades permitidas las direcciones IP de Datastream si es necesario.

Antes de comenzar

Antes de comenzar a configurar ServiceNow para usarlo con Datastream, asegúrate de tener lo siguiente:

• Una instancia activa de ServiceNow, por ejemplo, company.service-now.com.
• Privilegios de administrador en la instancia de ServiceNow para crear usuarios, asignar roles y administrar el registro de aplicaciones de OAuth.
• Conocimiento de la versión de tu instancia de ServiceNow

Configura un usuario de integración

En ServiceNow, puedes crear un usuario nuevo o ajustar la configuración de una cuenta existente para permitir el acceso de Datastream. Por motivos de seguridad y auditoría, te recomendamos que crees un usuario de integración dedicado.

1. En ServiceNow, navega a User Administration > Users.
2. Para crear un usuario nuevo, haz clic en Nuevo. Para editar un usuario existente, busca el ID de usuario en la lista de usuarios y haz clic en él para abrir el registro.

3. Configura los detalles del usuario:

   • Ingresa un nombre único en el campo ID de usuario, por ejemplo, datastream_integration. Estableces el identificador de usuario solo para los usuarios nuevos.
   • Si seleccionas la autenticación de OAuth para el conector, te recomendamos que ingreses valores en los campos Nombre y Apellido para identificar mejor el registro del usuario.

   • Configuración de identidad: según la versión de la plataforma de ServiceNow:

     • Xanadu y versiones posteriores: selecciona Máquina en el menú desplegable Tipo de identidad. Esto habilita automáticamente la opción Solo acceso a servicios web.
     • Pre-Xanadu: Selecciona la casilla de verificación Web service access only.

4. Guarda el registro:

   • En el caso de los usuarios nuevos, haz clic en Enviar.
   • En el caso de los usuarios existentes, haz clic en Actualizar.

5. Si creaste un usuario nuevo, vuelve a abrir el registro. Busca al usuario en la lista y haz clic en su ID de usuario para acceder a las opciones de registro.

6. Establece la contraseña:

   1. Haz clic en Establecer contraseña en el encabezado del formulario.
   2. Ingresa una contraseña segura y haz clic en Guardar contraseña.
   3. Si usas la autenticación básica para el conector, toma nota de la contraseña, ya que es necesaria cuando configuras el perfil de conexión.

7. Asignar permisos Debes otorgar al usuario de integración acceso de lectura a todas las tablas que quieras replicar. Además, el conector requiere permisos de lectura explícitos para las tablas de metadatos del sistema sys_db_object, sys_table_rotation y sys_dictionary.

Debido a la naturaleza detallada de los roles de ServiceNow y el sistema de lista de control de acceso (LCA), la configuración específica que se requiere para otorgar estos permisos es específica del cliente.

• Te recomendamos que asignes el rol snc_read_only a tu usuario, ya que garantiza que la sesión del usuario se limite estrictamente al acceso de solo lectura en toda la plataforma.
• El rol de administrador otorga acceso completo a todas las tablas de la instancia. Si tus políticas de seguridad lo permiten, asignar el rol de administrador es el método más sencillo para garantizar el acceso completo al conector.

Opcional: Configura las credenciales de cliente de OAuth 2.0

OAuth 2.0 es el método de autenticación más seguro y recomendado para usar el conector de ServiceNow con Datastream. Usa un ID de cliente y un secreto del cliente en lugar de una contraseña permanente.

1. Activa el complemento de OAuth 2.0 para tu instancia. Para obtener más información, consulta la documentación de ServiceNow.
2. Asegúrate de que la propiedad del sistema com.snc.platform.security.oauth.is.active esté configurada como true. Para obtener más información, consulta la documentación de ServiceNow.
3. Asegúrate de que la propiedad del sistema glide.oauth.inbound.client.credential.grant_type.enabled esté configurada como true. Para obtener más información, consulta la documentación de ServiceNow.

4. Configura OAuth entrante. Según los requisitos de seguridad de tu instancia, puedes seleccionar uno de los siguientes permisos de configuración de OAuth:

   • Alcance amplio: Cuando se usa OAuth de alcance amplio, el portador del token hereda los roles de usuario y las listas de control de acceso (LCA) asociados.
   • Autenticación de API de REST detallada con alcance: Este tipo de configuración de OAuth se restringe a las APIs de REST y los métodos específicos que permite el alcance, además de los roles de usuario y las LCA asociadas.

5. Crea el registro de integración de OAuth. Para obtener más información, consulta la documentación de ServiceNow:

   • Para la versión de la plataforma Zurich y posteriores
   • Para versiones de la plataforma anteriores a Zurich

6. Después de crear el registro de integración de OAuth, la configuración dependerá de la versión de la plataforma y el permiso de OAuth:

   • Configuración de alcance amplio:

     • Zurich y versiones posteriores: En la sección Permiso de autenticación del registro de integración, asegúrate de que no haya entradas en los campos Permiso de autenticación o Limitar la autorización a las siguientes APIs, y de que la casilla de verificación Permitir el acceso solo a las APIs en el permiso seleccionado no esté seleccionada.
     • Antes de Zurich: En el menú desplegable Restricción de permisos, selecciona Permisos amplios y deja vacía la lista Permisos de autenticación.

   • Configuración de permisos de autenticación detallada de la API de REST: De manera opcional, usa permisos de autenticación para limitar aún más el portador del token a las APIs de REST y los métodos específicos permitidos por el permiso. El conector de Datastream solo requiere acceso de GET a la API de Table. Según la versión de la plataforma, sigue estos pasos:

     • Zurich y versiones posteriores: En la sección Auth scope del registro de integración, selecciona un permiso de autorización y limita su acceso a la API de Table.

       Nota: Si creas el permiso de autorización cuando editas tu registro de integración, el permiso tiene acceso a todos los métodos de la API de Table de forma predeterminada. Para limitar aún más el acceso solo al método GET, debes editar de forma manual el registro recién creado. Para ello, navega a Servicios web del sistema > Permisos de autenticación de la API > Permiso de autenticación de la API de REST.

     • Pre-Zurich:

       1. Restringe el acceso a la API de Table para el permiso de autorización seleccionado. Para obtener más información, consulta la documentación de ServiceNow.
       2. Agrega el permiso en la sección Permisos de autenticación.
       3. Selecciona Securely scoped en el cuadro Scope Restriction.

Opcional: Configura el control de acceso a direcciones IP

Si tu instancia de ServiceNow usa el control de acceso a direcciones IP, debes incluir de forma explícita en la lista de entidades permitidas las direcciones IP de Datastream.

Los siguientes pasos solo son necesarios si tienes una regla de control de acceso de direcciones IP DENY que abarque las direcciones IP de Datastream. De forma predeterminada, no hay restricciones de IP para acceder a la instancia.

1. En ServiceNow, navega a Seguridad del sistema > Control de acceso de direcciones IP.
2. Haz clic en Nuevo.
3. En el formulario de creación de registros, aplica los siguientes parámetros de configuración:
   1. En el menú desplegable Tipo, selecciona Permitir.
   2. En el menú desplegable Dirección, selecciona Entrante.
   3. En los campos Inicio del rango y Fin del rango, ingresa la dirección IP o el rango de direcciones específicos de la lista de direcciones IP de Datastream.
   4. Asegúrate de que la casilla de verificación Activo esté seleccionada.
4. Haz clic en Enviar.
5. Repite los pasos anteriores para cada dirección IP de la lista de direcciones de Datastream.

¿Qué sigue?

• Obtén más información sobre la fuente de ServiceNow.