Configuración

Configuración de Landing SDK en un entorno frontend.

Landing SDK puede instanciarse de diferentes maneras para adaptarse a las diferentes casuísticas disponibles.

A continuación presentamos las más comunes:

---

Creación del objeto Landing SDK por defecto

Para crear una instancia de la Landing asociada utilizaremos el constructor de Landing SDK:

const landingSDK = new LandingSDKClient('YOUR_APIKEY');

Esta instancia tendrá la configuración por defecto.

Ahora será posible utilizar los métodos que Landing SDK ofrece.

---

Configuración con URL única

Este método solo está disponible a partir de la versión 0.4.0.

El SDK permite generar una URL única para las páginas de destino; esta URL tendrá un tiempo de validación de 15 minutos. Después de ese tiempo, la URL se invalidará y se deberá generar una nueva. Es importante configurar en el Builder el parámetro que te permite deshabilitar el acceso público a las páginas de destino.

Para activar este método, se debe utilizar la siguiente configuración:

const landingSDK = new LandingSDKClient('YOUR_APIKEY',  {
  uniqueUrl: true
});

---

Configuración con Iframe

El SDK de Landing permite que la página de destino se inicie en un iframe que se superpondrá a la página del cliente.

Para activar este método, se debe utilizar la siguiente configuración:

const landingSDK = new LandingSDKClient('YOUR_APIKEY',  {
  iframe: true
});

Para habilitar el modo iframe del SDK, el equipo de soporte de Facephi debe configurar las URL permitidas para incrustar el iframe. Esta es una medida de seguridad crítica diseñada para proteger tu aplicación y a tus usuarios.

Si las URL permitidas no están configuradas correctamente, los atacantes podrían incrustar el iframe en sitios web no autorizados para suplantar tu marca. Esto podría llevar a ataques de phishing dirigidos a tus clientes, lo que podría comprometer información sensible.

Al aplicar restricciones de URL, solo los dominios de confianza y preconfigurados podrán usar el iframe, lo que reduce significativamente el riesgo de tales ataques.

Si necesitas el modo iframe para tu integración, por favor contacta al equipo de soporte de Facephi para proporcionar una lista de las URL donde se incrustará el iframe.

Con este método activado, cuando se llame al método callLanding, la página de destino se agregará dentro de la página del cliente con un iframe. Se debe tener en cuenta que este iframe se coloca ocupando el 100% de la página en una capa con zIndex 100000. Es decir, si se coloca algo con un zIndex superior, se superpondrá a la página de destino.

Una vez que el proceso de la página de destino finalice, el iframe se cerrará. Si deseas ejecutar alguna funcionalidad después de que el proceso de la página de destino haya finalizado, tienes un método que se ejecuta a continuación:

landingSDK.callLanding({
    onFinish: () = {
      /// Run your code here
    }
  })