> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.2/infraestrutura-instalacao-e-requisitos/configuracoes-criticas-do-servidor/integracoes-externas-https-cookies-e-iframe.md).

# Integrações externas (HTTPS, cookies e iframe)

### Visão geral

O Weknow permite que dashboards e apresentações sejam publicados em aplicações externas, como portais corporativos, sistemas de gestão e páginas que utilizam componentes HTML, como **iframe**.

Devido às políticas de segurança adotadas pelos navegadores modernos, algumas configurações adicionais podem ser necessárias para garantir o funcionamento correto da autenticação e da validação da sessão do usuário.

***

### Quando essa configuração é necessária

Esta configuração deve ser aplicada quando o Weknow for acessado por meio de:

* aplicações que utilizam **iframe**;
* portais corporativos;
* sistemas de terceiros que incorporam dashboards ou apresentações do Weknow;
* outras integrações que utilizem links públicos do Weknow.

***

### Requisitos

Para esse tipo de integração, é necessário que:

* o ambiente esteja publicado utilizando **HTTPS**;
* o servidor Apache esteja configurado para enviar os cookies de autenticação com os atributos de segurança necessários;
* as configurações descritas neste artigo sejam aplicadas.

***

### Configuração do arquivo `config.ini`

No arquivo **config.ini**, localizado na pasta **Common**, adicione ou altere a seguinte configuração:

```
[server]
authSetCookie=HttpOnly;Path=/;SameSite=None
```

***

### Configuração do Apache

No arquivo de configuração do Apache, adicione a seguinte diretiva ao final do arquivo:

```
<Location /weknow>
<IfModule mod_headers.c>
        Header edit Set-Cookie "^(?!.*(?i); Secure)(.*)$" "$1; Secure"
</IfModule>
</Location>
```

***

### Importante

Os atributos **SameSite=None** e **Secure** devem ser utilizados em conjunto.

Caso apenas uma das configurações seja aplicada, os navegadores modernos poderão bloquear o compartilhamento dos cookies de autenticação, impedindo o funcionamento correto da integração.

Após realizar essas alterações, reinicie o serviço do Apache para que as novas configurações sejam aplicadas.

***

### Validação

Após reiniciar o Apache:

1. Acesse a aplicação externa.
2. Abra um dashboard ou apresentação do Weknow.
3. Verifique se a autenticação ocorre normalmente e se não são apresentadas mensagens relacionadas à validação de token.

***

{% hint style="danger" icon="triangle-exclamation" %}

### Observações

Essas configurações são necessárias apenas para ambientes que publicam dashboards ou apresentações do Weknow em aplicações externas.

Ambientes acessados diretamente pelo navegador não exigem essa configuração adicional.
{% endhint %}