Conectores de flujo de trabajo

Agregue y utilice conectores administrados y conectores personalizados en el área Conectores de flujo de trabajo de Omnissa Intelligence. Los conectores de flujo de trabajo se basan en nuestro sistema de administración de conectores (CMS), que administra todas las configuraciones y acciones de conectores administrados para los servicios salientes de Omnissa Workspace ONE y las integraciones de terceros. También administra todas las configuraciones y acciones de conectores personalizados para ampliar la arquitectura inicial de flujos de trabajo.

Conectores administrados

Los conectores administrados, ya sean nativos o de terceros, se preconfiguran o se agregan para que pueda utilizar sus acciones en los flujos de trabajo. Algunos ejemplos de conectores administrados preinicializados son Hub Services e Intelligence. Los conectores administrados de terceros incluyen la API web de Slack y ServiceNow. Los conectores personalizados son sus propias conexiones y acciones que utilizan las REST API para la comunicación.

Si no está familiarizado con Intelligence, debe agregar los conectores administrados siguiendo el proceso de configuración del conector. Consulte el tema de integración correspondiente para obtener más información.

Si configuró el conector antes de la publicación de CMS, la versión 23.03.23, no se requiere ninguna acción.

Editar y eliminar

Puede editar o eliminar conectores administrados en Intelligence. Si elimina un conector administrado, dicho conector seguirá disponible para seleccionarlo si desea agregarlo más adelante.

• Eliminar: para eliminar un conector administrado, debe eliminar todas las acciones utilizadas en los flujos de trabajo asociados. También puede eliminar los flujos de trabajo asociados, pero proceda con precaución, ya que esta acción no se puede deshacer.
• Editar: puede editar algunos detalles del conector administrado, pero no puede editar los valores predeterminados de los campos de acción.

Conectores personalizados

Agregue sus propias conexiones y acciones a los flujos de trabajo con los sistemas empresariales y los servicios de terceros existentes. Los conectores personalizados tienen varias acciones que son REST API. Puede compilar y probar acciones mediante herramientas de desarrollo de API, como Bruno, para crear una recopilación de API que, a continuación, puede importar en Intelligence.

Requisitos

Para añadir conectores personalizados, importe una colección de API en el formato de recopilación de Postman. Después de importar la recopilación, las acciones están disponibles para su uso en los flujos de trabajo.

• Cree recopilaciones en una herramienta de desarrollo de API como Bruno.
  • Considere la posibilidad de utilizar Bruno como una herramienta para organizar y probar las EST API con sus servicios internos y de terceros.
  • Puede migrar sus recopilaciones de Postman a Bruno.
  • Para conocer los pasos sobre cómo migrar de Postman a Bruno, consulte el artículo del sitio de documentación de Bruno Migrar desde Postman.
• El servicio que desee conectar debe admitir los tipos de contenido JSON y REST API.
• Intelligence necesita acceder a los endpoints de API.
  • Si los servicios están detrás de un firewall, utilice Unified Access Gateway como proxy inverso.
  • Para obtener más información, acceda a Configurar un proxy inverso con la API de Workspace ONE UEM.
• Si usa OAuth2 para la autenticación, configure los detalles de autorización para que Intelligence pueda recuperar, actualizar y acceder a los tokens del servicio.
  • URL de token de OAuth2
  • Secreto del Client
  • ID de cliente
  • Tipo de concesión (credenciales de cliente o contraseña)

Muestras de conector personalizado

Para ver ejemplos de conectores personalizados, consulte nuestro repositorio de GitHub, que incluye algunas de las acciones de solicitud más populares.

Pasos para usar los conectores personalizados

1. Cree una recopilación con solicitudes en una herramienta de desarrollo de API como Bruno y expórtela en el formato de recopilación de Postman.
2. Agregue una conexión personalizada en Intelligence e importe las solicitudes . Estas solicitudes ahora están disponibles como acciones que puede utilizar en los flujos de trabajo.
3. Configure un flujo de trabajo de automatización con acciones importadas para automatizar una tarea mediante la conexión personalizada en Intelligence.

Paso 1: crear recopilaciones de API

Vamos a utilizar Bruno para crear colecciones de solicitudes REST API. Consulte los artículos de la documentación de Bruno correspondientes. Estos son algunos artículos sugeridos.

• Crear recopilaciones
• Crear una solicitud

