Proxy e conexões

Proxy

Esta seção cobre a configuração de proxy via variáveis de ambiente. Como alternativa, a configuração de proxy também é possível via interface do Zammad. Você pode encontrar mais informações sobre isso na seção de rede da documentação de administração.

	GUI configuration	Environment variable
Host OS access required	No	Yes
Automatically excluded loopback addresses	Yes	No
Configuration check	Yes	Manually via test script
Exceptions	Yes	No

As seguintes variáveis de ambiente podem ser usadas para configurar as opções de proxy. Ajuste os valores de acordo com o seu ambiente.

HTTP_PROXY

variável para tráfego HTTP. Defina-a com o endereço do seu servidor proxy, incluindo a porta. Não funciona no contexto Docker. Exemplo:

export HTTP_PROXY="http://127.0.0.1:8080"

HTTPS_PROXY

variável para tráfego HTTPS. Defina-a com o endereço do seu servidor proxy, incluindo a porta. Não funciona no contexto Docker. Exemplo:

export HTTPS_PROXY="http://127.0.0.1:8080"

NO_PROXY

variável para endereços que devem ser acessados diretamente e sem proxy. Espera uma lista de endereços separados por vírgula e suporta curingas. Use um . no início como curinga para subdomínios; por exemplo, .example.com corresponderia a example.com e todos os seus subdomínios. Certifique-se de incluir endereços de loopback para excluí-los do roteamento via proxy. Exemplo:

export NO_PROXY="localhost,127.0.0.1,.example.com"

ES_JAVA_OPTS

variável para definir um proxy para o Elasticsearch. Por padrão, o Elasticsearch não se comunica com sistemas externos durante a operação. No entanto, pode haver casos em que isso é necessário. Exemplo:

export ES_JAVA_OPTS="-Dhttp.proxyHost=127.0.0.1 -Dhttp.proxyPort=8080 -Dhttps.proxyHost=127.0.0.1 -Dhttps.proxyPort=8080"

TIP

Dependendo do seu ambiente, você pode querer usar as variantes em minúsculas das variáveis também. Em caso de dúvida, defina ambas as variantes especificando-as adicionalmente com os valores das variantes em maiúsculas, por exemplo:

export http_proxy=$HTTP_PROXY

Conexões externas

Durante a instalação e operação do Zammad, algumas conexões a serviços online são necessárias. Dependendo do seu método de instalação e configuração do Zammad, uma conexão aos seguintes serviços é feita (também pode ser útil para configuração de firewall):

Address	Comment
dl.packager.io	Download do pacote do SO (instalação via pacote)
go.packager.io	Como acima; novo serviço de hospedagem de pacotes
geo.zammad.com	Usado para dados geográficos
google.com	Download de feriados para o calendário
index.rubygems.org	Download de gems do ruby
registry.npmjs.org	Download de dependências js

Você pode usar um script para verificar o estado de conexão do seu sistema. Ele tenta se conectar aos serviços mencionados acima e mostra o resultado. Se todas as conexões forem bem-sucedidas, ele exibe uma marca de verificação para cada serviço contatado. Execute-o buscando-o do repositório do Zammad ou executando a versão local na sua máquina do Zammad.

Buscar script remotamente:

curl -fsSL https://raw.githubusercontent.com/zammad/zammad/refs/heads/stable/contrib/packager.io/test_download_dependencies_connection.sh | sh

Usar script local:

/opt/zammad/contrib/packager.io/test_download_dependencies_connection.sh

Web push notifications

Zammad can notify agents about their tickets on mobile devices. These notifications are delivered as web push messages of the device's browser. On Android, a supported browser and the installed mobile view can both receive them. On iPhone and iPad, the mobile view has to be added to the home screen first. How to set them up on a device is described in the mobile view documentation.

The messages are sent by the background worker of Zammad over HTTPS (port 443) to the push service of the browser vendor. A firewall that restricts outgoing traffic has to allow the following addresses, including their subdomains:

Address	Comment
fcm.googleapis.com	Web push for Chrome and other Chromium-based browsers
jmt17.google.com	Alternative address of the Google push service
notify.windows.com	Web push for Microsoft Edge
push.services.mozilla.com	Web push for Mozilla Firefox
web.push.apple.com	Web push for Safari on iPhone, iPad and Mac

The proxy configuration described above applies to these connections as well, including the no-proxy list of the GUI configuration and the NO_PROXY environment variable.

Zammad only accepts device subscriptions of the push services listed above. A browser that uses another push service cannot enable push notifications.

There is nothing to configure in Zammad. The key pair used to sign the messages (VAPID) is generated once per installation and is not meant to be changed: all existing device subscriptions become invalid if it changes.

The push service of the browser vendor delivers the messages, not Zammad. Depending on the device, delivery can take a while, for example when battery optimization delays it on Android devices. A message that cannot be delivered right away is kept by the push service for up to one day. On iPhone and iPad, several messages about the same ticket stay as separate notifications, while other platforms replace the previous one.