ServiceNow integración - Amazon Quick
Antes de empezarConfiguración ServiceNow OAuthConfigurar la integración en Amazon QuickAcciones disponiblesLimitacionesAdministre y solucione problemas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

ServiceNow integración

Utilice la ServiceNow integración para realizar acciones en sus ServiceNow instancias, incluida la gestión de incidentes, problemas, solicitudes de cambio, artículos de la base de conocimientos y archivos adjuntos. Esta integración usa la API ServiceNow REST. Para obtener más información, consulte la API REST en la ServiceNow documentación.

La configuración de esta integración consta de dos pasos. En primer lugar, debe configurar una OAuth aplicación en su ServiceNow instancia. A continuación, crea la integración en Amazon Quick y la conecta a ServiceNow la aplicación. Para obtener información sobre los métodos de autenticación que admite Amazon Quick, consulteMétodos de autenticación.

Antes de empezar

Antes de configurar la integración, compruebe que dispone de lo siguiente.

  • Una ServiceNow instancia. Esta integración se valida con la versión de Xanadu.

  • Una cuenta ServiceNow de usuario con permisos para crear OAuth aplicaciones (se requiere admin un rol).

  • Para la autenticación del servicio (credenciales de cliente), la instancia debe ejecutar la versión Washington DC o posterior.

  • Para conocer los requisitos de suscripción, consulteConfigurar las integraciones en la consola.

Configuración ServiceNow OAuth

Antes de configurar Amazon Quick, cree un punto de enlace de OAuth aplicación en la ServiceNow instancia. Complete todos los pasos siguientes ServiceNow antes de pasar a la consola Amazon Quick.

Para obtener más información, consulte Crear un punto de conexión para que los clientes accedan a la instancia en la ServiceNow documentación.

Registre la OAuth aplicación

Para registrar la OAuth solicitud, complete los siguientes pasos.

  1. En su ServiceNow caso, vaya a Todo > Sistema OAuth > Registro de aplicaciones y seleccione Nuevo.

  2. Elija Crear un punto final de OAuth API para clientes externos.

  3. Complete el formulario:

    • Nombre: nombre descriptivo de la OAuth solicitud.

    • URL de redireccionamiento: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

      {region}Sustitúyala por tu AWS región (por ejemplo,us-east-1).

  4. Seleccione Enviar.

  5. Vuelva a abrir la entrada del registro de la aplicación y elija el icono de candado situado junto a Client Secret para ver el valor.

  6. Copie los valores de ID de cliente y secreto de cliente. Los necesitará cuando configure la integración en Amazon Quick.

Pasos adicionales para la autenticación del servicio (credenciales de cliente)

Si planea usar la autenticación de servicio, complete estos pasos adicionales después de registrar la OAuth aplicación. El tipo de concesión de credenciales de cliente se introdujo en la versión de ServiceNow Washington DC. Para obtener más información, consulte Up Your OAuth2 2.0 Game: Inbound Client Credentials with Washington DC in the ServiceNow Community.

  1. Habilite el tipo de concesión de credenciales de cliente. Utilice el sys_properties.list navegador de filtros y cree una nueva propiedad del sistema con los siguientes valores:

    • Nombre: glide.oauth.inbound.client.credential.grant_type.enabled

    • Tipo: true | false

    • Valor: true

  2. Compruebe que los siguientes complementos estén instalados (vaya a Admin > Application Manager):

    • OAuth 2.0 (com.snc.platform.security.oauth)

    • Proveedor de API REST (com.glide.rest)

    • Ámbito de autenticación (com.glide.auth.scope)

    • Complemento de alcance de autenticación de la API REST () com.glide.rest.auth.scope

  3. Regrese a su OAuth aplicación en Sistema OAuth > Registro de aplicaciones. Agregue el campo Usuario de la OAuth aplicación al formulario si no está visible (utilice Configurar > Generador de formularios para agregarlo).

  4. Establezca el usuario de la OAuth aplicación en un usuario con los permisos adecuados, como un usuario con la función de administrador del sistema.

importante

Con la autenticación del servicio, todas las acciones se ejecutan como el usuario de la OAuth aplicación configurado. Cualquier usuario de Amazon Quick con acceso a esta integración puede realizar acciones con los permisos de esa cuenta. Configure los permisos de la cuenta para que coincidan con los requisitos de seguridad de su organización.

Configurar la integración en Amazon Quick

Tras completar la ServiceNow OAuth configuración, cree la integración en Amazon Quick.

  1. En la consola Amazon Quick, selecciona Integraciones.

  2. Selecciona ServiceNowy selecciona el botón Añadir (más «+»).

  3. Introduce los detalles de la integración:

    • Nombre: nombre descriptivo de ServiceNow la integración.

    • Descripción (opcional): propósito de la integración.

  4. Elija el tipo de conexión y rellene la configuración de conexión:

    1. Para la autenticación de usuario (OAuth), configure los siguientes campos:

      • URL base: https://{your-instance}.service-now.com

      • ID de cliente: ID de cliente de su ServiceNow OAuth aplicación.

      • Secreto de cliente: secreto de cliente de su ServiceNow OAuth aplicación.

      • URL del token: https://{your-instance}.service-now.com/oauth_token.do

      • URL de autenticación: https://{your-instance}.service-now.com/oauth_auth.do

      • URL de redireccionamiento — https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

    2. Para la autenticación del servicio (credenciales de cliente), configure los siguientes campos:

      • Tipo de autenticación: Service-to-service OAuth

      • URL base — https://{your-instance}.service-now.com

      • ID de cliente: ID de cliente de su ServiceNow OAuth aplicación.

      • Secreto de cliente: secreto de cliente de su ServiceNow OAuth aplicación.

      • URL del token: https://{your-instance}.service-now.com/oauth_token.do

  5. Seleccione Crear y continuar.

  6. Elige los usuarios con los que compartir la integración.

  7. Elija Siguiente.

