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](https://docs.servicenow.com/bundle/xanadu-api-reference/page/build/applications/concept/api-rest.html) en la ServiceNow documentación. La configuración de esta integración consta de dos pasos. En primer lugar, debe configurar una aplicación OAuth 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, consulte[Métodos de autenticación](quick-action-auth.md). ## 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 aplicaciones OAuth (`admin`se requiere 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, consulte[Configurar integraciones en la consola](integration-console-setup-process.md). ## Configurar ServiceNow OAuth Antes de configurar Amazon Quick, cree un punto final de aplicación de OAuth en su 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](https://www.servicenow.com/docs/bundle/xanadu-platform-security/page/administer/security/task/t_CreateEndpointforExternalClients.html) en la ServiceNow documentación. ### Registra la aplicación OAuth Para registrar la aplicación OAuth, complete los siguientes pasos. 1. **En tu ServiceNow caso, ve a **Todos** > **OAuth del sistema** > **Registro de aplicaciones** y selecciona Nuevo.** 1. Elige **Crear un punto final de la API de OAuth para clientes externos**. 1. Complete el formulario: + **Nombre: nombre** descriptivo de la aplicación OAuth. + URL de **redireccionamiento**: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` {{{region}}}Sustitúyala por tu AWS región (por ejemplo,`us-east-1`). 1. Seleccione **Enviar**. 1. 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. 1. 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 aplicación OAuth. 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.0 Game: Inbound Client Credentials with Washington DC](https://www.servicenow.com/community/developer-blog/up-your-oauth2-0-game-inbound-client-credentials-with-washington/ba-p/2816891) 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` 1. 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` 1. **Vuelve a tu aplicación OAuth en **Sistema OAuth** > Registro de aplicaciones.** Añade el campo **Usuario de la aplicación OAuth** al formulario si no está visible (utiliza **Configurar** > **Form** Builder para añadirlo). 1. Configura el usuario de la **aplicación OAuth en un usuario** con los permisos adecuados, como un usuario con el rol de administrador del sistema. **importante** Con la autenticación del servicio, todas las acciones se ejecutan como el usuario de la aplicación OAuth 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 configuración de ServiceNow OAuth, cree la integración en Amazon Quick. 1. En la consola Amazon Quick, selecciona **Connectors**. 1. Selecciona la pestaña **Crear para tu equipo**. 1. Busca y elige **ServiceNow**. 1. Introduzca los detalles de la integración: + **Nombre**: nombre descriptivo de ServiceNow la integración. + **Descripción** (opcional): propósito de la integración. 1. Elija el tipo de conexión y rellene la configuración de conexión: 1. Para la **autenticación de usuarios (OAuth)**, configure los siguientes campos: + **URL base**: `https://{{{your-instance}}}.service-now.com` + **ID de cliente**: ID de cliente de tu aplicación ServiceNow OAuth. + Secreto de **cliente: secreto** de cliente de tu aplicación ServiceNow OAuth. + **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` 1. 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 tu aplicación ServiceNow OAuth. + Secreto de **cliente: secreto** de cliente de tu aplicación ServiceNow OAuth. + **URL del token**: `https://{{{your-instance}}}.service-now.com/oauth_token.do` 1. Seleccione **Crear y continuar**. 1. Elige los usuarios con los que compartir la integración. 1. Elija **Siguiente**. Para la autenticación de usuarios, vaya a **Connectors** > nombre de su ServiceNow conector y seleccione **Iniciar sesión** para completar el flujo de autorización de OAuth. ## Acciones disponibles Tras configurar la integración, estarán disponibles las siguientes acciones. **ServiceNow acciones disponibles** | Categoría | Action | Description (Descripción) | | --- | --- | --- | | Incidentes | Listar 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 | Listar 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 (CI) aprobados y compatibles. | | 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 | Crear 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 adjunto | Eliminar un archivo adjunto. | | Users | Listar usuarios de | Listar 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. Server-side Se aplican las reglas empresariales, las ACL y las políticas de datos. Para obtener más información, consulte la [API REST](https://docs.servicenow.com/bundle/xanadu-api-reference/page/integrate/inbound-rest/concept/c_RESTAPI.html) en la ServiceNow documentación. ## Administre y solucione problemas Para editar, compartir o eliminar tu integración, consulta[Administrar las integraciones existentes](integration-workflows.md#managing-existing-integrations). ### Problemas de autenticación + **La autorización de OAuth falla**: compruebe que el ID de cliente y el secreto de cliente coincidan con los valores del registro de su ServiceNow 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 en`true`. Confirme que el campo **Usuario de la aplicación OAuth** 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 aplicación OAuth 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.