4 Macros de usuário secretas
Visão geral
O Zabbix fornece duas opções para proteger informações confidenciais nos valores das macros de usuário:
- Texto secreto
- Segredo do Vault
Embora o valor de uma macro secreta fique oculto, ele pode ser revelado por meio do uso em items.
Por exemplo, em um script externo, uma instrução echo referenciando uma macro secreta pode ser usada para revelar o valor da macro para o frontend, porque o Zabbix server tem acesso ao valor real da macro.
Veja locais onde os valores das macros secretas são desmascarados.
Macros secretas não podem ser usadas em expressões de trigger.
Texto secreto
Com macros de texto secreto, o valor da macro é mascarado com asteriscos.
Para tornar o valor de uma macro secreto, clique no botão no final do campo Value e selecione a opção Secret text:

Depois que a configuração for salva, não será mais possível visualizar o valor.
Para alterar o valor da macro, passe o mouse sobre o campo Value e clique no botão Set new value (aparece ao passar o mouse):

Quando você clica no botão Set new value (ou altera o tipo de valor da macro), o valor atual será apagado.
Você pode restaurar o valor original clicando na seta
no final do campo Value (disponível apenas antes de salvar a nova configuração).
Observe que restaurar o valor original não o revelará.
URLs que contenham uma macro secreta não funcionarão, pois a macro nelas será resolvida como "******".
Segredo do Vault
Com macros de segredo do Vault, o valor da macro é armazenado em um software externo de gerenciamento de segredos (vault).
Para configurar uma macro de segredo do Vault, clique no botão no final do campo Value e selecione a opção Vault secret:

O valor da macro deve apontar para um segredo do vault. O formato de entrada depende do provedor do vault. Para exemplos de configuração específicos de cada provedor, consulte:
Os valores das macros secretas do Vault são recuperados do vault pelo Zabbix server a cada atualização dos dados de configuração e, em seguida, armazenados no cache de configuração.
O Zabbix proxy recebe os valores das macros secretas do Vault do Zabbix server em cada sincronização de configuração e os armazena em seu próprio cache de configuração. O proxy nunca recupera os valores das macros diretamente do vault. Isso significa que um Zabbix proxy não pode iniciar a coleta de dados após uma reinicialização até receber a atualização de configuração do Zabbix server.
Para atualizar manualmente os valores secretos do vault, use a opção secrets_reload runtime control.
A criptografia deve estar habilitada entre o Zabbix server e o proxy; caso contrário, uma mensagem de aviso do server será registrada.
Se um valor de macro não puder ser recuperado com sucesso, o item correspondente que usa esse valor ficará unsupported.
Locais sem mascaramento
Esta lista fornece os locais dos parâmetros em que os valores de macro secreta não são mascarados.
Desde o Zabbix 7.0.13, os valores de macro secreta permanecerão mascarados nos locais abaixo se forem referenciados indiretamente.
Por exemplo, {ITEM.KEY}, {ITEM.KEY<1-9>}, {LLDRULE.KEY} macros internos usados em tipos de mídia (parâmetros de Script ou Webhook) serão resolvidos para chaves de item contendo macros secretas mascaradas, como net.tcp.port[******,******] em vez de net.tcp.port[192.0.2.1,80].
| Contexto | Parâmetro | |
|---|---|---|
| Items, protótipos de item, regras LLD | ||
| Item | Parâmetros da chave do item | |
| Protótipo de item | Parâmetros da chave do protótipo de item | |
| Regra de descoberta de baixo nível | Parâmetros da chave do item de descoberta | |
| SNMP agent | Comunidade SNMP | |
| Nome do contexto (SNMPv3) | ||
| Nome de segurança (SNMPv3) | ||
| Frase-senha de autenticação (SNMPv3) | ||
| Frase-senha de privacidade (SNMPv3) | ||
| HTTP agent | URL | |
| Campos de consulta | ||
| Corpo da requisição | ||
| Cabeçalhos | ||
| Nome de usuário | ||
| Senha | ||
| Senha da chave SSL | ||
| Script | Parâmetros | |
| Script | ||
| Browser | Parâmetros | |
| Script | ||
| Database monitor | Consulta SQL | |
| TELNET agent | Script | |
| Nome de usuário | ||
| Senha | ||
| SSH agent | Script | |
| Nome de usuário | ||
| Senha | ||
| Simple check | Nome de usuário | |
| Senha | ||
| JMX agent | Nome de usuário | |
| Senha | ||
| Pré-processamento do valor do item | ||
| Etapa de pré-processamento JavaScript | Script | |
| Cenários web | ||
| Cenário web | Valor da variável | |
| Valor do cabeçalho | ||
| URL | ||
| Valor do campo de consulta | ||
| Valor do campo de postagem | ||
| Postagem bruta | ||
| Autenticação do cenário web | Usuário | |
| Senha | ||
| Senha da chave SSL | ||
| Conectores | ||
| Conector | URL | |
| Nome de usuário | ||
| Senha | ||
| Token | ||
| Proxy HTTP | ||
| Arquivo de certificado SSL | ||
| Arquivo de chave SSL | ||
| Senha da chave SSL | ||
| Descoberta de rede | ||
| SNMP | Comunidade SNMP | |
| Nome do contexto (SNMPv3) | ||
| Nome de segurança (SNMPv3) | ||
| Frase-senha de autenticação (SNMPv3) | ||
| Frase-senha de privacidade (SNMPv3) | ||
| Scripts globais | ||
| Webhook | Script JavaScript | |
| Valor do parâmetro do script JavaScript | ||
| Telnet | Nome de usuário | |
| Senha | ||
| SSH | Nome de usuário | |
| Senha | ||
| Script | Script | |
| Tipos de mídia | ||
| Script | Parâmetros do script | |
| Webhook | Parâmetros | |
| Gerenciamento IPMI | ||
| Host | Nome de usuário | |
| Senha | ||