Configuraciones requeridas

• El nombre y la descripción proporcionados en estas solicitudes se utilizan en las acciones de flujo de trabajo en Intelligence.
  • Puede cambiarlos más tarde dentro de Intelligence.
• Añada encabezados como Content-Type: application/json.
  • Si no agrega encabezados como el tipo de contenido JSON, las API pueden usar XML de forma predeterminada y XML no es compatible con los conectores personalizados.
• Añada los encabezados personalizados requeridos por su API a todas las solicitudes de la recopilación de Postman.
  • Algunos ejemplos de encabezados personalizados serían los tipos de autenticación únicos basados en encabezados, tales como una clave de API o un token.
  • Intelligence retiene todos los encabezados excepto los encabezados de autenticación.
  • Reemplaza los encabezados de autenticación con las configuraciones de Tipo de autenticación en la recopilación personalizada.
  • Si Intelligence reemplaza el encabezado de autenticación, el sistema seguirá enviando su autenticación única basada en encabezado para su uso, ya que la habrá añadido a otras solicitudes de la recopilación.
• Envíe la solicitud para validarla.
  • La validación generará la respuesta.
• Comparta la recopilación y expórtela con el formato de recopilación de Postman.
  
• Para añadir un ID único a la recopilación, utilice un editor de archivos y añádalo después de la entrada en el archivo JSON.
  • Añada el identificador después de la entrada "name": en el archivo JSON.
  • Por ejemplo, añada "id": "sendMessage",
    

Paso 2: Agregar el conector personalizado en Intelligence

Importe el archivo JSON de la recopilación de Postman a Intelligence cuando añada un conector personalizado.

1. En Workspace ONE Intelligence, vaya a Integraciones > Conectores de flujo de trabajo y seleccione Añadir conector personalizado.
2. En el widget Añadir nuevo conector de flujo de trabajo, seleccione la pestaña Conector personalizado.
3. En Nombre del conector, introduzca un nombre que pueda identificarse para la conexión.
4. Para URL base, introduzca la URL del servicio de modo que Intelligence pueda autenticarse.
   • La URL del servicio y la URL de la conexión personalizada deben coincidir.
5. En Tipo de autenticación, seleccione el tipo de autenticación que se utilizará para acceder al servicio.
   • Autenticación básica: permite acceder a Intelligence mediante la introducción de las credenciales.
   • Autenticación de OAuth2: introduzca los detalles para que Intelligence pueda recuperar, actualizar y acceder a los tokens del servicio.
     • Necesita el identificador de cliente, la ubicación de autenticación del cliente, el tipo de concesión (credenciales o contraseña), la URL del token y el secreto de cliente.
     • Una opción opcional es Ámbito.
   • Sin autenticación: si no desea que Intelligence invalide los encabezados de autenticación, seleccione este elemento de menú.
6. Para importar su archivo JSON, utilice el vínculo selecciónelo en su ordenador situado en la parte central de la interfaz de usuario. La interfaz de usuario muestra la recopilación con sus solicitudes. Estas solicitudes ahora están disponibles como acciones para flujos de trabajo.
7. En la lista de acciones importadas, puede probar, editar y eliminar la acción.

Paso 3: Agregar un flujo de trabajo

Siga el proceso descrito en el tema Freestyle Orchestrator para crear flujos de trabajo.

Editar, eliminar y probar

Puede editar, eliminar y probar los conectores personalizados en Intelligence. Puede usar acciones en varios conectores, así que tenga en cuenta las consecuencias de la edición o de la eliminación antes de actuar.

• Eliminar: para eliminar un conector y las acciones asociadas, primero debe eliminar las acciones de todos los flujos de trabajo.
  • El conector se puede eliminar una vez que se eliminen todas las acciones de los flujos de trabajo.
  • Esta acción no es reversible.
• Editar: puede editar el nombre de la conexión, la descripción y los tipos de autenticación en cualquier momento.
  • Para editar los detalles de la solicitud de acción, edite la recopilación de API y, a continuación, vuelva a importarla en la conexión personalizada.
  • Si se editan los tipos de autenticación y se introducen las credenciales de forma incorrecta, las acciones no se podrán ejecutar.
  • Edite estos datos con precaución.
• Probar: pruebe los conectores personalizados en Intelligence para asegurarse de que Intelligence y el servicio puedan comunicarse.