Microaplicaciones

Integrar Cherwell

Implemente la plantilla de integración de Cherwell para administrar y recibir notificaciones sobre cambios en incidentes y solicitudes de servicio.

¡Su opinión nos interesa! Proporcione comentarios sobre esta plantilla de integración a medida que la utiliza. Para cualquier problema, nuestro equipo también supervisará el foro dedicado a diario.

Para obtener información detallada sobre las microaplicaciones de uso inmediato para Cherwell, consulte Usar microaplicaciones de Cherwell.

Revisar requisitos previos

Tras configurar esta integración con Cherwell, necesitará estos artefactos para agregar la integración en las microaplicaciones de Citrix Workspace:

  • URL base: https:/{Cherwell_Instance_URL}/CherwellAPI/api/. {Cherwell_Instance_URL} se obtiene de Cherwell cuando se compra.
  • URL del token: https:/{Cherwell_Instance_URL}/CherwellAPI/token. {Cherwell_Instance_URL} se obtiene de Cherwell cuando se compra.
  • Nombre de usuario: Este y la contraseña son las credenciales de la cuenta de servicio con acceso a Cherwell.
  • Contraseña: Esta y el nombre de usuario son las credenciales de la cuenta de servicio con acceso a Cherwell.
  • ID de cliente: El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización.
  • Secreto del cliente: El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.

Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

La integración requiere acceso periódico a su instancia de Cherwell, por lo que recomendamos crear una cuenta de usuario dedicada. Esta cuenta debe tener los siguientes permisos:

  • Grupo de seguridad del administrador

Crear ID de cliente y secreto del cliente

Antes de realizar este procedimiento, vaya a https://{ Cherwell_Instance_URL}/CherwellAutoDeploy/, descargue Cherwell Service Management e instálelo.

  1. Inicie sesión con su ID de usuario y contraseña.
  2. En la pantalla de la aplicación Cherwell Service Management, seleccione Security.
  3. Vaya a Edit REST API client settings.
  4. Seleccione Create new client.
  5. Introduzca un valor para:

    • Nombre
    • Descripción
    • Introduzca 360 para Token lifespan
    • Introduzca 1440 para **Refresh Token lifespan
    • Marque la casilla API Access enabled.
  6. Seleccione Save current client.
  7. Copie y guarde el valor de Client Key. Este es el valor de ID de cliente y secreto del cliente para la autenticación del servicio durante la configuración de la integración.

Crear nombre de usuario y contraseña

De nuevo, antes de realizar este procedimiento, vaya a https://{ Cherwell_Instance_URL}/CherwellAutoDeploy/, descargue Cherwell Service Management e instálelo.

  1. Inicie sesión con su ID de usuario y contraseña.
  2. En la pantalla de la aplicación Cherwell Service Management, seleccione Security.
  3. Seleccione Edit Users.
  4. Seleccione Create new user.
  5. Introduzca un valor para:

    • Login ID
    • Contraseña
    • Confirm password
  6. Seleccione Security Group: Admin e introduzca los valores de Full name y E-Mail.
  7. Seleccione la casilla Password never expires.
  8. Seleccione Save current user.

Nota:

Agregar la integración a las microaplicaciones de Citrix Workspace

Agregue la integración de Cherwell a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo.

