Conectores de flujo de trabajo
Agregue y utilice conectores administrados y conectores personalizados en el área Conectores de flujo de trabajo de Workspace ONE Intelligence. Los conectores de flujo de trabajo se basan en nuestro sistema de administración de conectores (CMS), que administra todas las acciones y las configuraciones de conectores administrados para los servicios de Workspace ONE salientes y las integraciones de terceros. También administra todas las configuraciones y acciones de conectores personalizados para ampliar la arquitectura inicial de automatizaciones.
Documentación adicional
Para obtener más información sobre Freestyle y los flujos de trabajo, consulte el artículo del blog.
Conectores administrados
Los conectores administrados, nativos o de terceros, se preinicializan o se agregan para que pueda utilizar sus acciones en los flujos de trabajo. Algunos ejemplos de conectores administrados preinicializados incluyen Servicios de Hub 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 Workspace ONE 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 utilizan las REST API para la comunicación y la herramienta de desarrollo de API Postman para crear solicitudes estándar.
Requisitos
Para agregar conectores personalizados, importe su recopilación de Postman. Las solicitudes en el archivo JSON de Postman son las acciones. Después de importar la recopilación, las acciones están disponibles para su uso en los flujos de trabajo.
- Cree una colección de Postman.
- El servicio que desee conectar debe admitir los tipos de contenido JSON y REST API.
- Workspace ONE 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 el proxy inverso con API de VMware Workspace ONE UEM.
- Si usa OAuth2 para la autenticación, configure los detalles de autorización para que Workspace ONE 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.
Postman para crear REST API estándar
Workspace ONE Intelligence usa Postman para estandarizar las REST API que utiliza el sistema para conectarse y actuar con los servicios internos y de terceros. Crea acciones con una interfaz de plantilla de REST conocida que permite volver a utilizar las acciones guardadas. La versión gratuita de Postman tiene las funciones necesarias para crear recopilaciones para los conectores personalizados.
La versión gratuita de la aplicación tiene las funciones para crear colecciones con solicitudes y exportarlas para flujos de trabajo .
Este tema sirve como descripción general de lo que se debe hacer para crear y exportar una recopilación. Su finalidad es servir como referencia. Consulte el centro de formación de Postman para obtener las instrucciones más recientes sobre cómo configurar el producto Postman.
Obtenga la aplicación Postman en la dirección https://www.getpostman.com.
Pasos para usar los conectores personalizados
- Cree una colección con solicitudes en Postman y expórtela.
- Agregue una conexión personalizada en Workspace ONE Intelligence e importe las solicitudes . Estas solicitudes ahora están disponibles como acciones que puede utilizar en los flujos de trabajo.
- Configure un flujo de trabajo de automatización con acciones importadas para automatizar una tarea mediante la conexión personalizada en Workspace ONE Intelligence.
Paso 1: Crear la colección de Postman
Use la aplicación Postman para crear las REST API estándar para los conectores personalizados. Este contenido ofrece un flujo de trabajo general para crear y exportar recopilaciones de Postman como archivos JSON.
Las recopilaciones de Postman (acciones) para conectores personalizados ahora requieren un campo de ID. El ID debe ser único para cada acción. Si el ID ya existe en la instancia, Intelligence ignora la acción. Si se utiliza un ID duplicado en una importación, se muestra un mensaje de error.
Puede agregar acciones con el mismo nombre y descripción a las recopilaciones, pero estas acciones deben tener ID únicos.
- Agregue una recopilación.
-
Agregue y configure las solicitudes en la recopilación.
-
El nombre y la descripción proporcionados en estas solicitudes se utilizan en las acciones de flujo de trabajo en Workspace ONE Intelligence. Puede cambiarlos más tarde dentro de Workspace ONE Intelligence. A continuación, se muestra un ejemplo de una entrada en una solicitud de Postman y cómo se procesa como una acción en los flujos de trabajo de Workspace ONE Intelligence.


-
Considere la posibilidad de añadir encabezados tales 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.
- Agregue 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. Workspace ONE 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 Workspace ONE 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á agregado a otras solicitudes.
- Envíe la solicitud para validarla. La validación generará la respuesta.
- Guarde la respuesta como un ejemplo para la documentación. El protocolo Open API requiere este paso.
- Guarde la solicitud.
- Agregue más solicitudes según sea necesario.
- Exporte la colección como Collection v2.1.
- Para agregar un ID único a la recopilación, utilice un editor de archivos y agréguelo después de la entrada
"name":
en el archivo JSON. 
Paso 2: Agregar el conector personalizado en Intelligence
Importe el archivo JSON de la recopilación de Postman a Intelligence cuando agregue un conector personalizado.
Si importa una recopilación de Postman con un ID duplicado, Intelligence muestra el error Invalid Postman JSON file
. Edite una de las recopilaciones con un ID único y vuelva a importarla a Intelligence.
- En Workspace ONE Intelligence, vaya a Integraciones > Conectores de flujo de trabajo, seleccione Agregar y, a continuación, seleccione Agregar conector personalizado.
- En Nombre del conector, introduzca un nombre que pueda identificarse para la conexión.
- Para URL base, introduzca la URL del servicio de modo que Workspace ONE Intelligence pueda autenticarse. La URL del servicio y la URL de la conexión personalizada deben coincidir.
- En Tipo de autenticación, seleccione el tipo de autenticación que se utilizará para acceder al servicio. Workspace ONE Intelligence reemplaza los encabezados de autenticación de Postman en las recopilaciones con este ajuste. Si el servicio utiliza un tipo de autenticación único basado en encabezado, agregue el encabezado a todas sus solicitudes en la recopilación de Postman y configure la URL base. En este caso, Workspace ONE Intelligence utiliza los encabezados configurados en la recopilación de Postman. Los ejemplos de tipos de autenticación basados en encabezados utilizan una clave de API o un token.
- Autenticación básica: permite acceder a Workspace ONE Intelligence mediante la introducción de las credenciales.
- Autenticación de OAuth2: introduzca los detalles para que Workspace ONE Intelligence pueda recuperar, actualizar y acceder a los tokens del servicio.
- Sin autenticación: si no desea que Workspace ONE Intelligence invalide los encabezados de autenticación, seleccione este elemento de menú.
- Para importar el archivo JSON de Postman, utilice el vínculo selecciónelo en su equipo situado en la parte central de la interfaz de usuario. La interfaz de usuario muestra la recopilación con sus solicitudes. Estas solicitudes de Postman ahora están disponibles como acciones para flujos de trabajo .
- En la lista de acciones importadas, puede probar, editar y eliminar la acción.
Paso 3: Añadir 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 Workspace ONE 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 Postman y, a continuación, vuelva a importarla en la conexión personalizada. Aviso: 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 Workspace ONE Intelligence para asegurarse de que Workspace ONE Intelligence y el servicio puedan comunicarse.