> 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/configuracao-do-servidor-apache.md).

# Configuração do servidor Apache

O servidor Apache é responsável por publicar o Weknow Web e disponibilizar a interface da plataforma aos usuários por meio de um navegador. Além de hospedar a aplicação web, ele atua como intermediário entre as requisições dos usuários e os serviços disponibilizados pelo Weknow Servidor.

Após a instalação do ambiente, algumas configurações podem ser necessárias para adequar o Apache à infraestrutura da instituição, como definição de portas, utilização de HTTPS e publicação da aplicação para acesso interno ou externo.

***

### Função do Apache na arquitetura do Weknow

O Apache é o servidor web utilizado pelo Weknow para disponibilizar o acesso aos dashboards publicados.

Sua principal função é receber as requisições dos usuários e encaminhá-las ao Weknow Servidor, responsável pelo processamento das regras de negócio e pela comunicação com os bancos de dados da plataforma.

O fluxo simplificado de comunicação é representado abaixo.

<figure><img src="https://2272670858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe85p03cLIYvL7gAVHE90%2Fuploads%2FOejJjza8T1lyYO6YrG3p%2Fimage.png?alt=media&amp;token=e01d9cf1-6c5d-423a-bac8-fdfb26fbb290" alt="" width="375"><figcaption></figcaption></figure>

***

### Publicação do Weknow Web

Após a instalação do ambiente, o Apache publica automaticamente a interface web do Weknow.

O acesso normalmente é realizado por meio do endereço configurado para o servidor, utilizando as portas HTTP ou HTTPS definidas durante a instalação.

Em ambientes corporativos, recomenda-se utilizar um endereço DNS para facilitar o acesso dos usuários.

***

### Configuração das portas

O Apache utiliza, por padrão, as seguintes portas:

| Porta | Utilização |
| ----- | ---------- |
| 80    | HTTP       |
| 443   | HTTPS      |

Caso seja necessário, essas portas podem ser alteradas conforme as políticas de infraestrutura da instituição.

Antes de modificar qualquer porta, verifique se ela não está sendo utilizada por outro serviço do servidor.

***

### Utilização de HTTPS

Sempre que o ambiente for disponibilizado para acesso em produção, recomenda-se utilizar HTTPS.

A utilização de certificados digitais proporciona benefícios como:

* criptografia da comunicação;
* proteção das credenciais de acesso;
* maior segurança na transmissão dos dados;
* compatibilidade com recursos modernos dos navegadores.

Ambientes que utilizam integrações externas, como **iframes** ou publicação de dashboards em sistemas de terceiros, obrigatoriamente devem utilizar HTTPS.

***

### URL pública da aplicação

A URL pública define o endereço utilizado pelos usuários para acessar o Weknow Web.

Sempre que possível, recomenda-se utilizar um nome DNS amigável em vez do endereço IP do servidor.

Exemplo:

```
https://bi.minhainstituicao.com.br
```

Isso facilita o acesso dos usuários e simplifica futuras alterações de infraestrutura.

***

### Cliente Web encapsulado

O Weknow permite que o cliente web seja utilizado em diferentes cenários de publicação, conforme a arquitetura adotada pela instituição.

Em ambientes que utilizam aplicações externas ou portais corporativos, poderão ser necessárias configurações adicionais relacionadas à autenticação e ao compartilhamento seguro de cookies.

Essas configurações estão documentadas no artigo [Broken mention](broken://pages/nahEg3Ib8SEmSBGBZw5M).

***

### Boas práticas

Para garantir maior estabilidade e segurança do ambiente, recomenda-se:

* utilizar HTTPS em ambientes de produção;
* manter certificados digitais válidos;
* utilizar nomes DNS para acesso ao ambiente;
* evitar alterações desnecessárias nas portas padrão;
* restringir o acesso administrativo ao servidor Apache;
* reiniciar o serviço do Apache sempre que forem realizadas alterações em sua configuração.

***

### Solução de problemas

Caso ocorram problemas relacionados ao acesso ao Weknow Web, verifique os seguintes pontos:

* se o serviço do Apache está em execução;
* se as portas configuradas estão liberadas no firewall;
* se o certificado digital está válido (quando utilizar HTTPS);
* se a URL utilizada corresponde ao endereço publicado;
* se não existe outro serviço utilizando as mesmas portas.

Em ambientes que utilizam integrações externas, consulte também o artigo [Broken mention](broken://pages/nahEg3Ib8SEmSBGBZw5M)para verificar as configurações adicionais necessárias.

***

### Veja também

Dependendo da arquitetura adotada pela instituição, poderá ser necessário realizar configurações adicionais relacionadas ao servidor Apache.

Consulte também os seguintes artigos:

* [Broken mention](broken://pages/dYXXpSFYhGCv57Cq4dGf): apresenta como configurar múltiplas instâncias do Apache para distribuir as requisições ao Weknow Servidor, aumentando a disponibilidade e a capacidade de processamento do ambiente.
* [Broken mention](broken://pages/nahEg3Ib8SEmSBGBZw5M): descreve as configurações necessárias para publicação de dashboards e apresentações do Weknow em aplicações externas, incluindo requisitos de HTTPS e compartilhamento seguro de cookies de autenticação.
