> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/productos/landing/metodos-de-integracion/landing-sdk/configuracion.md).

# Configuración

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:

```javascript
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

{% hint style="info" %}
Este método solo está disponible a partir de la versión 0.4.0.
{% endhint %}

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:

```javascript
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:

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

{% hint style="warning" %}
**Nota**: En caso de utilizar los componentes dentro de un **iframe** es necesario **mantener el foco dentro del contenedor** que integra los componentes del SDK Web.
{% endhint %}

{% hint style="info" %}
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.
{% endhint %}

{% hint style="danger" %}
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.
{% endhint %}

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:

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