Para la autenticación de usuarios, vaya a Integraciones > Acciones > su nombre de ServiceNow integración y elija Iniciar sesión para completar el flujo de OAuth autorización.

Acciones disponibles

Tras configurar la integración, estarán disponibles las siguientes acciones.

ServiceNow acciones disponibles
Categoría Action Description (Descripción)
Incidentes Enumere los incidentes Recupera los incidentes existentes.
Incidentes Crear incidente Cree un registro de incidentes para documentar una desviación de un estándar de operación esperado.
Incidentes Ver incidente Recupera los detalles de un incidente específico.
Incidentes Actualice el incidente Actualizar el registro de un incidente.
Incidentes Eliminar incidente Eliminar un incidente.
Problemas Enumere los problemas Recupera los problemas existentes.
Problemas Crear problema Crea un nuevo registro de problemas.
Problemas Ver problema Recupera los detalles de un registro de problemas específico.
Problemas Problema de actualización Actualiza un registro de problemas.
Problemas Eliminar el problema Eliminar un problema.
Solicitudes de cambio Liste las solicitudes de cambio Recupera todas las solicitudes de cambio.
Solicitudes de cambio Crear solicitud de cambio Cree una solicitud de cambio para implementar un proceso controlado de modificación de los elementos de configuración aprobados y compatibles (CIs).
Solicitudes de cambio Ver solicitud de cambio Recupera información detallada sobre una solicitud de cambio específica.
Solicitudes de cambio Actualizar la solicitud de cambio Modificar una solicitud de cambio.
Solicitudes de cambio Eliminar solicitud de cambio Eliminar una solicitud de cambio.
Artículos de la base de conocimientos Cree un artículo en la base de conocimientos Cree un artículo de la base de conocimientos. Requiere el complemento Knowledge API (sn_km_api).
Artículos de la base de conocimientos Actualizar el artículo de la base de conocimientos Modificar un artículo de la base de conocimientos.
Artículos de la base de conocimientos Eliminar artículo de la base de conocimientos Eliminar un artículo de la base de conocimientos.
Archivos adjuntos Recuperar metadatos de archivos adjuntos Recupera los metadatos de los archivos adjuntos.
Archivos adjuntos Recupere los metadatos del archivo adjunto Recupera los metadatos de un archivo adjunto específico.
Archivos adjuntos Recupere el contenido del archivo adjunto Recupera el contenido del archivo binario adjunto.
Archivos adjuntos Cargue el archivo adjunto binario Cargue un archivo binario como adjunto a un registro específico.
Archivos adjuntos Cargue un archivo adjunto de formulario de varias partes Cargue un archivo adjunto compuesto por varias partes.
Archivos adjuntos Eliminar archivo adjunto Eliminar un archivo adjunto.
Users Listar usuarios de Enumere todos los registros de usuario.
Sistema Enumere las opciones Recupera los valores de la lista de opciones de la tabla sys_choice.
nota

Las acciones específicas disponibles dependen de los permisos configurados en la ServiceNow instancia y del método de autenticación utilizado.

Limitaciones

Esta integración interactúa ServiceNow a través de la API REST, que no aplica políticas de interfaz de usuario, acciones de interfaz de usuario ni scripts de cliente. Estas reglas solo se aplican a la interfaz del ServiceNow navegador. Se aplican las reglas empresariales y las políticas de datos del lado del servidor. ACLs Para obtener más información, consulte la API REST en la ServiceNow documentación.

Administre y solucione problemas

Para editar, compartir o eliminar tu integración, consultaAdministrar las integraciones existentes.

Problemas de autenticación

  • OAuth error en la autorización: compruebe que el ID de cliente y el secreto de cliente coincidan con los valores del registro de ServiceNow la aplicación. Confirma que la URL de redireccionamiento ServiceNow coincide exactamente con la URL de tu configuración de Amazon Quick.

  • La autenticación del servicio falla: compruebe que la propiedad glide.oauth.inbound.client.credential.grant_type.enabled del sistema esté establecida entrue. Confirme que el campo Usuario de la OAuth aplicación esté rellenado en el registro de la aplicación.

Mensajes de error comunes

  • Las acciones devuelven errores de permisos: compruebe que el ServiceNow usuario o el usuario de la OAuth aplicación tienen las funciones necesarias para acceder a las tablas de destino (por ejemplo, la itil función de gestión de incidentes).

  • Tiempo de espera de conexión o instancia inalcanzable: compruebe que la URL base utilice el nombre de instancia correcto ServiceNow . Confirma que la ServiceNow instancia es accesible y no está en modo de mantenimiento.