> 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/docs.facephi-pt-br/produtos/landing/metodos-de-integracion/landing-sdk/configuracion.md).

# Configuração

Landing SDK pode ser instanciado de diferentes maneiras para se adaptar às diferentes casuísticas disponíveis.

A seguir, apresentamos as mais comuns:

***

### Criação do objeto padrão do Landing SDK

Para criar uma instância do Landing associada, utilizaremos o construtor do Landing SDK:

```javascript
const landingSDK = new LandingSDKClient('YOUR_APIKEY');
```

Esta instância terá a configuração padrão.

Agora será possível utilizar os métodos que o Landing SDK oferece.

***

### Configuração com URL única

{% hint style="info" %}
Este método só está disponível a partir da Versão 0.4.0.
{% endhint %}

O SDK permite gerar uma URL única para as páginas de destino; essa URL terá um tempo de validação de 15 minutos. Após esse tempo, a URL será invalidada e será necessário gerar uma nova. É importante configurar no Builder o parâmetro que permite desabilitar o acesso público às páginas de destino.

Para ativar este método, deve-se usar a seguinte configuração:

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

***

### **Configuração com Iframe**

O SDK de Landing permite que a página de destino seja iniciada em um iframe que se sobreporá à página do cliente.

Para ativar este método, deve-se usar a seguinte configuração:

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

{% hint style="warning" %}
**Nota**: No caso de usar os componentes dentro de um **iframe** é necessário **manter o foco dentro do contêiner** que integra os componentes do SDK Web.
{% endhint %}

{% hint style="info" %}
Para habilitar o modo iframe do SDK, a equipe de suporte da Facephi deve configurar as URL permitidas para incorporar o iframe. Esta é uma medida de segurança crítica projetada para proteger sua aplicação e seus usuários.

Se as URL permitidas não estiverem configuradas corretamente, os atacantes poderiam incorporar o iframe em sites não autorizados para se passar pela sua marca. Isso poderia levar a ataques de phishing direcionados aos seus clientes, o que poderia comprometer informações sensíveis.

Ao aplicar restrições de URL, somente os domínios confiáveis e preconfigurados poderão usar o iframe, o que reduz significativamente o risco de tais ataques.

Se você precisar do modo iframe para sua Integração, por favor entre em contato com a equipe de suporte da Facephi para fornecer uma lista das URL onde o iframe será incorporado.
{% endhint %}

{% hint style="danger" %}
Com este método ativado, quando o método for chamado `callLanding`, a página de destino será adicionada dentro da página do cliente com um iframe. Deve-se ter em conta que este iframe é colocado ocupando 100% da página em uma camada com `zIndex 100000`. Ou seja, se for colocado algo com um `zIndex` superior, ele se sobreporá à página de destino.
{% endhint %}

Uma vez que o processo da página de destino termine, o iframe será fechado. Se você desejar executar alguma funcionalidade depois que o processo da página de destino tiver sido finalizado, há um método que é executado a seguir:

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