Configuração

Configuração do Landing SDK em um ambiente frontend.

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:

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

Este método só está disponível a partir da Versão 0.4.0.

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:

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:

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

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.

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.

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.

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:

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