Siga estos pasos:

  1. En la página Integraciones de microaplicaciones, seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
  2. Elija el mosaico de Cherwell.
  3. Introduzca un nombre para la integración.
  4. Introduzca los parámetros del conector.
    • Introduzca la URL base de la instancia: https:/{Cherwell_Instance_URL}/CherwellAPI/api/. {Cherwell_Instance_URL} se obtiene de Cherwell cuando se compra.
    • Seleccione un icono para la integración en la Biblioteca de iconos, o deje el icono predeterminado.
  5. En Autenticación de servicio, seleccione OAuth 2.0 en el menú Método de autenticación y complete los detalles correspondientes. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Utilice el protocolo de seguridad de OAuth 2.0 para generar tokens de solicitud/autorización para el acceso delegado. Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.
    1. Seleccione Contraseña del propietario del recurso en el menú Tipo de concesión.
    2. Introduzca la contraseña para Valor de tipo de concesión.
    3. Seleccione Cuerpo de la solicitud como Autorización de token.
    4. Seleccione URL codificada del formulario como Tipo de contenido de token.
    5. Introduzca la URL del token: https:/{Cherwell_Instance_URL}/CherwellAPI/token. {Cherwell_Instance_URL} se obtiene de Cherwell cuando se compra.
    6. Introduzca su Nombre de usuario. Este y la contraseña son las credenciales de la cuenta de servicio con acceso a Cherwell.
    7. Introduzca su Contraseña. Esta y el nombre de usuario son las credenciales de la cuenta de servicio con acceso a Cherwell.
    8. Introduzca su ID de cliente. El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización.
    9. Introduzca su Secreto del cliente. El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.
    10. Seleccione Portador en el menú Prefijo de encabezado.
    11. En Parámetros del token de acceso, introduzca auth_mode como Nombre e internal como Valor.
  6. Deje la opción Autenticación de acciones de servicio inhabilitada.
  7. Deje la opción Habilitar la limitación del índice de solicitudes inhabilitada.
  8. (Optativo) Habilite la opción Registro para conservar un registro de 24 horas con fines de asistencia.
  9. Seleccione Guardar para continuar.

Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Para obtener información completa acerca de las reglas de sincronización, la sincronización que no cumple con sus reglas de programación y las reglas de veto, consulte Sincronizar datos.

Para obtener información detallada sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Cherwell.

Usar las microaplicaciones de Cherwell

Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Crear incidente: Permite al usuario crear un incidente.

Notificación o página Flujos de trabajo por caso de uso
Página Crear incidente Proporciona un formulario para crear un incidente.

Crear solicitud de servicio: Sirve para crear una nueva solicitud de servicio del catálogo o para seleccionar plantillas de solicitudes de servicio predefinidas.

Notificación o página Flujos de trabajo por caso de uso
Página Crear solicitud de servicio Proporciona un formulario para seleccionar una plantilla predefinida o crear una solicitud del catálogo de servicios.

Mis incidentes activos: Sirve para ver y administrar los incidentes activos del usuario del espacio de trabajo.

Notificación o página Flujos de trabajo por caso de uso
Notificación Incidente creado Cuando se crea un nuevo incidente, el propietario del incidente recibe una notificación.
Notificación Se alcanzaron los umbrales del SLA de resolución de incidentes Cuando se incumple el SLA de resolución de un incidente, el propietario de este recibe una notificación.
Notificación Se alcanzaron los umbrales del SLA de respuesta a incidentes Cuando se incumple el SLA de respuesta a un incidente, el propietario de este recibe una notificación.
Notificación Estado de incidente cambiado Cuando el estado de un incidente cambia, el propietario del incidente recibe una notificación.
Página Mis incidentes activos Proporciona una lista de incidentes activos, pertenecientes al usuario del espacio de trabajo.
Página Detalles del incidente Proporciona detalles del incidente, incluidos comentarios, con la opción de agregar comentarios y retirar el incidente.

Mis solicitudes de servicio activas: Sirve para ver y administrar las solicitudes de servicio activas pertenecientes al usuario del espacio de trabajo.

Notificación o página Flujos de trabajo por caso de uso
Notificación Solicitud de servicio creada Cuando se crea una nueva solicitud de servicio, el propietario del incidente recibe una notificación.
Notificación Se alcanzaron los umbrales del SLA de resolución de solicitudes de servicio Cuando se incumple el SLA de resolución de una nueva solicitud de servicio, el propietario del incidente recibe una notificación.
Notificación Se alcanzaron los umbrales del SLA de respuesta a solicitudes de servicio Cuando se incumple el SLA de respuesta a una nueva solicitud de servicio, el propietario del incidente recibe una notificación.
Notificación Estado de la solicitud de servicio cambiado Cuando el estado de una nueva solicitud de servicio cambia, el propietario del incidente recibe una notificación.
Mis solicitudes de servicio activas Proporciona una lista de solicitudes activas de servicio pertenecientes al usuario del espacio de trabajo.
Detalles de la solicitud de servicio Proporciona detalles de la solicitud de servicio, incluidos comentarios, con la opción de agregar comentarios y retirar la solicitud de servicio.
Integrar Cherwell