Esta publicación de blog te enseñará acerca de los conectores de Okta Workflows:
- Usar un conector preconfigurado
- Usar el Conector API preconstruido
- Use un conector creado con el Connector Builder
- Qué opción de conector usar
- Recursos de Okta Workflows
Usar un conector preconfigurado
Cuando comiences a construir con Okta Workflows, utiliza uno de los más de 60 conectores preconstruidos. Los conectores preconstruidos controlan aplicaciones o servicios web como Okta, Gmail, Office 365, Slack, Jira y otros.
Conectores de Okta Workflows.
Cada conector tiene acciones.
La siguiente es una lista parcial de acciones disponibles desde el conector de Okta:
Acciones del conector de Okta.
Estas acciones están disponibles desde el conector de Google Drive:
Lista parcial de acciones del conector de Google Drive.
Las acciones de Okta Workflows son endpoints de API entre bastidores.
Configurar una conexión
Debes crear una conexión para autenticarte con esa aplicación o servicio antes de llamar a las acciones. El método de autenticación depende del conector. Los tipos de autenticación incluyen claves API, Autenticación Básica, OAuth o personalizada.
Puede crear y guardar varias conexiones para un conector. Una conexión podría ser para una prueba y otra para los entornos de producción.
La página Connections muestra las conexiones que ha configurado:
Conexiones de Okta Workflows (lista parcial).
Llamar a una acción
Agrega una tarjeta de aplicación de acción en un flujo para llamar a una acción desde un conector.
Por ejemplo, la siguiente imagen muestra la llamada a la acción Read User desde el conector de Okta.
La acción Okta – Read User.
Detrás de las cámaras, la acción llama a la Get User Okta API al probar el flujo:
Ejecutando un flujo con la tarjeta Okta – Read User.
Una acción expone campos de entrada correspondientes a los parámetros de la solicitud API y campos de salida correspondientes a la respuesta de la solicitud API.
Usar las acciones del conector es más sencillo que configurar una llamada API manual. Configuras una conexión y la tarjeta te solicita que ingreses las entradas requeridas para ejecutar la acción.
Llamar a una acción personalizada
Okta Workflows tiene un conector Shopify preconstruido. El conector Shopify tiene las siguientes acciones:
Acciones del conector de Shopify.
La imagen a continuación muestra el uso de la acción Shopify – Create Customer del conector:
Shopify - Acción Crear cliente.
Digamos que quieres listar a todos los clientes en Shopify.
No verás una acción de Listar todos los clientes si miras la lista de acciones. Pero verás un punto final de la API que recupera una lista de clientes en la documentación para desarrolladores de Shopify.
¿Cómo llamas a este endpoint desde un flujo de Okta Workflows?
Cada conector tiene la acción Custom API Action que permite llamar a cualquier endpoint de la API en el conector.
Acción de Custom API Action.
La captura de pantalla a continuación muestra la tarjeta de Custom API Action de Shopify. La tarjeta reutiliza la información de conexión de Shopify y permite ingresar la URL relativa, la consulta y los parámetros de encabezado de la API.
Tarjeta de acción de API personalizada.
Usa la Acción de API personalizada en los siguientes casos de uso:
- Debe llamar a un punto final de API que no está disponible en el conector preconstruido.
- Hay una acción disponible en el conector preconstruido, pero no expone todos los parámetros de solicitud.
La siguiente captura de pantalla muestra el uso de la tarjeta Custom API Action para listar a todos los clientes en Shopify:
La tarjeta Shopify Custom API Action.
Puedes configurar los campos de Consulta y Encabezados si la API los requiere.
Probar el flujo con la tarjeta Custom API Action lista todos los clientes de Shopify:
Probando la tarjeta de Acción de API personalizada de Shopify.
Hasta ahora, ha aprendido sobre los conectores preconstruidos. Puede utilizar las acciones disponibles o las acciones personalizadas de la API.
En la siguiente sección, aprenderá a llamar a una API que no tiene un conector preconstruido en Okta Workflows.
Usar el Conector API preconstruido
Desea utilizar ShipEngine API para validar direcciones. ShipEngine no tiene un conector preconstruido en Okta Workflows. Puede utilizar el conector API Connector para llamar a ShipEngine API o a cualquier otra API que no tenga un conector preconstruido en Okta Workflows.
Selección del conector API.
En la siguiente captura de pantalla, verá los métodos HTTP cuando seleccione la opción API Connector:
Acciones del conector de API.
La API Validar una dirección de ShipEngine usa un POST. Elija la acción Post:
La tarjeta API Connector – Post.
Debes proporcionar los campos de URL, Consulta, Encabezados y Cuerpo para la solicitud de API. También debes configurar la autenticación para la solicitud.
Valida la dirección con la API de ShipEngine.
Para configurar la tarjeta API Connector – Post:
- Establezca el campo de la URL a https://api.shipengine.com/v1/addresses/validate.
- El servicio ShipEngine utiliza una clave API para la autenticación. La tarjeta Compose crea la cadena de clave API y la pasa al campo Headers.
- La tarjeta Compose crea la dirección para validar y la pasa al campo Body.
Ejecución del flujo para validar una dirección:
Validar la ejecución del flujo de la API de ShipEngine con la dirección.
Reutilizar información de conexión
Si utilizas una API a menudo, puedes mover la información de autenticación a una conexión y reutilizarla.
Conexión ShipEngine.
Con la autenticación API guardada en una conexión, puede reutilizar la conexión cuando llama a la API de ShipEngine:
Llamando a la API de ShipEngine.
Aprendió a llamar a una API utilizando el conector de API preconstruido. La siguiente sección le enseñará cómo construir un conector con la herramienta Connector Builder.
Use un conector creado con el Connector Builder
Si deseas que tu API tenga un conector precompilado, debes utilizar el Okta Workflows Connector Builder para crear un conector para la API. Verás el conector en la lista cuando añadas una acción de aplicación.
Conectores de Okta Workflows.
El Connector Builder es una herramienta de desarrollo sin código para crear conectores en la plataforma Okta Workflows. Connector Builder usa Okta Workflows (flujos, tarjetas de acción y función) para construir un conector.
Lanza el Connector Builder.
Te gusta la API de ShipEngine. Quieres que un constructor de Okta Workflows abra la lista de conectores y vea un icono y un conector para ShipEngine. Para ver un conector para la API de ShipEngine, debes crear el conector en el Connector Builder.
Connector Builder tiene varias vistas.
La pestaña Overview tiene información general sobre el conector.
Resumen del conector.
La pestaña Flows enumera los flujos que componen el conector.
- El flujo httpHelper gestiona la autenticación.
- El flujo _authping comprueba el estado de la conexión.
- El flujo Validate crea la acción Validate del conector.
- El flujo de Custom API Action crea la acción Custom API Action del conector.
Flujos del conector.
El siguiente flujo muestra la implementación de la acción Validar:
Acción Validate del conector.
La pestaña Test Connections contiene información de conexión para probar el conector.
La pestaña Deployment permite implementar el conector. Hay dos opciones de implementación.
- Implementación privada: el conector solo está disponible en tu organización de Okta.
- Implementación pública: el conector está disponible para todas las organizaciones y todos los creadores de Okta Workflows. Debe enviar el conector a Okta para que lo revise para su implementación pública.
Despliegue del conector.
Puede seleccionar el conector (PostOffice) de la lista de conectores:
Conector listado en la lista de conectores.
Utilice la acción Oficina de correos - Validar para validar una dirección:
Validar una dirección con el conector PostOffice.
Ejecutando el flujo:
Validación de una dirección.
Qué opción de conector usar
Aprendiste sobre tres formas de llamar a las APIs en Okta Workflows:
- Use the pre-built connectors.
- Cuando un conector no es compatible con un punto final de API específico, usa la acción de API personalizada para llamar a cualquier API en el conector.
- Usar la tarjeta API Connector.
- Mueva la información de autenticación a una conexión para reutilizarla.
- Utilice el Connector Builder para crear un conector para una API.
Utilice los conectores preconstruidos y la tarjeta API Connector con mayor frecuencia. Los conectores preconstruidos y la tarjeta API Connector ofrecen una solución ligera para las llamadas API a los servicios.
Utilice el Connector Builder para crear una experiencia de conector preconstruida para el creador de automatizaciones. Un conector preconstruido ayuda a los miembros del equipo que no están familiarizados con el trabajo con las API.
Lee When to Use Connector Builder and when to Use the API Connector para aprender más.
Recursos de Okta Workflows
📖 Documentación del Creador de conectores.
📺 Building a Custom Connector in Okta Workflows, a Video Series.
🍫 Obtenga ayuda de los especialistas de Workflows durante el horario de oficina comunitario semanal.
🛟 Obtenga ayuda del soporte técnico: analice un tema de Workflows o haga una pregunta.
🙋🏻♀️ Obtenga ayuda de la comunidad: únase al canal #okta-workflows en MacAdmins Slack.
