Gancho en línea
Los ganchos en línea son llamadas salientes de miniOrange a un código personalizado/servicio externo/aplicación, que se activan durante los flujos de proceso de miniOrange. Están diseñados para integrar la funcionalidad personalizada sin problemas. En particular, miniOrange envía exclusivamente la respuesta SSO al gancho en línea, lo que permite que su código personalizado modifique esta respuesta antes de devolverla a miniOrange. Estos ganchos utilizan llamadas sincrónicas, que pausan temporalmente el proceso de miniOrange que inició el gancho hasta que se recibe una respuesta del servicio externo.
Este código personalizado debe implementarse como un servicio web con un punto final accesible a través de Internet. Debe estar alojado en un sistema externo a miniOrange. miniOrange define el contrato de API REST para las solicitudes enviadas al código personalizado y para las respuestas del código personalizado.
Pasos para configurar el miniOrange Inline Hook
- Vaya al Flujo de trabajo > Gancho en línea.
- Haga clic en Agregar nuevo gancho.
- En el campo Aplicaciones En el menú desplegable, seleccione la aplicación para la que desea invocar el gancho en línea.
- Se necesitan los siguientes detalles para crear un gancho en línea:
- URL del gancho en línea: La URL del punto final proporcionado por el servicio externo con el que desea realizar la integración. Esta URL es donde miniorange enviará las solicitudes HTTP.
- Solicitud HTTP: miniOrange creará una solicitud HTTP para enviarla al punto final del gancho en línea. Esta solicitud normalmente incluye el método de solicitud (POST, GET, PUT, DELETE), los encabezados y el cuerpo requeridos por el servicio de gancho en línea. El método de solicitud y los encabezados pueden variar según los requisitos específicos del gancho en línea.
- Autenticación: Los ganchos en línea en miniOrange se basan en mecanismos de autenticación para proteger la comunicación entre miniOrange y el código personalizado. A continuación, se muestra un desglose de las tres opciones:
- Autenticación básica: Este es un método de autenticación simple en el que se proporciona una combinación de nombre de usuario y contraseña. miniOrange codifica esta información mediante codificación Base64 y la envía en el encabezado de autorización de cada solicitud al punto final del enlace en línea. El servicio externo debe poder decodificar el encabezado y validar el nombre de usuario y la contraseña para garantizar el acceso autorizado.
- Encabezado HTTP: Este método proporciona más flexibilidad y seguridad en comparación con la autenticación básica. Define un nombre de encabezado personalizado (por ejemplo, X-Api-Key) y un valor secreto correspondiente en la configuración del gancho en línea de miniOrange. Luego, miniOrange incluye este encabezado con el valor secreto en cada solicitud a tu punto final. Tu código debe verificar la presencia de este encabezado y validar el valor secreto para la autorización.
- Sin autenticacion: Esta opción omite cualquier paso de autenticación. miniOrange envía solicitudes a su punto final de gancho en línea sin ninguna credencial.
- Haga clic en Enviar Formulario.
