<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Isaque Profeta on Medium]]></title>
        <description><![CDATA[Stories by Isaque Profeta on Medium]]></description>
        <link>https://medium.com/@isaqueprofeta?source=rss-c04e79af8ce1------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*DJNRTha9-GAnOObVjw0qKw.png</url>
            <title>Stories by Isaque Profeta on Medium</title>
            <link>https://medium.com/@isaqueprofeta?source=rss-c04e79af8ce1------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 06:45:38 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@isaqueprofeta/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Customizing Grafana login screen and logo for your brand]]></title>
            <link>https://isaqueprofeta.medium.com/customizing-grafana-login-screen-and-logo-for-your-brand-c90d2dba0141?source=rss-c04e79af8ce1------2</link>
            <guid isPermaLink="false">https://medium.com/p/c90d2dba0141</guid>
            <category><![CDATA[visualization]]></category>
            <category><![CDATA[technology]]></category>
            <category><![CDATA[monitoring]]></category>
            <category><![CDATA[grafana]]></category>
            <category><![CDATA[devops]]></category>
            <dc:creator><![CDATA[Isaque Profeta]]></dc:creator>
            <pubDate>Wed, 16 Jun 2021 16:51:14 GMT</pubDate>
            <atom:updated>2021-06-29T15:14:40.694Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vx6tOaoTYfeWzDY_svrGow.png" /></figure><p>Graphic customization of Grafana, used version 7.5 for this tutorial, but already tried and the same works for 8.0. It is necessary to edit the original source code, make the desired changes, and compile/minify the JavaScript of Grafana app in a development environment, and then copy them to the production system.</p><blockquote>IMPORTANT: After each Grafana update, you’ll need to do the steps again, since the update will overwrite the files with the updated ones.</blockquote><p>It is preferable to use a Linux VM (the tutorial is using Ubuntu 20.04) for the development environment described below.</p><h3>1) Install dependencies:</h3><p>Install Git:</p><pre>sudo apt update<br>sudo apt install git</pre><p>Download and install GoLang:</p><pre>cd /tmp</pre><pre>curl -O <a href="https://storage.googleapis.com/golang/go1.9.3.linux-amd64.tar.gz">https://storage.googleapis.com/golang/go1.16.3.linux-amd64.tar.gz</a></pre><pre>tar -xvf go1.16.3.linux-amd64.tar.gz</pre><pre>sudo chown -R root:root ./go</pre><pre>sudo mv go /usr/local</pre><p>Set profile file for environment variables, to do that, add to end of file “~/.profile”:</p><pre>export PATH=$PATH:/usr/local/go/bin:$GOPATH/bin</pre><p>Close the Linux terminal you’re using (or logout) and open it again so that the profile update works, and after that, test the command:</p><pre>go version</pre><p>Now, downloading and installing Node.js, npm and yarn:</p><pre>cd /tmp<br>curl -sL <a href="https://deb.nodesource.com/setup_8.x">https://deb.nodesource.com/</a>setup_14.x -o nodesource_setup.sh</pre><pre>sudo bash nodesource_setup.sh</pre><pre>sudo apt-get install build-essential libssl-dev nodejs</pre><pre>sudo npm install --global yarn</pre><p>After that, test the commands:</p><pre>node -v<br>npm -v<br>yarn -v</pre><h3>2) Get Grafana’s source code, choose the version and install dependencies:</h3><p>Source Download :</p><pre>mkdir ~/projects/<br>cd ~/projects/</pre><pre>git clone <a href="https://github.com/grafana/grafana.git">https://github.com/grafana/grafana.git</a></pre><p>Choose your Grafana version (v7.5.7 in my example):</p><pre>cd ~/projects/grafana</pre><pre>git checkout v7.5.7</pre><p>Install frontend dependencies using yarn:</p><pre>yarn install --pure-lockfile</pre><h3>3) Running the development evironment:</h3><p>Use two terminals in Linux, or two connections to the VM, both in the Grafana source folder:</p><p>In the first terminal compile and run the backend server:</p><pre>cd ~/projects/grafana</pre><pre>make run</pre><p>Leave the server running on this first terminal, you will know that it is running correctly when the terminal stops in the following log:</p><pre>INFO[06-08|22:13:40] HTTP Server Listen logger=http.server address=[::]:3000 protocol=http subUrl= socket=</pre><p>In the second terminal run yarn for the frontend application:</p><pre>cd ~/projects/grafana</pre><pre>yarn start</pre><p>Leave yarn running in this second terminal and wait (takes a while) for it to give you the following message:</p><pre>[<strong>./public/sass/grafana.dark.scss</strong>] 39 bytes {<strong>dark</strong>}<strong> [built]</strong> <br>[<strong>./public/sass/grafana.light.scss</strong>] 39 bytes {<strong>light</strong>}<strong> [built]</strong> <br>    + 6904 hidden modules <br>No issues found.</pre><p>Access the development Grafana in the browser <a href="http://localhost:3000/">http://localhost:3000</a></p><h3>4) Doing the customization:</h3><p><strong>Brand file:</strong> public/app/core/components/Branding/Branding.tsx</p><ol><li>You can change the options under “export class Branding” to change the texts:</li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/878/1*-MWI0XThTk0gEhmm1-eLgA.png" /><figcaption>To change the texts</figcaption></figure><p>2. You can add your images in public/img and change the path of the img in the Logos highlighted below:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*D0KCjwtldVnfkbYScxIzDg.png" /><figcaption>To change the images</figcaption></figure><p>To see the changes in <a href="http://localhost:3000/">http://localhost:3000</a> the local frontend application must be restarted manually stopping it with Ctrl+C and running “yarn start” again.</p><h3>5) Doing the final build for the production environment</h3><p>Now run “yarn start” again, stop it (Crtl+C) and make sure the public folder contains the following data:</p><pre>cd ~/projects/grafana</pre><pre>ls -w1 public                                                                             <br><strong>app</strong> <br><strong>build</strong> <br><strong>dashboards</strong> <br><strong>emails</strong> <br><strong>fonts</strong> <br><strong>img</strong> <br>robots.txt <br><strong>sass</strong> <br><strong>test</strong> <br><strong>vendor</strong> <br><strong>views</strong></pre><p>Replace the production Grafana’s public folder with the new one and restart the service. Below I’ll show you how to do it via ssh with scp, but you can do it as you prefer:</p><p>Copy files to temporary directory on server:</p><pre>scp -rv $GOPATH/src/github.com/grafana/grafana/public user@my.grafana.server:/tmp</pre><p>On the server prepare the replacement:</p><pre>ssh user@my.grafana.server</pre><pre>cd /tmp</pre><pre>mv public/ public-new/<br>mv public-new/ /usr/share/grafana</pre><p>Replace the folder and restart the service:</p><pre>service grafana-server stop</pre><pre>mv public/ public-old/<br>mv public-new public/</pre><pre>service grafana-server start</pre><p>Rollback in case of problems:</p><pre>service grafana-server stop<br>mv public/ public-new/<br>mv public-old/ public/<br>service grafana-server start</pre><p>Result on login screens and navigation logo:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vx6tOaoTYfeWzDY_svrGow.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/706/1*HlmLxkLX2a7uVMm-WytM7A.png" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c90d2dba0141" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Customização da tela de Login do Grafana]]></title>
            <link>https://medium.com/zabbix-brasil/customiza%C3%A7%C3%A3o-da-tela-de-login-do-grafana-93d895275e1b?source=rss-c04e79af8ce1------2</link>
            <guid isPermaLink="false">https://medium.com/p/93d895275e1b</guid>
            <category><![CDATA[grafana]]></category>
            <category><![CDATA[technology]]></category>
            <category><![CDATA[devops]]></category>
            <category><![CDATA[monitoring]]></category>
            <category><![CDATA[visualization]]></category>
            <dc:creator><![CDATA[Isaque Profeta]]></dc:creator>
            <pubDate>Wed, 09 Jun 2021 02:35:52 GMT</pubDate>
            <atom:updated>2021-06-29T15:14:50.661Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vx6tOaoTYfeWzDY_svrGow.png" /></figure><p>Customização gráfica do Grafana, realizado na versão 7.5 e já testado na 8.0. É necessário editar o código fonte original fazer as alterações desejadas e refazer a minificação do JavaScript da aplicação do Grafana em ambiente de desenvolvimento para então copiar os mesmos para produção.</p><blockquote>IMPORTANTE: A cada atualização do Grafana, os passos devem ser repetidos, uma vez que a atualização sobrescreve os arquivos alterados.</blockquote><p>Preferencialmente é indicado usar uma VM Linux (o tutorial está usando um Ubuntu 20.04) para o ambiente de desenvolvimento descrito abaixo.</p><h3>1) Instalar dependências:</h3><p>Instale o Git:</p><pre>sudo apt update<br>sudo apt install git</pre><p>Faça o download da GoLang:</p><pre>cd /tmp</pre><pre>curl -O <a href="https://storage.googleapis.com/golang/go1.9.3.linux-amd64.tar.gz">https://storage.googleapis.com/golang/go1.16.3.linux-amd64.tar.gz</a></pre><pre>tar -xvf go1.16.3.linux-amd64.tar.gz</pre><pre>sudo chown -R root:root ./go</pre><pre>sudo mv go /usr/local</pre><p>Ajustar arquivo de profile para as variáveis de ambiente, adicione ao final do arquivo “~/.profile”:</p><pre>export GOPATH=$HOME/projetos/go<br>export PATH=$PATH:/usr/local/go/bin:$GOPATH/bin</pre><p>Feche o terminal de trabalho que estiver usando (ou faça logout) e abra novamente para que funcione a atualização do profile, depois disso teste o comando:</p><pre>go version</pre><p>Download e instalação do Node.js, npm e yarn:</p><pre>cd /tmp<br>curl -sL <a href="https://deb.nodesource.com/setup_8.x">https://deb.nodesource.com/</a>setup_14.x -o nodesource_setup.sh</pre><pre>sudo bash nodesource_setup.sh</pre><pre>sudo apt-get install build-essential libssl-dev nodejs</pre><pre>sudo npm install --global yarn</pre><p>Depois disso teste os comandos:</p><pre>node -v<br>npm -v<br>yarn -v</pre><h3>2) Buscar o fonte do Grafana, escolher a versão e instalar dependências:</h3><p>Download do fonte:</p><pre>cd ~/projetos/</pre><pre>git clone https://github.com/grafana/grafana.git</pre><p>Escolha a versão do seu Grafana (v7.5.7 no meu exemplo — Uma atualização: o tutorial já foi testado e está funcionando na 8.0):</p><pre>cd ~/projetos/grafana</pre><pre>git checkout v7.5.7</pre><p>Instalar dependências do frontend usando o yarn:</p><pre>yarn install --pure-lockfile</pre><h3>3) Rodar o ambiente de desenvolvimento:</h3><p>Use <strong>dois terminais no linux ou duas conexões à VM</strong>, ambos na pasta do fonte do Grafana:</p><p>No primeiro terminal compile e execute o servidor de backend:</p><pre>cd ~/projetos/grafana</pre><pre>make run</pre><p>Deixe o servidor rodando nesse primeiro terminal, você vai saber que ele está rodando da forma certa quando o terminal parar na seguinte log:</p><pre>INFO[06-08|22:13:40] HTTP Server Listen logger=http.server address=[::]:3000 protocol=http subUrl= socket=</pre><p>No segundo terminal execute o yarn para a aplicação de frontend:</p><pre>cd ~/projetos/grafana</pre><pre>yarn start</pre><p>Deixe o yarn rodando nesse segundo terminal e aguarde (demora um pouco) ele dar a seguinte mensagem:</p><pre>[<strong>./public/sass/grafana.dark.scss</strong>] 39 bytes {<strong>dark</strong>}<strong> [built]</strong> <br>[<strong>./public/sass/grafana.light.scss</strong>] 39 bytes {<strong>light</strong>}<strong> [built]</strong> <br>    + 6904 hidden modules <br>No issues found.</pre><p>Acesse o Grafana de desenvolvimento no browser o http://localhost:3000</p><h3>4) Realizar as customizações:</h3><p><strong>Arquivo de Marca:</strong> public/app/core/components/Branding/Branding.tsx</p><ol><li>Você pode alterar as opções abaixo de “export class Branding” para alterar os textos:</li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/878/1*-MWI0XThTk0gEhmm1-eLgA.png" /><figcaption>Para alterar os textos</figcaption></figure><p>2. Você pode adicionar suas imagens em public/img e alterar o caminho dos img nos Logos destacados abaixo:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*D0KCjwtldVnfkbYScxIzDg.png" /><figcaption>Para alterar imagens</figcaption></figure><p>Para ver as mudanças no <a href="http://localhost:3000/">http://localhost:3000</a> a aplicação do frontend local deve ser reiniciada manualmente parando a mesma com Ctrl+C e executando novamente o “yarn start”.</p><h3>5) Fazer a build final para produção</h3><p>Após customizar, rode o ‘yarn start’ mais uma vez, pare o mesmo (Control+C) e certifique-se que a pasta public contem os seguintes dados:</p><pre>cd ~/projetos/grafana</pre><pre>ls -w1 public                                                                             <br><strong>app</strong> <br><strong>build</strong> <br><strong>dashboards</strong> <br><strong>emails</strong> <br><strong>fonts</strong> <br><strong>img</strong> <br>robots.txt <br><strong>sass</strong> <br><strong>test</strong> <br><strong>vendor</strong> <br><strong>views</strong></pre><p>Substitua a pasta public do Grafana de produção pela nova e reinicie o serviço, abaixo eu mostro como fazer via ssh com scp, você pode fazer como preferir:</p><p>Copiar arquivos para diretório temporário no servidor:</p><pre>scp -rv $GOPATH/src/github.com/grafana/grafana/public user@meu.servidor.grafana:/tmp</pre><p>No servidor preparar a substituição:</p><pre>ssh user@meu.servidor.grafana</pre><pre>cd /tmp</pre><pre>mv public/ public-novo/<br>mv public-novo/ /usr/share/grafana</pre><p>Substituir a pasta e reiniciar o serviço:</p><pre>service grafana-server stop</pre><pre>mv public/ public-velho/<br>mv public-novo public/</pre><pre>service grafana-server start</pre><p>Rollback no caso de problemas:</p><pre>service grafana-server stop<br>mv public/ public-novo/<br>mv public-velho/ public/<br>service grafana-server start</pre><p>Resultado nas telas de login e logo da navegação:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vx6tOaoTYfeWzDY_svrGow.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/706/1*HlmLxkLX2a7uVMm-WytM7A.png" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=93d895275e1b" width="1" height="1" alt=""><hr><p><a href="https://medium.com/zabbix-brasil/customiza%C3%A7%C3%A3o-da-tela-de-login-do-grafana-93d895275e1b">Customização da tela de Login do Grafana</a> was originally published in <a href="https://medium.com/zabbix-brasil">Zabbix Brasil</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Passos de Instalação do Zabbix 5.2 no Debian10 (buster)]]></title>
            <link>https://medium.com/zabbix-brasil/passos-de-instala%C3%A7%C3%A3o-do-zabbix-5-2-no-debian10-buster-8a8f19e52a01?source=rss-c04e79af8ce1------2</link>
            <guid isPermaLink="false">https://medium.com/p/8a8f19e52a01</guid>
            <category><![CDATA[infraestrutura]]></category>
            <category><![CDATA[zabbix]]></category>
            <category><![CDATA[iniciante]]></category>
            <category><![CDATA[ferramentas]]></category>
            <category><![CDATA[monitoramento]]></category>
            <dc:creator><![CDATA[Isaque Profeta]]></dc:creator>
            <pubDate>Sun, 27 Dec 2020 21:28:28 GMT</pubDate>
            <atom:updated>2023-05-11T14:22:07.260Z</atom:updated>
            <content:encoded><![CDATA[<h3>Passos de Instalação do Zabbix 6.0 no Debian11 (bullseye)</h3><p>Instalação do Zabbix 6 com PostgresSQL 15, todos os módulos em apenas uma máquina no Debian 11 com TimescaleDB (testado com um vagrant usando a imagem debian/bullseye64 no VirtualBox)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/500/1*fuA-9AwLy167BaHxDOgsNw.png" /></figure><blockquote>Todo o tutorial desta instalação prevê o uso direto do usuário root</blockquote><h4>Sistema Operacional</h4><p>Para o ambiente Debian Linux é necessário um pacote especificamente para a instalação de repositórios que usam chaves GPG:</p><pre>sudo apt-get -q update<br>sudo apt-get -q -y install gnupg2</pre><h4>Banco de dados: PostgreSQL 15</h4><p>É necessário adicionar o repositório para o Debian e instalar os pacotes do sistema de banco de dados, iniciando em seguida o serviço, e já habilitando o mesmo na inicialização:</p><pre>sudo echo &quot;deb <a href="http://apt.postgresql.org/pub/repos/apt">http://apt.postgresql.org/pub/repos/apt</a> $(lsb_release -cs)-pgdg main&quot; &gt; /etc/apt/sources.list.d/pgdg.list</pre><pre>wget --quiet -O - <a href="https://www.postgresql.org/media/keys/ACCC4CF8.asc">https://www.postgresql.org/media/keys/ACCC4CF8.asc</a> | sudo apt-key add -</pre><pre>sudo apt-get -q update</pre><pre>sudo apt-get -q -y install postgresql-15</pre><pre>sudo systemctl enable --now postgresql@15-main</pre><p>Uma edição necessária ao Zabbix, vamos habilitar tanto o acesso ao Banco de Dados via senha em MD5 e fazer a conectividade estar disponível para os IP’s externos (reiniciando o serviço em seguida):</p><pre>sudo sed -i &quot;s/ident/md5/g&quot; /etc/postgresql/15/main/pg_hba.conf</pre><pre>sudo sed -i &quot;s/#listen_addresses = &#39;localhost&#39;/listen_addresses = &#39;*&#39;/&quot; /etc/postgresql/15/main/postgresql.conf</pre><pre>sudo systemctl restart postgresql@15-main</pre><p>Pode-se então criar um usuário no banco de dados com senha e o Banco de Dados em si que vai ser usado (o segundo comando pode apresentar um erro de “<em>could not change directory</em>” que deve ser ignorado):</p><blockquote><strong>Atenção, troque a senha abaixo de exemplo “</strong>Z4bb1xD4t4b4s3<strong>”</strong></blockquote><pre>sudo -u postgres psql -c &quot;CREATE USER zabbix WITH ENCRYPTED PASSWORD &#39;Z4bb1xD4t4b4s3&#39;&quot; 2&gt;/dev/null</pre><pre>sudo -u postgres createdb -O zabbix -E Unicode -T template0 zabbix 2&gt;/dev/null</pre><h4>Zabbix Server 5.2</h4><p>Agora deve-se adicionar o repositório do Zabbix, instalando o zabbix-server-pgsql em seguida:</p><pre>cd /tmp</pre><pre>wget --quiet <a href="https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian11_all.deb">https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian11_all.deb</a></pre><pre>sudo dpkg -i zabbix-release_6.0-1+debian11_all.deb</pre><pre>sudo apt-get -q update</pre><pre>sudo apt-get -q -y install zabbix-server-pgsql zabbix-sql-scripts<br></pre><p>Importar em seguida o <em>schema</em> do banco de dados (novamente pode apresentar um erro de “<em>could not change directory</em>” que deve ser ignorado):</p><pre>zcat /usr/share/zabbix-sql-scripts/postgresql/server.sql.gz | sudo -u zabbix psql zabbix</pre><p>Alterar ou remover comentários, nas linhas de configuração referentes às credenciais de Banco de Dados no /etc/zabbix/zabbix_server.conf:</p><pre>DBHost=localhost<br>DBName=zabbix<br>DBUser=zabbix<br>DBPassword=&lt;password&gt;</pre><p>Iniciar o serviço do zabbix-server e habilitar o início automático com o sistema operacional:</p><pre>systemctl enable --now zabbix-server</pre><h4>Zabbix Frontend</h4><p>Considerando que o repositório do Zabbix já foi configurado, é necessário instalar os pacotes de <em>frontend</em> e de configurações do NGINX:</p><pre>sudo apt-get -q -y install zabbix-frontend-php php7.4-pgsql zabbix-nginx-conf</pre><p>Editar o arquivo /etc/php/7.4/fpm/pool.d/zabbix-php-fpm.conf adicionando a configuração de timezone:</p><pre>echo &quot;php_value[date.timezone] = America/Sao_Paulo&quot; &gt;&gt; /etc/zabbix/php-fpm.conf</pre><p>Iniciar primeiro o serviço do php-fpm e depois o do Nginx, habilitando também os mesmos no início com o sistema operacional:</p><pre>systemctl enable --now php7.3-fpm</pre><pre>systemctl enable --now nginx</pre><p>Agora configura-se o Zabbix para ser o Virtual Server principal na porta 80, e em seguida é necessário substituir o padrão do NGINX do Debian pelo padrão do Zabbix:</p><pre>sudo sed -i &quot;s/#        listen          80;/        listen 80 default_server;\\n        listen [::]:80 default_server;/&quot; /etc/zabbix/nginx.conf</pre><pre>sudo sed -i &quot;s/#        server_name     example.com;/        server_name _;/&quot; /etc/zabbix/nginx.conf</pre><pre>sudo rm /etc/nginx/sites-available/default</pre><pre>sudo rm /etc/nginx/sites-enabled/default</pre><pre>sudo rm /etc/nginx/conf.d/zabbix.conf</pre><pre>sudo ln -s /etc/zabbix/nginx.conf /etc/nginx/sites-available/default</pre><pre>sudo ln -s /etc/zabbix/nginx.conf /etc/nginx/sites-enabled/default</pre><p>Como este tutorial foca na língua portuguesa do Brasil, vamos habilitar no Debian todas as linguagens suportadas pelo Zabbix no Frontend Web:</p><pre>mkdir -p /var/lib/locales/supported.d/</pre><pre>rm -f /var/lib/locales/supported.d/local</pre><pre>cat /usr/share/zabbix/include/locales.inc.php | grep display | grep true | awk &#39;{$1=$1};1&#39; | cut -d&quot;&#39;&quot; -f 2 | sort | xargs -I &#39;{}&#39; bash -c &#39;echo &quot;{}.UTF-8 UTF-8&quot;&#39; &gt;&gt; /etc/locale.gen</pre><pre>dpkg-reconfigure --frontend noninteractive locales</pre><p>Reinicie primeiro o serviço do php-fpm e depois o do NGINX pausadamente (espere uns 10 segundos entre os comandos):</p><pre>systemctl restart php7.3-fpm</pre><pre>systemctl restart nginx</pre><h4>Zabbix Frontend — Setup Wizard</h4><p><strong>Normalmente</strong> existe a configuração via wizard web, mas essa configuração será feita pela linha de comando neste artigo. (<strong>caso prefira</strong>, pode usar o link do YouTube da versão antiga deste artigo na 5.0: <a href="https://www.youtube.com/watch?v=qYc_bs5VfpY">Link do vídeo</a>)</p><pre>sudo tee /etc/zabbix/web/zabbix.conf.php &lt;&lt;EOL<br>&lt;?php<br>    \$DB[&quot;TYPE&quot;] = &quot;POSTGRESQL&quot;;<br>    \$DB[&quot;SERVER&quot;] = &quot;localhost&quot;;<br>    \$DB[&quot;PORT&quot;] = &quot;5432&quot;;<br>    \$DB[&quot;DATABASE&quot;] = &quot;zabbix&quot;;<br>    \$DB[&quot;USER&quot;] = &quot;zabbix&quot;;<br>    \$DB[&quot;PASSWORD&quot;] = &quot;Z4bb1xD4t4b4s3&quot;;<br>    \$DB[&quot;SCHEMA&quot;] = &quot;&quot;;<br>    \$DB[&quot;ENCRYPTION&quot;] = false;<br>    \$DB[&quot;KEY_FILE&quot;] = &quot;&quot;;<br>    \$DB[&quot;CERT_FILE&quot;] = &quot;&quot;;<br>    \$DB[&quot;CA_FILE&quot;] = &quot;&quot;;<br>    \$DB[&quot;VERIFY_HOST&quot;] = false;<br>    \$DB[&quot;CIPHER_LIST&quot;] = &quot;&quot;;<br>    \$DB[&quot;VAULT_URL&quot;] = &quot;&quot;;<br>    \$DB[&quot;VAULT_DB_PATH&quot;] = &quot;&quot;;<br>    \$DB[&quot;VAULT_TOKEN&quot;] = &quot;&quot;;<br>    \$DB[&quot;DOUBLE_IEEE754&quot;] = true;<br>    \$ZBX_SERVER = &quot;localhost&quot;;<br>    \$ZBX_SERVER_PORT = &quot;10051&quot;;<br>    \$ZBX_SERVER_NAME = &quot;zabbix&quot;;<br>    \$IMAGE_FORMAT_DEFAULT = IMAGE_FORMAT_PNG;<br>EOL</pre><p>Agora basta acessar via Browser o Zabbix em <a href="http://ip_do_servidor/zabbix">http://ip_do_servidor/</a> (Essa instalação coloca o Zabbix direto na raiz do site “/” e não no “/zabbix”)</p><h4>Zabbix Agent para a instalação deste Zabbix Server</h4><p>Considerando que o repositório do Zabbix já está instalado (essa instalação coloca todos os módulos na mesma máquina), instale o agente:</p><pre>apt-get -q -y install zabbix-agent</pre><p>Edite, alterando ou removendo os comentários, se necessário nas linhas do arquivo /etc/zabbix/zabbix_agentd.conf:</p><pre>Server=127.0.0.1<br>ServerActive=127.0.0.1<br>Hostname=Zabbix server</pre><p>Inicie o serviço do zabbix-agent e habilite o início com o sistema operacional:</p><pre>systemctl enable --now zabbix-agent</pre><h4>Dando tudo certo</h4><p>Espere alguns segundos e veja que o host zabbix-server já está com agente verde e o ambiente pronto para uso.</p><h4>Caso algo dê errado</h4><p>Revise todo o passo-a-passo verificando o status dos serviços e as <em>logs</em>, e se precisar de ajuda dê um pulo no canal do <a href="https://t.me/ZabbixBrasil">Telegram do Zabbix Brasil</a>.</p><p>Zabbix Server:</p><pre>systemctl status zabbix-server</pre><pre>cat /var/log/zabbix/zabbix_server.log</pre><p>PostgreSQL:</p><pre>systemctl status postgresql-12</pre><pre>cat /var/log/postgresql/postgresql-12-main.log</pre><p>Nginx:</p><pre>systemctl status nginx</pre><pre>cat /var/log/nginx/error.log</pre><p>php-fpm:</p><pre>systemctl status php-fpm</pre><pre>cat /var/log/php7.3-fpm.log</pre><p>Zabbix Agente:</p><pre>systemctl status zabbix-agent</pre><pre>cat /var/log/zabbix/zabbix_agentd.log</pre><h3>Extra: TimescaleDB</h3><p>Para usar o sistema de particionamento de tabelas do TimescaleDB, primeiro é necessário adicionar o repositório para o mesmo e instalar a extensão:</p><pre>sudo echo &quot;deb <a href="https://packagecloud.io/timescale/timescaledb/debian/">https://packagecloud.io/timescale/timescaledb/debian/</a> $(lsb_release -cs) main&quot; &gt; /etc/apt/sources.list.d/timescaledb.list</pre><pre>wget --quiet -O - <a href="https://packagecloud.io/timescale/timescaledb/gpgkey">https://packagecloud.io/timescale/timescaledb/gpgkey</a> | sudo apt-key add -</pre><pre>sudo apt-get -q update</pre><pre>sudo apt-get -q install -y timescaledb-2-postgresql-15</pre><p>É preciso parar o zabbix-server para migração, em seguida executar o assistente de tunning do TimescaleDB, e aumentar um pouco o número de conexões disponíveis para depois reiniciar o SGBD e aplicar as mudanças:</p><pre>systemctl stop zabbix-server</pre><pre>echo &quot;shared_preload_libraries = &#39;timescaledb&#39;&quot; &gt;&gt; /etc/postgresql/15/main/postgresql.conf</pre><pre>sudo sed -i &quot;s/max_connections = 20/max_connections = 50/&quot; /etc/postgresql/15/main/postgresql.conf</pre><pre>echo &quot;timescaledb.license=timescale&quot; &gt;&gt; /etc/postgresql/15/main/postgresql.conf</pre><pre>sudo systemctl restart postgresql@15-main</pre><pre>sudo -u postgres timescaledb-tune --quiet --yes</pre><p>Após instalado o Banco de Dados do Zabbix precisa receber a extensão e receber os comandos do script de migração:</p><pre>echo &quot;CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;&quot; | sudo -u postgres psql zabbix 2&gt;/dev/null</pre><pre>cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix</pre><p>Após terminada a migração, pode-se iniciar novamente o zabbix-server e o frontend pausadamente (espere uns 10 segundos entre os comandos):</p><pre>systemctl start zabbix-server</pre><pre>systemctl restart php7.4-fpm</pre><pre>systemctl restart nginx</pre><p>Agora é possível configurar os prazos de dados no banco a partir do <em>frontend web</em> no caminho de <em>Administration -&gt; General -&gt; Housekeeping</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/738/1*oKdRxph93zYHb_Ay-0Muzw.png" /></figure><p><strong>Atualizado em 11/05/2023</strong> para o zabbix 6.0.</p><p><strong>Atualizado em 29/06/2021</strong> para o zabbix 5.4.</p><p><strong>Atualizado em 31/12/2020</strong> devido atualizações realizadas pela Zabbix Inc no release de pacotes do Debian.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8a8f19e52a01" width="1" height="1" alt=""><hr><p><a href="https://medium.com/zabbix-brasil/passos-de-instala%C3%A7%C3%A3o-do-zabbix-5-2-no-debian10-buster-8a8f19e52a01">Passos de Instalação do Zabbix 5.2 no Debian10 (buster)</a> was originally published in <a href="https://medium.com/zabbix-brasil">Zabbix Brasil</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Correlating Tor sources in ArcSight SIEM events using Python]]></title>
            <link>https://medium.com/analytics-vidhya/correlating-tor-sources-in-arcsight-siem-events-using-python-92750617227a?source=rss-c04e79af8ce1------2</link>
            <guid isPermaLink="false">https://medium.com/p/92750617227a</guid>
            <category><![CDATA[technology]]></category>
            <category><![CDATA[network-security]]></category>
            <category><![CDATA[networking]]></category>
            <category><![CDATA[python-programming]]></category>
            <category><![CDATA[security]]></category>
            <dc:creator><![CDATA[Isaque Profeta]]></dc:creator>
            <pubDate>Tue, 15 Dec 2020 23:37:53 GMT</pubDate>
            <atom:updated>2020-12-31T16:56:57.331Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/720/0*csi9qX28nHuXCAgU.png" /></figure><blockquote>Versão em português brasileiro <a href="https://isaqueprofeta.medium.com/correlacionando-origens-tor-em-eventos-do-siem-arcsight-usando-pyhton-3a91eeb3acfc">aqui</a>.</blockquote><h3>Introduction</h3><p>Anonymization, despite currently being a valuable resource on the internet, ends up being abused as a tool for many exploits and security attacks. Thus, integrating information about the usage of the Tor network (currently the main/largest anonymization network) and classifying access events to a Hosting/Web Services environment using a SIEM, assess the motivation of these accesses, is an important tactic.</p><p>This article presents a Use Case using Python and the requests library, using a Linux environment, for integrating the SIEM ArcSight ESM API with Active Lists to classify events from the Tor network.</p><h3>Review of concepts</h3><h4>SIEM</h4><p>A log is a computer system event record. For example, there are three logs for the Ubuntu Linux package installation system:</p><pre>$ tail -3 /var/log/dpkg.log<br>2020–10–04 17:24:52 status unpacked gcc: amd64 4: 7.4.0–1ubuntu2.3<br>2020–10–10 13:25:09 startup archives unpack<br>2020–10–10 13:25:13 status installed mime-support: all</pre><p>A Syslog tool is a software that aggregates information from logs of different hardware and/or software within an environment. In the example below, Linux Syslogd aggregates logs from the CRON, systemd, and anacron applications of an Ubuntu Linux operating system:</p><pre>$ tail -5 /var/log/syslog.1<br>Oct 10 23:59:01 ubuntu-desktop <strong>CRON[</strong>3344]: (root) CMD (command -v debian-sa1&gt; / dev / null &amp;&amp; debian-sa1 60 2)<br>Oct 11 00:02:46 ubuntu-desktop <strong>systemd</strong>[1]: Started Run anacron jobs.<br>Oct 11 00:02:46 ubuntu-desktop <strong>anacron</strong>[3430]: Anacron 2.3 started on 2020–10–11<br>Oct 11 00:02:46 ubuntu-desktop <strong>anacron</strong>[3430]: Will run job `cron.daily ‘in 5 min.<br>Oct 11 00:02:46 ubuntu-desktop <strong>anacron</strong>[3430]: Jobs will be executed sequentially</pre><p>Internet Providers and Hosting IT infrastructure have logs from various assets int the entire computational infrastructure, from Routers to Switches, including Firewalls, IPSs / IDSs, and reaching even the Application Servers and Databases. A Syslog Server joins this information in a central database of all events in that environment.</p><p>The set of tools that acts as a Security Information and Event Management, or SIEM, do a job like the Syslog Server, but with security features. This means that the logs go through an intelligence classification, generating security alerts according to the defined standards, also has a research and report generation interface. It’s also possible to trigger automated actions on Firewalls and/or IPSs that have support for external integrations.</p><blockquote>Alert example: A SIEM can have a rule that checks for a series of 404 error logs on a Web Server and if it finds access for several non-existent application directories in a brief period, it can generate alerts for an attempted Application Scan (example of an attack using tools like <a href="https://tools.kali.org/web-applications/dirb">dirb</a> for example).</blockquote><p>In this article, the <a href="https://www.microfocus.com/pt-br/products/siem-security-information-event-management/overview">Micro Focus’s ArcSight ESM</a> will be the SIEM tool.</p><h4>Tor</h4><p>Tor works as the users can use or act as random and encrypted nodes forming a path between all network participants. Thus, from the point of view of the destination of a network connection, the origin machine is not the one that is accessing the resource.</p><p>Using the <a href="https://2019.www.torproject.org/about/overview.html.en">official example</a> below, Alice’s computer uses a random path between the “nodes” of the network and then arrives at an “exit node”, and only them, access the destination server Bob having with its access anonymized since Bob doesn’t know Alice, he only sees the exit node’s request.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/508/0*n6t4lUvVc1Jg8gil.png" /><figcaption>Image of official documentation: <a href="https://2019.www.torproject.org/about/overview.html.en">https://2019.www.torproject.org/about/overview.html.en</a></figcaption></figure><p>The source resource for this article to classify that the traffic is coming from the Tor network is that Tor makes available the list of all exit nodes used to end access the connection destinations. This list, <a href="https://check.torproject.org/torbulkexitlist">which is frequently updated and available on Tor’s website</a>.</p><blockquote>For reference, there are two other lists with more information about Tor network nodes that were not used in the scope of this article:<br>- <a href="https://www.dan.me.uk/torlist/?exit">Exit nodes updated every 30 minutes</a><br>- <a href="https://www.dan.me.uk/torlist">All nodes (Entry / Guard, Middle and Exit), classified and updated every 30 minutes</a></blockquote><h3>Steps followed for this case implementation</h3><p>To avoid managing many ArcSight connectors, the choice was to directly interact with the tool’s Application Programming Interface (API), with the following steps:</p><ul><li>Get the IP list of Tor’s exit nodes using Python with the requests library.</li><li>Import these IP’s into an ArcSight’s Active List keeping it updated (a schedule).</li><li>Create a Rule in ArcSight to tag the events that have a source IP’s in that Active List.</li></ul><h3>Prerequisites</h3><h4>Python + PIP</h4><p>In this Use Case, Python was used in its version 3 (Language) and the Pip language library installer for that version 3.</p><pre>sudo apt update &amp;&amp; sudo apt install python3 python3-pip</pre><p>It is then confirmed that the Python in the operating system is version 3, by performing the test in the terminal:</p><pre>~ $ python -V<br>Python 3.6.9<br>~ $ pip -V<br>pip 20.1.1 from /home/isaque/.local/lib/python3.6/site-packages/pip (python 3.6)</pre><h4>Requests</h4><p>The access to data of the exit nodes repository, as well as for the integration with the ArcSight API, was performed by using the Python requests library. The installation can be done with the aid of Pip.</p><pre>pip install requests</pre><h4>Active List</h4><p>An Active List within Arcsight ESM is a data set, just like a database’s table or an Excel spreadsheet. This data set is used to store values ​​that can be compared with other SIEM resources. In this article, it’ll save the IP’s list of exit nodes.</p><p>For this, within the Arcsight ESM console, the Active List was created with only one Fields-based column called “ip” of the Ip Address type, with an expiration of one hour and the capacity for ten thousand results. Especially important to <strong>take note of the Active List Resource ID</strong>, that’s going to be required by the script.</p><blockquote>NOTE: An exclusive user was also created for this automation, being configured to have write privileges in this Active List.</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/960/0*hhIJxdf5pj7eayJk.png" /><figcaption>Creating the ActiveList in ArcSight ESM 7.2</figcaption></figure><h3>Fetch the IP list of Tor exit nodes</h3><h4>Fetching the list of networks</h4><p>A folder called “tor” was created to store the project and, inside it, the file “tor.py” was created.</p><pre>mkdir ./tor<br>touch ./tor/tor.py</pre><p>Starting the code of “tor.py” itself, the first step was to import the requests library, and then a GET was called to search the source for information about the exit nodes. Then, it is possible to view the result with the “print()” function:</p><pre><strong>import</strong> requests<br>tor_networks = requests.<strong>get</strong>(<br>    &#39;<a href="https://check.torproject.org/torbulkexitlist&#39;">https://check.torproject.org/torbulkexitlist&#39;</a><br>)<br><strong>print</strong>(tor_networks.text)</pre><blockquote>The result data of IP Addresses is the body response in text format. That is why is necessary to use “tor_networks.text”, since the result of “requests.get ()” is an object of Response type that has a Response.text attribute with the required data.</blockquote><p>With this, the content is already available to test in the terminal:</p><pre>python3 ./tor.py</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/829/0*4lqcBjLf0caBxR-O.png" /><figcaption>The first test getting data in VSCode</figcaption></figure><p>After this test, “print()” was replaced by a Python’s list variable, parsing the body text response using the line break “\n” with the help of string’s “split()” function for this purpose:</p><pre><strong>import</strong> requests<br>tor_networks = requests.<strong>get</strong>(<br>    &#39;<a href="https://check.torproject.org/torbulkexitlist&#39;">https://check.torproject.org/torbulkexitlist&#39;</a><br>)<br><strong>exit_nodes_data</strong> = tor_networks.text.<strong>split</strong>(&#39;\n&#39;)</pre><p>With the data collection done, it’s time to study the ArcSight for the integration.</p><h3>Import the IP’s into an ArcSight’s Active List</h3><h4>Interacting with the ArcSight’s API</h4><p>Now, the most complex issue, since it was not possible to find many good examples in the documentation related to the ArcSight’s API (version 7.2 of the ArcSight ESM in this Use Case). There is a subtle preference for the Java model with XML / SOAP, which makes it difficult to implement the API’s methods and attributes in other languages ​​with JSON / REST.</p><p>After study and research, the following resources were found to be useful:</p><ul><li><a href="https://h41382.www4.hpe.com/gfs-shared/downloads-273.pdf">PDF’s presentation</a> about automation.</li><li><a href="https://www.microfocus.com/documentation/arcsight/arcsight-esm-7.3/pdfdoc/ESM_ServiceLayer_DevGuide/ESM_ServiceLayer_DevGuide.pdf">ESM Service Layer</a> (Web Services) Developer’s Guide.</li><li>Discussions in the Micro Focus official forums (references: <a href="https://community.microfocus.com/t5/Archive-Discussion-Board/Full-REST-API-Documentation-For-ESM/td-p/1538807">1</a>, <a href="https://community.microfocus.com/t5/ArcSight-User-Discussions/Understanding-ESM-API-documentation/td-p/1657890">2</a>, <a href="https://community.microfocus.com/t5/ArcSight-User-Discussions/Execute-Query-via-ESM-REST-API/td-p/1791726">3</a>, and <a href="https://community.microfocus.com/t5/ArcSight-User-Discussions/ArcSight-ESM-API-for-Getting-the-Query-Viewer-Data/td-p/1687030">4</a>).</li></ul><p>Even so, official documentation leaves some holes, and forum responses are still vague. Reverse engineering some projects on GitHub helped to produce the following solution for using the API with JSON / REST:</p><p><strong>1:</strong> Identify in the <em>listServices</em> of the ArcSight ESM installation which API features need to be used (<em>Service</em> and <em>Operation</em>). This <em>listServices</em> is located at the URL below (except for administrative and login operations, as in these situations the <em>manager-services</em> in the URL are replaced to c<em>ore-services</em>).</p><blockquote>https://url-arcsight-esm:8443/www/manager-service/services/listServices</blockquote><p><strong>2:</strong> Access the Service’s WSDL (XML Descriptor) on this page, within the link that has the text: “<em>See Web Services Description Language (WSDL) here</em>”</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/967/0*MEEiQzlDC0TrYwuA.png" /><figcaption>listServices for ESM installation</figcaption></figure><p><strong>3: </strong>Search within the XML Descriptor for the chosen <em>Operation</em> and identify the search parameters</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/869/0*rFAONOnjtza8FmJC.png" /><figcaption>Element with Sequences that are the parameters used for search</figcaption></figure><blockquote>For JSON, one of the missing things in the documentation is the description of the “resource abbreviations”, necessary for the HTTP call. For this, a functional list was found in the description of the <a href="https://github.com/dawid-czarnecki/pyasesm/">pyaesm</a> project (which also makes interaction with Active Lists) contained in reference in the fourth step.</blockquote><p><strong>4:</strong> Select the <em>resource abbreviations</em> of Service according to the list below:</p><pre>“act” = “resource.manager / activeListService /”<br>“arc” = “resource.manager / archiveReportService /”<br>“cas” = “resource.manager / caseService /”<br>“cap” = “resource.manager / conAppService /”<br>“con” = “resource.manager / connectorService /”<br>“das” = “resource.manager / dashboardService /”<br>“dmq” = “resource.manager / dataMonitorQoSService /”<br>“dat” = “resource.manager / dataMonitorService /”<br>“drl” = “resource.manager / drilldownListService /”<br>“dri” = “resource.manager / drilldownService /”<br>“fie” = “resource.manager / fieldSetService /”<br>“fil” = “resource.manager / fileResourceService /”<br>“gra” = “resource.manager / graphService /”<br>“gro” = “resource.manager / groupService /”<br>“int” = “resource.manager / internalService /”<br>“man” = “resource.manager / managerAuthenticationService /”<br>“net” = “resource.manager / networkService /”<br>“by” = “resource.manager / portletService /”<br>“que” = “resource.manager / queryService /”<br>“qvs” = “resource.manager / queryViewerService /”<br>“rep” = “resource.manager / reportService /”<br>“res” = “resource.manager / resourceService /”<br>“sei” = “resource.manager / securityEventIntrospectorService /”<br>“sev” = “resource.manager / securityEventService /”<br>“ser” = “resource.manager / serverConfigurationService /”<br>“use” = “resource.manager / userResourceService /”<br>“vie” = “resource.manager / viewerConfigurationService /”<br>“inf” = “manager / infoService /”<br>“mss” = “manager / managerSearchService /”</pre><p><strong>5:</strong> Define the URL for endpoint API consumption in the format below, replacing the <em>Service</em> and <em>Operation</em> with the ones chosen above:</p><blockquote>https://url-arcsight-esm:8443/www/manager-service/rest/’Service’/’Operation’</blockquote><p>EXAMPLE:</p><blockquote>Clear ActiveLists using API:</blockquote><blockquote>1: Searched the <em>listServices</em> and found the Service “<em>ActiveListService</em>” then, studying its Operations, opted to test the “clearEntries” one.</blockquote><blockquote>2: The WSDL link was accessed to verify the necessary attributes.</blockquote><blockquote>3: Found the necessary attributes in XML Descriptor for the <em>Operation</em> of “<em>clearEntries</em>”, which are “<em>authToken</em>” and “<em>resourceId</em>”.</blockquote><blockquote>4: Find in the reference that the resource abbreviation for “<em>ActiveListService</em>” is “<em>act</em>”.</blockquote><blockquote>Final JSON payload for the call:</blockquote><pre>{<br> “<strong>act.clearEntries</strong>”: {<br> “act.<strong>authToken</strong>”: AUTHENTICATION_TOKEN,<br> “act.<strong>resourceId</strong>”: RESOURCE_ID_OF_ACTIVE_LIST<br> }<br>}</pre><blockquote><strong>5:</strong> The formatted endpoint is: https://url-arcsight-esm:8443/www/manager-service/rest/ActiveListService/clearEntries</blockquote><p>It is key to know this structure to ease of navigation and understatement of which calls, and which parameters are possible to use with them.</p><h4>Organization of script support code</h4><p>First, it is necessary to create a function in Python with requests to perform the login and have an authentication token, only then it’s possible to perform interactions with the API methods.</p><p>It was decided to separate this function in another file (a local library) to avoid duplicated code. And, in order not to leave credentials inside code files, a configuration file was created in the same folder.</p><pre>touch __init__.py<br>touch config.ini<br>touch api_arcsight.py</pre><p>The “__init__.py” file remains empty, easing the import process in the project, and the “config.ini” file stores the credentials that will be used to access ArcSight with the Python’s <em>configparser</em> module, this file is written in the following format:</p><pre><strong>[arcsight]<br>user</strong>=arcsight_user<br><strong>password</strong>=arcsight_password<br><strong>server</strong>=https://url-of-arcsight-esm:8443</pre><p>This file has the credentials of a specific user for automation, this kind of data should never be stored in version control tools, at most only a model example, called for example “config.ini.example”.</p><p>Now, in the “api_arcsight.py” file, the access to credentials is created with the <em>“ConfigParser”</em> object and using the “read()” and “get()” methods, which will read the “config.ini” data:</p><pre>import requests<br>import configparser</pre><pre>config = <strong>configparser.ConfigParser</strong>()<br>config.<strong>read</strong>(&quot;config.ini&quot;)</pre><pre>USER = config.<strong>get</strong>(&#39;arcsight&#39;, &#39;user&#39;)<br>PASSWORD = config.<strong>get</strong>(&#39;arcsight&#39;, &#39;password&#39;)<br>SERVER = config.<strong>get</strong>(&#39;arcsight&#39;, &#39;server&#39;)</pre><h4>Login function</h4><p>The “login” function was set up inside the first function of the “api_arcsight.py” file. In this case, first, the login endpoint was defined in ArcSight’s “core-services”, then HTTP headers were configured to set the format to JSON and, finally, a payload with user and password as defined in the format expected by the login endpoint.</p><pre>def login():<br>  &quot;&quot;&quot;<br>  Connects to arcsight and returns an API token<br>  &quot;&quot;&quot;<br>  <strong>login_endpoint</strong> = (<br>    SERVER + &#39;/www/<strong>core-service</strong>/rest/<strong>LoginService</strong>/<strong>login</strong>&#39;<br>  )  <br>  <strong>headers</strong> = {<br>    &#39;accept&#39;: &#39;application/<strong>json</strong>&#39;,<br>    &#39;content-type&#39;: &#39;application/<strong>json</strong>&#39;<br>  }  <br>  <strong>payload</strong> = {<br>    &#39;log.login&#39;: {<br>      &#39;log.<strong>login&#39;</strong>: USER,<br>      &#39;log.<strong>password&#39;</strong>: PASSWORD<br>    }<br>  }</pre><p>After this, a POST request was created for the defined endpoint of the core-services, having both payload and headers. Then the token was parsed from the path of the “Response.json()” dictionary, and the same was returned at the function’s end:</p><pre>try:<br>    resp = requests.<strong>post</strong>(<br>      <strong>login_endpoint</strong>,<br>      json=<strong>payload</strong>,<br>      headers=<strong>headers</strong>,<br>      verify=False<br>    )<br>    token = resp.json()[&#39;log.loginResponse&#39;][&#39;log.return&#39;]<br>  except Exception as e:<br>    print(&#39;Login error: {e}&#39;)<br>  <br><strong>  return token</strong></pre><blockquote>The option “verify=False” in “requests.post” is useful when ArcSight’s installation are configured with self-signed certificates, working as the option “Accept risk and continue” of browsers accessing the same site.</blockquote><p>Now, it is possible to execute the login function using these two lines:</p><pre><strong>import</strong> api_arcsight<br>AUTHENTICATION_TOKEN = <strong>api_arcsight.login</strong>()</pre><h4>Wrapper function to perform API searches</h4><p>To avoid code repetition when performing queries in ArcSight’s API, a wrapper function called “execute” was set up.</p><p>For this function, again the HTTP header was set to JSON format and then the endpoint, which in this function is using the <em>manage-service</em> and the Python’s f-string feature to be completed by the second parameter that the function receives.</p><pre>def execute(payload, service_endpoint):<br>  &quot;&quot;&quot;<br>  Call arcsight API for data from Operation Services<br>  &quot;&quot;&quot;<br>  <strong>headers</strong> = {<br>    &#39;accept&#39;: &#39;application/<strong>json</strong>&#39;<br>  }<br><br>  <strong>endpoint</strong> = (<br>    SERVER + f&#39;/www/<strong>manager-service</strong>/rest/<strong>{service_endpoint}</strong>&#39;<br>  )</pre><p>Using requests, a POST was set up with the defined endpoint and headers, together with the payload that is passed by the function’s first parameter. Finally, the Response object of the API response was returned.</p><pre>  try:<br>    resp = requests.<strong>post</strong>(<br>      <strong>endpoint</strong>,<br>      json=<strong>payload</strong>,<br>      headers=<strong>headers</strong>,<br>      verify=False<br>    )<br>  except Exception as e:<br>    print(f&#39;API Query error: {e}&#39;)</pre><pre>  <strong>return</strong> resp</pre><p>Thus, it is possible to perform searches with the login function using the following format:</p><pre>api_arcsight.execute(<br>  <strong>payload</strong>={<br>    &quot;resource.function&quot;: {<br>      &quot;resource.first_parameter&quot;: PARAMETER_VALUE_1,<br>      &quot;resource.second_parameter&quot;: PARAMETER_VALUE_2<br>    }<br>  },<br><strong>  service_endpoint</strong>=&#39;Resource/resourceFunction&#39;<br>)</pre><h4>Logout function</h4><p>In this file, a last “logout” function was created, which receives the token to be “logged out” of the system.</p><p>For this, was needed to use the core-services endpoint, the header for the JSON format, and the logout payload.</p><pre>def logout(authtoken): <br>  &quot;&quot;&quot;<br>  Revoke the token&#39;s API access<br>  &quot;&quot;&quot;</pre><pre>  <strong>login_endpoint</strong> = (<br>    SERVER + &#39;/www/<strong>core-service</strong>/rest/<strong>LoginService</strong>/<strong>logout</strong>&#39;<br>  )  </pre><pre>  <strong>headers</strong> = {<br>    &#39;accept&#39;: &#39;application/<strong>json</strong>&#39;,<br>    &#39;content-type&#39;: &#39;application/<strong>json</strong>&#39;<br>  }  </pre><pre>  <strong>payload</strong> = {<br>    &#39;log.logout&#39;: {<br>       &#39;log.authToken&#39;: authtoken<br>    }<br>  }</pre><p>Finally, another POST was executed with requests with the defined data:</p><pre>  try:<br>    requests.<strong>post</strong>(<br>      <strong>login_endpoint</strong>,<br>      json=<strong>payload</strong>,<br>      headers=<strong>headers</strong>,<br>      verify=False<br>    )<br>  except Exception as e:<br>    print(f&#39;Logout error: {e}&#39;)</pre><pre>  return True</pre><p>Thus, it is possible to execute the login function using the line:</p><pre>api_arcsight.logout(AUTHENTICATION_TOKEN)</pre><p>With that local library ready, you can go back to the main script and add the missing logic.</p><h4>Importing the support library</h4><p>At the top of the “tor.py” file, it is already possible to import the previously created module from “api_arcsight.py”:</p><pre>import requests<br>import <strong>api_arcsight</strong></pre><p>Now, using the login function, the token was retrieved to execute the queries, and the Active List Resource ID was defined for manipulation.</p><pre>AUTHENTICATION_TOKEN = api_arcsight.<strong>login</strong>()<br>ACTIVE_LIST = &#39;<strong>Ha9ZKBHUBABCAGTV5ykX2XQ==&#39;</strong></pre><h4>Clearing the Active List</h4><p>Needing to keep the Active List up to date, it was decided to clear the list completely and then import all the new records. To do it first the Active List was cleaned with the <em>execute</em> function passing the correct endpoint and payload:</p><pre>api_arcsight.execute(<br>  <strong>payload</strong>={<br>    &#39;act.<strong>clearEntries</strong>&#39;: {<br>      &#39;act.authToken&#39;: AUTHENTICATION_TOKEN,<br>      &#39;act.resourceId&#39;: ACTIVE_LIST<br>    }<br>  },<br>  <strong>service_endpoint</strong>=&#39;ActiveListService/clearEntries&#39;<br>)</pre><h4>Taking the data into the Active List</h4><p>Since the Active List is empty, it is possible to insert the new data collected using the execute function again.</p><p>For this, the payload of the chosen <em>addEntries</em> operation expects two parameters: one with a list of columns (<em>columns</em>) and an <em>entryList</em> which is the list of IP entries, each formatted with a JSON object called <em>{‘entry’: []}</em>, that has the data list in column order.</p><p>In this case, the Active List has only one “ip” column, making it easier to just use a Python list-comprehension to feed this entry:</p><pre>api_arcsight.execute(<br>  <strong>payload</strong>={<br>    &#39;act.<strong>addEntries</strong>&#39;: {<br>      &#39;act.authToken&#39;: AUTHENTICATION_TOKEN,<br>      &#39;act.resourceId&#39;: ACTIVE_LIST,<br>      &#39;act.<strong>entryList</strong>&#39;: {<br>        &#39;<strong>columns&#39;</strong>: <strong>[&#39;ip&#39;]</strong>,<br>        &#39;<strong>entryList&#39;</strong>: <strong>[ {&#39;entry&#39;: [reg]} for reg in registros ]</strong><br>      }<br>    }<br>  },<br>  <strong>endpoint_servico</strong>=&#39;ActiveListService/addEntries&#39;<br>)</pre><h4>Logout</h4><p>The “logout” function was used in order not to overload the database with orphan sessions:</p><pre>api_arcsight.logout(AUTHENTICATION_TOKEN)</pre><h4>Scheduling</h4><p>Finally, it is possible to schedule the script using crontab to search and update the information every hour:</p><pre>0 * * * * cd / path / script / script_tor; / usr / bin / python3 /path/script/script_tor/load_tor.py</pre><blockquote>Other options would be <em>systemd</em> timers from <em>systemd</em> or <a href="https://github.com/isaqueprofeta/pylineup"><em>isaqueprofeta/pylineup</em></a> project that uses Python + Celery to manage python script scheduled tasks</blockquote><p>Into the ArcSight ESM console, after running the script, it’s possible to see the results in the Active List:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/813/0*0eld80Dm8jUWIndB.png" /><figcaption>ActiveList loaded via API with Tor network exit nodes</figcaption></figure><h3>Integration of the Active List with a Rule to classify events</h3><h4>Creation of Rule</h4><p>With the Active List loaded, a <em>Pre-persistence Rule</em> was created, which is a rule to mark events with extra information based on conditions to filter them later for analysis:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/826/0*GZZWHb25QWQmhVlp.png" /></figure><p>In the <em>Conditions</em> an <em>AND rule</em> was added with an <em>InActiveList</em> condition comparing the <em>Attacker Address</em> field (source IP) of the event with the “<em>ip”</em> <em>column</em> of the Active List.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/821/0*-OtGwkSgwwALSSPY.png" /><figcaption>Rule condition creation</figcaption></figure><p>After that correlation condition, an <em>Action</em> was created in the Rule so that every event that passes the condition receives 3 <em>Event Fields</em>: a Name and two more Categories, the latter being one for the behavior (/Access) and one for the technique (/Access/Anonymized):</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/824/0*RsOJplM_0YFC2QEW.png" /><figcaption>Addition of event classification action</figcaption></figure><h4>Visualization of data in an Active Channel</h4><p>Finally, an Active Channel (which is a visualization channel within ArcSight ESM) was created with a <em>filter</em> for one of the label information that was inserted in <em>Rule’s Action</em>. With this, it is possible to view the events and confirm that they are marked:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/889/0*gG4a_hx_2XomXFMg.png" /><figcaption>Viewing events marked as Anonymous access</figcaption></figure><h3>Conclusion</h3><p>This Use Case allows, for example, to analyze the types of traffic that applications receive anonymously, allowing important data to incident handling and prevention. This was made possible through the integration with Python and the requests library to search the information of the exit nodes of the Tor network, in a Linux environment, and adding them in Active Lists via ArcSight ESM API for correlation.</p><p>In situations where the accesses do not show malicious activity, not triggering other correlations in your SIEM, it can be concluded that the source only wants to access that content anonymously, the legitimate scenario.</p><p>In situations where applications receive malicious activity through Tor source, it is necessary to consider blocking or redirecting access to challenge solutions, such as CAPTCHA.</p><p>Another example in these situations of anonymous traffic are forum abuse activities: with this traffic information in hand, it is possible to block the inclusion of comments with anonymous sources, to avoid offensive messages and SPAM behavior.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=92750617227a" width="1" height="1" alt=""><hr><p><a href="https://medium.com/analytics-vidhya/correlating-tor-sources-in-arcsight-siem-events-using-python-92750617227a">Correlating Tor sources in ArcSight SIEM events using Python</a> was originally published in <a href="https://medium.com/analytics-vidhya">Analytics Vidhya</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Correlacionando origens Tor em eventos do ArcSight usando Python]]></title>
            <link>https://isaqueprofeta.medium.com/correlacionando-origens-tor-em-eventos-do-siem-arcsight-usando-pyhton-3a91eeb3acfc?source=rss-c04e79af8ce1------2</link>
            <guid isPermaLink="false">https://medium.com/p/3a91eeb3acfc</guid>
            <category><![CDATA[network-security]]></category>
            <category><![CDATA[security]]></category>
            <category><![CDATA[python-programming]]></category>
            <category><![CDATA[networking]]></category>
            <category><![CDATA[technology]]></category>
            <dc:creator><![CDATA[Isaque Profeta]]></dc:creator>
            <pubDate>Tue, 13 Oct 2020 12:21:51 GMT</pubDate>
            <atom:updated>2020-12-15T23:39:29.032Z</atom:updated>
            <content:encoded><![CDATA[<h3>Correlacionando origens Tor em eventos do SIEM ArcSight usando Python</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/720/1*zJLsoTwJ2xDwaRE_0Ik2rg.png" /></figure><blockquote>English version <a href="https://isaqueprofeta.medium.com/correlating-tor-sources-in-arcsight-siem-events-using-python-92750617227a">here</a>.</blockquote><h3><strong>Introdução</strong></h3><p>A anonimização, apesar de ser atualmente um recurso importante na internet, acaba sendo abusada como ferramenta para vetor de muitas explorações e ataques de segurança. Assim, integrar as informações de uso da rede Tor (atualmente a principal/maior rede de anonimização) para classificar eventos de acesso a um ambiente de <em>Hosting/Serviços Web</em> em um <em>SIEM,</em> para avaliação da motivação desses acessos, é uma tática muito importante.</p><p>Esse artigo apresenta um Caso de Uso usando Python e a biblioteca <em>requests, </em>usando um ambiente Linux,<em> </em>para integração da API do SIEM ArcSight ESM com <em>Active Lists</em> para classificar eventos oriundos da rede Tor.</p><h3>Revisão de conceitos</h3><h4>SIEM</h4><p>Um <em>log </em>é um registro de evento de sistema computacional. Abaixo, por exemplo, há três <em>logs</em> do sistema de instalação de pacotes do Ubuntu Linux:</p><pre>$ tail -3 /var/log/dpkg.log <br>2020-10-04 17:24:52 status unpacked gcc:amd64 4:7.4.0-1ubuntu2.3<br>2020-10-10 13:25:09 startup archives unpack<br>2020–10–10 13:25:13 status installed mime-support:all 3.60ubuntu1</pre><p>Uma ferramenta de <em>Syslog</em> é um software que agrega as informações de <em>logs</em> oriundos de diversos hardwares e/ou softwares dentro de um ambiente. No exemplo abaixo, o <em>Linux Syslogd </em>agrega <em>logs</em> das aplicações <em>CRON</em>, <em>systemd</em> e <em>anacron</em> de um sistema operacional Ubuntu Linux:</p><pre>$ tail -5 /var/log/syslog.1<br>Oct 10 23:59:01 ubuntu-desktop <strong>CRON</strong>[3344]: (root) CMD (command -v debian-sa1 &gt; /dev/null &amp;&amp; debian-sa1 60 2)<br>Oct 11 00:02:46 ubuntu-desktop <strong>systemd</strong>[1]: Started Run anacron jobs.<br>Oct 11 00:02:46 ubuntu-desktop <strong>anacron</strong>[3430]: Anacron 2.3 started on 2020-10-11<br>Oct 11 00:02:46 ubuntu-desktop <strong>anacron</strong>[3430]: Will run job `cron.daily&#39; in 5 min.<br>Oct 11 00:02:46 ubuntu-desktop <strong>anacron</strong>[3430]: Jobs will be executed sequentially</pre><p>Ambientes de provedores e hospedagem de infraestrutura de TI possuem <em>logs</em> oriundos de vários equipamentos de toda a infraestrutura computacional, desde <em>Roteadores </em>e<em> Switches, </em>passando por<em> Firewalls, IPS’s/IDS’s, </em>até chegar a <em>Servidores de Aplicação e Bancos de Dados</em>. Um <em>Servidor Syslog</em> une essas informações em uma base central de todas as ocorrências de eventos desse parque.</p><p>As ferramentas de Gerenciamento de eventos e segurança da informação (Security Information and Event Management ou SIEM) atuam semelhante ao <em>Servidor Syslog,</em> mas com especialização em segurança. Isso significa que as <em>logs </em>passam por uma inteligência de classificação, gerando alertas de segurança de acordo com padrões definidos, tendo também uma interface de pesquisa e geração de relatórios. É possível ainda acionar comandos externos automatizando ações de bloqueio em equipamentos de <em>Firewall</em> e/ou <em>IPS,</em> que suportem integrações externas.</p><blockquote>Exemplo de alerta: O SIEM pode ter uma regra que identifica uma série de <em>logs</em> de erro 404 em um <em>Servidor Web</em> em um curto espaço de tempo para diversos diretórios de aplicação inexistentes, gerando um alerta de tentativa de <em>Scan de aplicação </em>(usando uma ferramenta como o <a href="https://tools.kali.org/web-applications/dirb"><em>dirb</em></a> por exemplo).</blockquote><p>Neste artigo será usado o <a href="https://www.microfocus.com/pt-br/products/siem-security-information-event-management/overview">Micro Focus ArcSight ESM</a> como ferramenta de SIEM.</p><h4>Tor</h4><p>O ambiente do Tor funciona de modo que os usuários da rede possam usar ou atuar como caminhos aleatórios e encriptados de passagem entre todos os participantes da rede. Dessa forma, do ponto de vista do destino de uma conexão de rede, a máquina de origem não é a máquina que está acessando esse destino.</p><p>Usando o <a href="https://2019.www.torproject.org/about/overview.html.en">exemplo oficial</a> abaixo, o computador de Alice usa um caminho aleatório entre os “nós“ (<em>nodes</em>) da rede para então chegar em um “nó de saída” (<em>exit node</em>) e acessar o servidor de destino Bob, assim anonimizando o acesso - pois Bob não conhece Alice, ele vê apenas a solicitação do <em>exit node</em>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/508/1*J-4zki0_j57KG3GoOEH84g.png" /><figcaption>Imagem da documentação oficial: <a href="https://2019.www.torproject.org/about/overview.html.en">https://2019.www.torproject.org/about/overview.html.en</a></figcaption></figure><p>O interessante para esse artigo é que o Tor disponibiliza a lista dos seus <em>exit nodes</em>, ou seja, a lista com todos os nós de saída para acesso aos destinos de conexão. Essa lista, frequentemente atualizada e <a href="https://check.torproject.org/torbulkexitlist">disponibilizada no site do próprio Tor</a>, será a fonte de dados utilizada neste trabalho para classificar o tráfego como oriundo da rede Tor.</p><blockquote>Abaixo, para referência, há outras duas listas com mais informações sobre nodes de redes Tor que não foram usadas no escopo desse artigo:</blockquote><blockquote>- <a href="https://www.dan.me.uk/torlist/?exit"><em>Exit nodes</em> atualizados a cada 30 minutos</a></blockquote><blockquote>- <a href="https://www.dan.me.uk/torlist">Todos os <em>nodes</em> (<em>Entry/Guard</em>, <em>Middle</em> e <em>Exit</em>), classificados e atualizados a cada 30 minutos</a></blockquote><h3>Lógica para implementação do caso deste artigo</h3><p>Visando evitar gerenciar muitos <em>connectors</em> do ArcSight, interagiu-se diretamente com a Interface de Programação da Aplicação (Application Programming Interface, API) da ferramenta, sendo os passos:</p><ul><li>Buscar a lista de IP’s dos <em>exit nodes</em> do Tor usando Python com a biblioteca <em>requests</em>;</li><li>Importar esses IP’s dentro de uma <em>Active List</em> do ArcSight mantendo ela atualizada (uma carga agendada);</li><li>Criar uma <em>Rule</em> no ArcSight para marcar os eventos que tenham IP’s de origem que estejam nessa <em>Active List</em>.</li></ul><h3>Pré-requisitos</h3><h4>Python + PIP</h4><p>Neste Caso de Uso, usou-se a linguagem Python em sua versão 3 (Linguagem) e o instalador de bibliotecas da linguagem Pip para essa versão 3.</p><pre>sudo apt update &amp;&amp; sudo apt install python3 python3-pip</pre><p>Confirma-se então que o Python do sistema operacional está na versão 3, realizando o teste no terminal:</p><pre>~$ python -V<br>Python 3.6.9</pre><pre>~$ pip -V<br>pip 20.1.1 from /home/isaque/.local/lib/python3.6/site-packages/pip (python 3.6)</pre><h4>Requests</h4><p>O acesso aos dados do repositório de <em>exit nodes,</em> bem como a integração com a API do ArcSight, foi realizado com o uso da biblioteca <em>requests</em> do Python. A instalação da mesma pode ser feita com o auxilio do Pip.</p><pre>pip install requests</pre><h4>Active List</h4><p>Uma <em>Active List </em>dentro do Arcsight ESM é uma lista de dados, da mesma forma que uma tabela de banco de dados ou planilha do Excel. Essa lista de dados é usada para guardar valores a serem comparados com outros recursos do SIEM. Neste artigo ela irá guardar os IP’s dos <em>exit nodes</em>.</p><p>Dentro da console do Arcsight ESM, criou-se a <em>Active List</em> com apenas uma coluna <em>Fields-based</em> chamada “ip<em>”</em> do tipo <em>Ip Address</em>, com expiração de uma hora e capacidade para dez mil resultados. Deve-se tomar o cuidado de <strong>anotar o <em>Resource ID</em> da <em>Active List</em></strong> necessário ao script.</p><blockquote>NOTA: Também foi criado um <em>usuário específico</em> para essa automação, configurado para ter privilégios de escrita nesta <em>Active List</em>.</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/960/1*D67khSmA-c_oeJ75jPUJhA.png" /><figcaption>Criação da ActiveList no ArcSight ESM 7.2</figcaption></figure><h3>Buscar a lista de IP’s dos exit nodes do Tor</h3><h4>Buscando a lista de redes</h4><p>Primeiramente criou-se uma pasta chamada “script_tor”, para guardar o projeto e, dentro dela, foi criado o arquivo “carga_tor.py”.</p><pre>mkdir ./script_tor<br>touch ./script_tor/carga_tor.py</pre><p>Iniciando o código do “carga_tor.py” propriamente dito, primeiro importou-se a biblioteca <em>requests</em> e, em seguida, executou-se um <em>GET</em> para buscar a base de informações dos <em>exit nodes. </em>Posteriormente, é possível visualizar<em> </em>o resultado com a função “<em>print()”</em>:</p><pre><strong>import</strong> requests<br>redestor = requests.<strong>get</strong>(<br>    &#39;<a href="https://check.torproject.org/torbulkexitlist&#39;">https://check.torproject.org/torbulkexitlist&#39;</a><br>)<br><strong>print</strong>(redestor.text)</pre><blockquote>O resultado da lista de ip’s está no corpo da resposta em formato texto. Por isso é necessário usar o “<em>redestor.text”</em> porque o resultado do “<em>requests.get()”</em> é um objeto do tipo <em>Response </em>que tem<em> </em>esse atributo <em>Response.text</em>.</blockquote><p>Com esse conteúdo já é possível testar o resultado no terminal:</p><pre><a href="https://check.torproject.org/torbulkexitlist&#39;">p</a>ython3 ./carga_tor.py</pre><figure><img alt="Primeiro teste de get dos dados no VSCode" src="https://cdn-images-1.medium.com/max/829/1*2fJfCh6lfvaEQ6_G8VHzCQ.png" /><figcaption>Primeiro teste de GET dos dados no VSCode</figcaption></figure><p>Para a carga final, trocou-se o “<em>print()”</em> por uma variável de lista do Python, com o cuidado de separar a lista na quebra de linha “<em>\n</em>”, usando para isso, a função de string “<em>split()</em>”:</p><pre>import requests<br>redestor = requests.get(<br>    &#39;<a href="https://check.torproject.org/torbulkexitlist&#39;">https://check.torproject.org/torbulkexitlist&#39;</a><br>)<br><strong>registros</strong> = redestor.text.<strong>split</strong>(&#39;\n&#39;)</pre><p>Com a coleta dos dados pronta, é hora de estudar o lado do ArcSight.</p><h3>Importar os IP’s dentro de uma Active List do ArcSight</h3><h4>Interagindo com a API do ArcSight</h4><p>Agora, a parte mais complexa, pois não foi possível encontrar muitos exemplos ou clareza na documentação relativa à API do ArcSight (versão 7.2 do ArcSight ESM). Aparentemente há preferência pelo modelo <em>Java</em> com <em>XML</em>/<em>SOAP,</em> o que dificulta o entendimento para o uso dos métodos e atributos em outras linguagens com <em>JSON/REST</em>.</p><p>Após estudo e pesquisa, chegou-se aos seguintes resultados oficiais considerados úteis:</p><ul><li><a href="https://h41382.www4.hpe.com/gfs-shared/downloads-273.pdf">PDF de uma apresentação</a> de automação;</li><li><a href="https://www.microfocus.com/documentation/arcsight/arcsight-esm-7.3/pdfdoc/ESM_ServiceLayer_DevGuide/ESM_ServiceLayer_DevGuide.pdf">ESM Service Layer</a> (Web Services) Developer’s Guide;</li><li>Discussões nos fóruns oficiais (referências: <a href="https://community.microfocus.com/t5/Archive-Discussion-Board/Full-REST-API-Documentation-For-ESM/td-p/1538807">1</a>, <a href="https://community.microfocus.com/t5/ArcSight-User-Discussions/Understanding-ESM-API-documentation/td-p/1657890">2</a>, <a href="https://community.microfocus.com/t5/ArcSight-User-Discussions/Execute-Query-via-ESM-REST-API/td-p/1791726">3</a> e <a href="https://community.microfocus.com/t5/ArcSight-User-Discussions/ArcSight-ESM-API-for-Getting-the-Query-Viewer-Data/td-p/1687030">4</a>) da Micro Focus.</li></ul><p>Mesmo assim, as documentações oficiais deixam muitas dúvidas, e as respostas de fórum ainda são vagas. Fazendo engenharia reversa em alguns projetos já existentes no GitHub chegou-se na seguinte solução para usar a API com <em>JSON/REST</em>:</p><p><strong>1</strong>: Identificar no <em>listServices</em> da instalação do ArcSight ESM quais os recursos de API precisam ser usados (o <em>Service </em>e o <em>Operation</em>). Esse <em>listServices</em> fica na URL abaixo (exceto para operações administrativas e de login, pois nessas situações o <em>manager-services na URL </em>é trocado pelo <em>core-services</em>).</p><blockquote>https://url-arcsight-esm:8443/www/manager-service/services/listServices</blockquote><p><strong>2</strong>: Acessar nessa página o <em>WSDL</em> (<em>XML Desciptor</em>) do <em>Service</em>, dentro do link que tem o texto: “<em>See Web Services Description Language (WSDL) here</em>”</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/967/1*8HwCBQlRVZYEztha-Xa1AQ.png" /><figcaption>listServices da instalação do ESM</figcaption></figure><p><strong>3</strong>: Pesquisar dentro do <em>XML Desciptor</em> a <em>Operation</em> escolhida e identificar os parâmetros de pesquisa</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/869/1*5o8GMCBauRdVLZSLPAzY7A.png" /><figcaption>Element com os Sequences que são os parâmetros de pesquisa</figcaption></figure><blockquote>Para o <em>JSON</em>, uma das coisas não encontradas nas documentações foi a descrição das abreviações dos recursos, necessária para o formato das chamadas. Assim, encontrou-se uma lista funcional na descrição do projeto <a href="https://github.com/dawid-czarnecki/pyasesm/">pyaesm</a> (que também faz interação com <em>Active Lists</em>) constante em referência no quarto passo.</blockquote><p><strong>4</strong>: Selecionar a classe abreviada de <em>Service </em>conforme a lista abaixo:</p><pre>&quot;act&quot; = &quot;resource.manager/activeListService/&quot;<br>&quot;arc&quot; = &quot;resource.manager/archiveReportService/&quot;<br>&quot;cas&quot; = &quot;resource.manager/caseService/&quot;<br>&quot;cap&quot; = &quot;resource.manager/conAppService/&quot;<br>&quot;con&quot; = &quot;resource.manager/connectorService/&quot;<br>&quot;das&quot; = &quot;resource.manager/dashboardService/&quot;<br>&quot;dmq&quot; = &quot;resource.manager/dataMonitorQoSService/&quot;<br>&quot;dat&quot; = &quot;resource.manager/dataMonitorService/&quot;<br>&quot;drl&quot; = &quot;resource.manager/drilldownListService/&quot;<br>&quot;dri&quot; = &quot;resource.manager/drilldownService/&quot;<br>&quot;fie&quot; = &quot;resource.manager/fieldSetService/&quot;<br>&quot;fil&quot; = &quot;resource.manager/fileResourceService/&quot;<br>&quot;gra&quot; = &quot;resource.manager/graphService/&quot;<br>&quot;gro&quot; = &quot;resource.manager/groupService/&quot;<br>&quot;int&quot; = &quot;resource.manager/internalService/&quot;<br>&quot;man&quot; = &quot;resource.manager/managerAuthenticationService/&quot;<br>&quot;net&quot; = &quot;resource.manager/networkService/&quot;<br>&quot;por&quot; = &quot;resource.manager/portletService/&quot;<br>&quot;que&quot; = &quot;resource.manager/queryService/&quot;<br>&quot;qvs&quot; = &quot;resource.manager/queryViewerService/&quot;<br>&quot;rep&quot; = &quot;resource.manager/reportService/&quot;<br>&quot;res&quot; = &quot;resource.manager/resourceService/&quot;<br>&quot;sei&quot; = &quot;resource.manager/securityEventIntrospectorService/&quot;<br>&quot;sev&quot; = &quot;resource.manager/securityEventService/&quot;<br>&quot;ser&quot; = &quot;resource.manager/serverConfigurationService/&quot;<br>&quot;use&quot; = &quot;resource.manager/userResourceService/&quot;<br>&quot;vie&quot; = &quot;resource.manager/viewerConfigurationService/&quot;<br>&quot;inf&quot; = &quot;manager/infoService/&quot;<br>&quot;mss&quot; = &quot;manager/managerSearchService/&quot;</pre><p><strong>5</strong>: Definir a URL do <em>endpoint</em> de consumo da API com a estrutura abaixo, trocando o <em>Service</em> e o <em>Operation</em> pelos escolhidos acima:</p><blockquote>https://url-arcsight-esm:8443/www/manager-service/rest/’Service’/’Operation’</blockquote><p>EXEMPLO:</p><blockquote>Limpar a ActiveLists via API:</blockquote><blockquote>1: Procurou-se no <em>listServices</em> e encontrou-se o <em>Service</em> “<em>ActiveListService</em>” e, estudando as <em>Operations</em> do mesmo, optou-se por testar o “<em>clearEntries</em>”;</blockquote><blockquote>2: Acessou-se o link do WSDL para verificar os atributos necessários;</blockquote><blockquote>3: Encontrou-se no <em>XML Descriptor</em> os atributos necessários para a <em>Operation</em> de “<em>clearEntries</em>”, que são o “<em>authToken</em>” e o “<em>resourceId</em>”;</blockquote><blockquote>4: Identificou-se na tabela de referência que o “ActiveListService” é “act”;</blockquote><blockquote>JSON final para a chamada:</blockquote><pre>{<br>  &quot;<strong>act</strong>.<strong>clearEntries</strong>&quot;: {<br>    &quot;act.<strong>authToken</strong>&quot;: TOKEN_DE_AUTENTICACAO,<br>    &quot;act.<strong>resourceId</strong>&quot;: RESOURCE_ID_DA_ACTIVE_LIST<br>  }<br>}</pre><blockquote>5: O endpoint de consumo é: <a href="https://url-arcsight-esm:8443/www/manager-service/rest/ActiveListService/clearEntries">https://url-arcsight-esm:8443/www/manager-service/rest/<strong><em>ActiveListService</em></strong>/<strong><em>clearEntries</em></strong></a></blockquote><p>É importante saber essa estrutura para facilitar a navegação e entender quais são as chamadas e parâmetros possíveis para usar os mesmos.</p><h4>Organização do código de apoio ao script</h4><p>Primeiro é necessário criar uma função no Python com a <em>requests</em> para realizar o login e ter um <em>token</em>, para então realizar as interações com os métodos da API usando o mesmo.</p><p>Optou-se por separar essa função em outro arquivo (uma biblioteca local) para evitar repetição de código. E, para não deixar credenciais dentro de arquivos de código, montou-se um arquivo de configuração na mesma pasta do script.</p><pre>touch __init__.py<br>touch config.ini<br>touch api_arcsight.py</pre><p>O arquivo “__init__.py” permanece vazio facilitando o processo de <em>import</em> no projeto. Já o “config.ini” guarda as credenciais que serão usadas para acessar o ArcSight com o módulo Python <em>configparser,</em> sendo esse arquivo escrito no seguinte formato:</p><pre><strong>[arcsight]<br>user</strong>=usuario_arcsight<br><strong>password</strong>=senha_arcsight<br><strong>server</strong>=https://url-do-arcsight-esm:8443</pre><p>Esse arquivo tem as credenciais de um usuário específico para a automação, credenciais essas que nunca devem ser guardadas em ferramentas de controle de versão, no máximo um exemplo de modelo, denominado por exemplo de “config.ini.example”.</p><p>Agora, no arquivo “api_arcsight.py” monta-se o acesso às credenciais, criando o objeto do <em>configparser </em>e usando os métodos<em> “read()” e “get()”, </em>que lerão os dados do “config.ini”:</p><pre>import requests<br>import configparser</pre><pre>config = <strong>configparser.ConfigParser</strong>()<br>config.<strong>read</strong>(&quot;config.ini&quot;)</pre><pre>USER = config.<strong>get</strong>(&#39;arcsight&#39;, &#39;user&#39;)<br>PASSWORD = config.<strong>get</strong>(&#39;arcsight&#39;, &#39;password&#39;)<br>SERVER = config.<strong>get</strong>(&#39;arcsight&#39;, &#39;server&#39;)</pre><h4>Função de Login</h4><p>No mesmo arquivo montou-se a função de “logar”. Nesse caso, primeiro definiu-se o <em>endpoint</em> de login no <em>core-services</em> do ArcSight, customizou-se um <em>header HTTP </em>específico do formato de <em>JSON</em> e, por fim, definiu-se um <em>payload</em> com usuário e senha no formato esperado pelo <em>endpoint</em> de login da API.</p><pre>def <strong>logar</strong>():<br>  &quot;&quot;&quot;<br>  Conecta ao arcsight e retorna um token de API<br>  &quot;&quot;&quot;<br>  <strong>endpoint_login</strong> = (<br>    SERVER + &#39;/www/<strong>core-service</strong>/rest/<strong>LoginService</strong>/<strong>login</strong>&#39;<br>  )</pre><pre>  <strong>headers</strong> = {<br>    &#39;accept&#39;: &#39;application/<strong>json</strong>&#39;,<br>    &#39;content-type&#39;: &#39;application/<strong>json</strong>&#39;<br>  }</pre><pre>  <strong>payload</strong> = {<br>    &quot;log.login&quot;: {<br>      &quot;log.<strong>login</strong>&quot;: USER,<br>      &quot;log.<strong>password</strong>&quot;: PASSWORD<br>    }<br>  }</pre><p>Após esse preparo, realizou-se um <em>POST</em> com a <em>requests</em> para o <em>endpoint</em> definido do <em>core-services</em> passando o <em>payload</em> e os <em>headers</em>. Depois extraiu-se o <em>token</em> que está no caminho do dicionário “<em>Response.json()”</em> e retornou-se o mesmo no termino da função:</p><pre>  try:<br>    resp = requests.<strong>post</strong>(<br>      <strong>endpoint_login</strong>,<br>      json=<strong>payload</strong>,<br>      headers=<strong>headers</strong>,<br>      verify=False<br>    )<br>    token = resp.json()[&#39;log.loginResponse&#39;][&#39;log.return&#39;]<br>  except Exception as e:<br>    print(&quot;Erro de login: {}&quot;.format(e))</pre><pre>  return token</pre><blockquote>A opção do “<em>requests.post</em>” de “<em>verify=False</em>” é útil em instalações do ArcSight com certificados auto-assinados, funcionando como um “Aceitar risco e continuar” de browser acessando o mesmo site.</blockquote><p>Assim, é possível executar a função de login usando duas linhas:</p><pre><strong>import</strong> api_arcsight<br>TOKEN_AUTENTICACAO = <strong>api_arcsight.logar</strong>()</pre><h4>Função de Wrapper para executar pesquisas</h4><p>Em seguida montou-se uma função do tipo <em>wrapper</em> chamada “executar” para evitar repetição de código ao realizar consultas no ArcSight.</p><p>Para essa função, definiu-se o <em>header HTTP </em>especificando o formato <em>JSON</em>, o <em>endpoint,</em> que nesse caso é do <em>manage-service e uma f-string</em> completada pelo segundo parâmetro que a função receber.</p><pre>def executar(payload, endpoint_servico):<br>  <strong>headers</strong> = {<br>    &#39;accept&#39;: &#39;application/<strong>json</strong>&#39;<br>  }<br><br>  <strong>endpoint</strong> = (<br>    SERVER + f&#39;/www/<strong>manager-service</strong>/rest/<strong>{endpoint_servico}</strong>&#39;<br>  )</pre><p>Em seguida, realizou-se a execução do <em>POST</em> usando a <em>requests</em> com o <em>endpoint</em> e os <em>headers</em> definidos, junto com o <em>payload</em> que é passado pelo primeiro parâmetro da função. Por fim retornou-se o objeto <em>Response </em>da resposta da API.</p><pre>  try:<br>    resposta = requests.<strong>post</strong>(<br>      <strong>endpoint</strong>,<br>      json=<strong>payload</strong>,<br>      headers=<strong>headers</strong>,<br>      verify=False<br>    )<br>  except Exception as e:<br>    print(&quot;Erro de pesquisa: {}&quot;.format(e))</pre><pre><strong>  return</strong> resposta</pre><p>Assim, é possível executar pesquisas com a função de login usando o seguinte formato:</p><pre>api_arcsight.<strong>executar</strong>(<br>  <strong>payload</strong>={<br>    &quot;recurso.função&quot;: {<br>      &quot;recurso.parametro_um&quot;: VALOR_PARAMETRO_UM,<br>      &quot;recurso.parametro_dois&quot;: VALOR_PARAMETRO_DOIS<br>    }<br>  },<br>  <strong>endpoint_servico</strong>=&#39;Recurso/funcaoDoRecurso&#39;<br>)</pre><h4>Função de Logout</h4><p>Por fim, neste arquivo criou-se uma última função de “deslogar”, que recebe o <em>token</em> a ser “deslogado” do sistema.</p><p>Para isso, definiu-se o <em>endpoint</em> do <em>core-services</em>, o <em>header</em> para o formato <em>JSON </em>e o <em>payload</em> de logout.</p><pre>def deslogar(authtoken):<br>  <strong>endpoint_login</strong> = (<br>    SERVER + &#39;/www/<strong>core-service</strong>/rest/<strong>LoginService</strong>/<strong>logout</strong>&#39;<br>  )</pre><pre>  <strong>headers</strong> = {<br>    &#39;accept&#39;: &#39;application/<strong>json</strong>&#39;,<br>    &#39;content-type&#39;: &#39;application/<strong>json</strong>&#39;<br>  }</pre><pre>  <strong>payload</strong> = {<br>    &quot;log.logout&quot;: {<br>       &quot;log.authToken&quot;: authtoken<br>    }<br>  }</pre><p>Finalmente executou-se mais um <em>POST</em> com a <em>requests </em>com os dados definidos<em>:</em></p><pre>  try:<br>    requests.<strong>post</strong>(<br>      <strong>endpoint_login</strong>,<br>      json=<strong>payload</strong>,<br>      headers=<strong>headers</strong>,<br>      verify=False<br>    )<br>  except Exception as e:<br>    print(&quot;Erro de logout: {}&quot;.format(e))</pre><pre>  return True</pre><p>Assim, é possível executar a função de login usando a linha:</p><pre>api_arcsight.deslogar(TOKEN_AUTENTICACAO)</pre><p>Com essa biblioteca local pronta, é possível voltar para o script principal e adicionar a lógica que falta.</p><h4>Importando a biblioteca de apoio</h4><p>Dentro do arquivo “carga_tor.py”, no topo, já é possível importar o módulo criado anteriormente da api_arcsight:</p><pre>import requests<br>import <strong>api_arcsight</strong> # &lt;--- Adição da biblioteca local no inicío</pre><p>Agora, usando a função logar<em> </em>recuperou-se o <em>token</em> de login para executar as consultas, e definiu-se o <em>Resource ID</em> da <em>Active List </em>para manipulação.</p><pre>TOKEN_AUTENTICACAO = api_arcsight.<strong>logar</strong>()<br>ACTIVE_LIST = &quot;<strong>Ha9ZKBHUBABCAGTV5ykX2XQ==</strong>&quot;</pre><h4>Limpando a Active List</h4><p>Com a necessidade de manter a <em>Active List</em> atualizada, decidiu-se por limpar a lista completamente e depois importar todos os novos registros pesquisados. Então, primeiro fez-se uma limpeza da <em>Active List</em> com a função executar passando-se o <em>endpoint</em> e o <em>payload</em> corretos:</p><pre>api_arcsight.executar(<br>  <strong>payload</strong>={<br>    &quot;act.<strong>clearEntries</strong>&quot;: {<br>      &quot;act.authToken&quot;: TOKEN_AUTENTICACAO,<br>      &quot;act.resourceId&quot;: ACTIVE_LIST<br>    }<br>  },<br>  <strong>endpoint_servico</strong>=&#39;ActiveListService/clearEntries&#39;<br>)</pre><h4>Inserindo os dados na Active List</h4><p>Uma vez que a <em>Active List</em> está vazia, é possível inserir os novos dados coletados usando novamente a função executar.</p><p>Para isso, o <em>payload</em> da operação escolhida de <em>addEntries</em> espera dois parâmetros: um com uma lista das colunas (<em>columns</em>) e uma <em>entryList</em> que é a lista de entradas, cada uma formatada com um objeto <em>JSON</em> chamado de <em>{‘entry’: []}, </em>que tem a lista de dados na ordem das colunas.</p><p>Aqui, a <em>Active List</em> tem apenas uma coluna <em>ip</em>, sendo mais simples fazer uma <em>list-comprehension</em> do Python para alimentar essa entrada:</p><pre>api_arcsight.executar(<br>  <strong>payload</strong>={<br>    &quot;act.<strong>addEntries</strong>&quot;: {<br>      &quot;act.authToken&quot;: TOKEN_AUTENTICACAO,<br>      &quot;act.resourceId&quot;: ACTIVE_LIST,<br>      &quot;act.<strong>entryList</strong>&quot;: {<br>        &quot;<strong>columns</strong>&quot;: <strong>[&#39;ip&#39;]</strong>,<br>        &quot;<strong>entryList</strong>&quot;: <strong>[ {&#39;entry&#39;: [reg]} for reg in registros ]</strong><br>      }<br>    }<br>  },<br>  <strong>endpoint_servico</strong>=&#39;ActiveListService/addEntries&#39;<br>)</pre><h4>Logout</h4><p>Para fazer o logout utilizou-se a função “deslogar” para não sobrecarregar o banco de dados com sessões órfãs:</p><pre>api_arcsight.deslogar(TOKEN_AUTENTICACAO)</pre><h4>Agendamento</h4><p>Para finalizar, é possível agendar o script usando o <em>crontab</em> para buscar e atualizar as informações a cada hora:</p><blockquote>Outras opções seriam o <em>systemctl timers</em> do <em>systemd</em> ou o projeto <a href="https://github.com/isaqueprofeta/pylineup"><em>isaqueprofeta/pylineup</em></a> que usa Python + Celery</blockquote><pre>0 * * * * cd /caminho/script/script_tor; /usr/bin/python3 /caminho/script/script_tor/carga_tor.py</pre><p>Acessando a console do ArcSight ESM, após rodar a primeira carga, já é possível ver os resultados na <em>Active List</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/813/1*BMZJubpRG3ggenapOeCKrg.png" /><figcaption>ActiveList carregada via API com os “exit nodes” da rede Tor</figcaption></figure><h3>Integrando a Active List com uma Rule para classificar eventos</h3><h4>Criação da Rule</h4><p>Com a <em>Active List</em> carregada, criou-se uma <em>Rule</em> do tipo <em>Pre-persistence</em> que é uma regra para marcar os eventos com informações extras com base em condições para depois filtrar os mesmos para análise:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/826/1*AQ4POGBjSVJHjG9rYqrv6Q.png" /><figcaption>Criação básica da Rule</figcaption></figure><p>Nas <em>Conditions</em> adicionou-se uma regra de <em>AND</em> com uma condição de <em>InActiveList</em> comparando o campo <em>Attacker Address</em> (IP de origem) do evento com a coluna <em>ip</em> da <em>Active List</em>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/821/1*5FY3svv-CcEqJUm00DFepQ.png" /><figcaption>Criação da condição na Rule</figcaption></figure><p>Depois de criada a condição de correlação, criou-se uma <em>Action</em> na <em>Rule</em> para que todo evento que passe na condição receba 3 informações: um <em>Name</em> e mais duas <em>Categories</em>, sendo essas últimas uma para o comportamento (/Acesso) e uma para a técnica (/Acesso/Anonimizado):</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/824/1*BqdtYm9aXzOX5L3Yq-pTqw.png" /><figcaption>Adição da ação de classificação dos eventos</figcaption></figure><h4>Visualização dos dados em Active Channel</h4><p>Por último, criou-se um <em>Active Channel</em> (que é um canal de visualização dentro do ArcSight ESM) com filtro para uma uma das informações de etiqueta que tenha sido inseridas na <em>Action</em> da <em>Rule.</em> Dessa forma, é possível visualizar os eventos e confirmar que eles estão marcados:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/889/1*Wx32SI7G3xqR6D4TgwgDPA.png" /><figcaption>Visualização dos eventos marcados como acesso Anonimizado</figcaption></figure><h3>Conclusão</h3><p>Este Caso de Uso permite, por exemplo, analisar quais os tipos de tráfego que as aplicações recebem de forma anônima, permitindo uma tomada de decisão mais assertiva no tratamento de incidentes ou na sua prevenção. Isso foi possível através da integração com Python e a biblioteca <em>requests</em> para buscar as informações dos <em>exit nodes </em>da rede Tor, em ambiente Linux, inserindo-as em <em>Active Lists </em>via API do SIEM ArcSight ESM para correlação<em>.</em></p><p>Nos casos onde os acessos não indicam atividade maliciosa, não caindo em outras correlações em seu SIEM, pode-se concluir que a origem deseja apenas acessar aquele conteúdo de forma anônima, enquadrando-se no cenário legítimo.</p><p>E, caso as aplicações recebam atividades maliciosas por meio de origem Tor, é necessário considerar o bloqueio ou redirecionamento para soluções de desafio para acesso, como <em>CAPTCHA</em>.</p><p>Outro exemplo interessante nesses casos de tráfego anônimo são as atividades de abuso de fóruns: com essas informações de tráfego nas mãos é possível bloquear a inclusão de comentários com origens anônimas, para evitar mensagens ofensivas e comportamentos de SPAM.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=3a91eeb3acfc" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Iniciando rápido com a API do Zabbix usando Python 3]]></title>
            <link>https://medium.com/zabbix-brasil/iniciando-r%C3%A1pido-com-a-api-do-zabbix-usando-python-3-869b2b9f550f?source=rss-c04e79af8ce1------2</link>
            <guid isPermaLink="false">https://medium.com/p/869b2b9f550f</guid>
            <category><![CDATA[api]]></category>
            <category><![CDATA[infraestrutura]]></category>
            <category><![CDATA[zabbix]]></category>
            <category><![CDATA[monitoramento]]></category>
            <category><![CDATA[python]]></category>
            <dc:creator><![CDATA[Isaque Profeta]]></dc:creator>
            <pubDate>Sun, 09 Aug 2020 22:53:28 GMT</pubDate>
            <atom:updated>2020-10-06T01:52:06.441Z</atom:updated>
            <content:encoded><![CDATA[<p>Passo a passo com preparação de dependências em um Ubuntu 18.04, primeiros testes de acesso e dicas de uso.</p><h4>Pyhton + PIP</h4><p>Começando com o básico, instale o Python versão 3 (Linguagem) e o PIP para a versão 3 (Instalador de bibliotecas prontas da linguagem)</p><pre>sudo apt update &amp;&amp; sudo apt install python3 python3-pip</pre><p>Por via das dúvidas, confirme que o Python do seu sistema operacional é a versão 3 testando no terminal (senão você pode precisar usar “python3” ao invés de “python”):</p><pre>~$ python -V<br>Python 3.6.9</pre><pre>~$ pip -V<br>pip 20.1.1 from /home/isaque/.local/lib/python3.6/site-packages/pip (python 3.6)</pre><h4>pyZabbix</h4><p>A API do Zabbix tem alguns requisitos de autenticação e usa o formato JSON para organizar os dados recebidos/enviados pela API, para iniciar então instale a biblioteca pronta do lukecyca/pyzabbix (Cuidado para não confundir com outra biblioteca existente chamada py-zabbix)</p><pre>pip install pyzabbix</pre><h4><strong>Estrutura de projeto</strong></h4><p>Usando a pyzabbix vamos escrever nosso primeiro código. Crie uma pasta chamada apizabbix na sua home para guardar o projeto e crie 2 arquivos para configurações, um para guardar as credenciais de acesso e outro para transformar o diretório em um modulo do Python</p><pre>touch apizabbix.py<br>touch consulta.py<br>code .</pre><p>Agora falando dos código de consulta vamos precisar de mais 2 arquivos, sendo um para autenticação e criação de sessões, e outro para a primeira pesquisa:</p><pre>touch apizabbix.py<br>touch consulta_001.py<br>code .</pre><p>Em seguida abra a pasta no seu editor favorito (vou usar o Visual Studio Code neste tutorial):</p><pre>code .</pre><figure><img alt="VSCode com arquivos iniciais criados" src="https://cdn-images-1.medium.com/max/856/1*x27r75l2q4NsJ1qASmVRPA.png" /><figcaption>VSCode com arquivos iniciais criados</figcaption></figure><p>Primeiramente, o arquivo __init__.py fica vazio (ele apenas define nosso projeto como módulo do Pyhton para facilitar o processo de “import”), já dentro do arquivo config.ini adicione a URL completa de acesso ao frontend, junto ao usuário e senha de acesso ao Zabbix conforme abaixo, pois vamos evitar usar os dados de acesso diretamente no arquivo .py aproveitando um módulo chamado “configparser”:</p><pre>[zabbix]<br><em>server</em>=http://127.0.1.1:8080/zabbix<br><em>user</em>=Admin<br><em>password</em>=zabbix</pre><h4>Arquivo de criação de sessões para pesquisa</h4><p>Agora dentro do arquivo apizabbix.py vamos primeiro chamar a biblioteca do pyzabbix que instalamos, e logo depois o módulo de configuração do “configparser”:</p><pre><em>from</em> pyzabbix <em>import</em> ZabbixAPI<br><em>import</em> configparser</pre><p>Depois disso vamos preparar uma função que vai ser chamada por outros arquivos de script apenas para logar dentro do Zabbix e executar as consultas, e logo em seguida vamos preparar tudo para o “configparser” buscar os dados no arquivo config.ini:</p><pre><em>def</em> connect():<br>    config <em>=</em> configparser.ConfigParser()<br>    config.read(&quot;config.ini&quot;)<br>    <br>    user <em>=</em> config.get(&#39;zabbix&#39;, &#39;user&#39;)<br>    password <em>=</em> config.get(&#39;zabbix&#39;, &#39;password&#39;)<br>    server <em>=</em> config.get(&#39;zabbix&#39;, &#39;server&#39;)</pre><p>Ainda dentro dessa função vamos adicionar a criação do objeto de conexão e fazer o login na ferramenta (caso esteja usando HTTPS com certificado auto assinado, você pode ignorar os certificados removendo o comentário da segunda linha):</p><pre>    zapi <em>=</em> ZabbixAPI(server)<br>    # zapi.session.verify <em>=</em> False<br>    zapi.login(user, password)</pre><p>Vamos agora fechar a função usando um “return”:</p><pre>    return zapi</pre><p>E o arquivo final de chamada para o Zabbix vai ficar da seguinte forma:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/cabe94875600811bed1a13cc7aed9abd/href">https://medium.com/media/cabe94875600811bed1a13cc7aed9abd/href</a></iframe><h4>A primeira consulta</h4><p>Agora dentro do arquivo consulta_001.py onde criaremos o primeiro exemplo de consulta, vamos primeiro chamar a nossa função de acesso à API do Zabbix e iniciar uma nova conexão:</p><pre><em>import</em> apizabbix</pre><pre>api <em>=</em> apizabbix.connect()</pre><p>Pronto! A partir de agora basta mergulhar de cabeça na <a href="https://www.zabbix.com/documentation/current/manual/api/reference">documentação oficial</a> e começar as pesquisas a partir desse ponto.</p><p>Nesse primeiro exemplo vamos ver uma pesquisa simples de todos os “Grupos de Hosts”, que <a href="https://www.zabbix.com/documentation/current/manual/api/reference/hostgroup/get">pela documentação</a> é o hostgroup.get então na nossa biblioteca pyzabbix vai ser uma função/metodo do objeto <strong>api</strong>, ficando então no formato api.hostgroup.get() (com os parênteses no final).</p><p>Vamos agora adicionar então essa consulta ao nosso arquivo de consulta_001 e vamos imprimir em tela os resultados (note que eu usei o “pprint” para mostrar de forma mais organizada o resultado do JSON de resposta)</p><pre>hostgroups <em>=</em> api.hostgroup.get()<br>pprint(hostgroups)</pre><p>Logo depois de imprimir o resultado lembre sempre de fechar a sessão da API para não lotar sua tabela de sessões no Zabbix:</p><pre>api.user.logout()</pre><p>Arquivo completo para referência:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/47a56abf602b7e26474202ee3a874d36/href">https://medium.com/media/47a56abf602b7e26474202ee3a874d36/href</a></iframe><p>Execute o script acima entrando na pasta via terminal e use o comando (use o Crtl+Shift+` para chamar o terminal integrado se estiver usando o VSCode):</p><pre><em>python consulta_001.py</em></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*O4fnU7Zl8C3O1kC_h7YHtQ.png" /><figcaption>Buscando todos os grupos do zabbix via API</figcaption></figure><h4>Usando referências da documentação</h4><p>Usando a biblioteca pyzabbix e olhando a documentação da API se for necessário utlizar parâmetros de filtro e seleção, temos primeiro que “traduzir” do JSON para o Python. Então vamos criar um segundo exemplo copiando o nosso consulta_001.py:</p><pre>cp consulta_001.py consulta_002.py</pre><p>Nesse próximo exemplo vamos usar um filtro no hostgroup.get para remover da pesquisa os grupos que são de templates (Nesse caso a regra é todos os grupos em que o nome não começa com o grupo pai Templates), e para fazer isso precisamos de algumas opções especiais que muita gente não acha porque não encontra a <a href="https://www.zabbix.com/documentation/current/manual/api/reference_commentary">página de comentários e referência da API</a>.</p><p>Nesse caso vamos precisar da opção “excludeSearch” que <a href="https://www.zabbix.com/documentation/current/manual/api/reference_commentary">conforme a documentação</a> “retorna os resultados que não batem com os critérios do parâmetro ‘search’ ”, então vamos ver como ficaria o JSON editando um pouco o exemplo de “hostgroup.get” da <a href="https://www.zabbix.com/documentation/current/manual/api/reference/hostgroup/get#retrieving_data_by_name">documentação oficial</a> para o nosso exemplo:</p><pre>{<br>    &quot;jsonrpc&quot;: &quot;2.0&quot;,<br>    &quot;method&quot;: &quot;hostgroup.get&quot;,<br>    &quot;params&quot;: {<br>        &quot;output&quot;: &quot;extend&quot;,<br>        &quot;excludeSearch&quot;: true,<br>        &quot;search&quot;: {<br>            &quot;name&quot;: [<br>                &quot;Templates/&quot;<br>            ]<br>        }<br>    },<br>    &quot;auth&quot;: &quot;6f38cddc44cfbb6c1bd186f9a220b5a0&quot;,<br>    &quot;id&quot;: 1<br>}</pre><p>Como usamos a programação com a biblioteca pyzabbix, podemos ignorar tudo que não está dentro do “params” e estender as opções da nossa busca da seguinte forma (note as diferenças entre o JSON e os parâmetros de função do Python, cuidado ao “copiar e colar”):</p><pre>hostgroups <em>=</em> api.hostgroup.get(<br>    output<em>=</em>&#39;extend&#39;,<br>    excludeSearch<em>=</em>True,<br>    search<em>=</em>{<br>        &#39;name&#39;: &#39;Templates&#39;<br>    }<br>)</pre><p>Agora para finalizar vamos fazer um exercício de loop (laço de repetição) nessa lista e fazer também um acesso a uma propriedade específica em um dicionário, e então vamos imprimir apenas os nomes dos grupos, usando um “for” e o nosso logout da API:</p><pre><em>for</em> hostgroup <em>in</em> hostgroups:<br>    print(<br>        hostgroup[&#39;name&#39;]<br>    )</pre><pre>api.user.logout()</pre><blockquote><strong>Observação para quem chegou do Zabbix e não conhece Python</strong>: uma lista é um array, que são todos os resultados entre colchetes “[]” separados por virgula e um dicionário é cada resultado entre chaves “{}” cheio de campos no formato {“chave”; “valor”}, o loop do “for” vai percorrer a lista e o print vai imprimir apenas o valor da chave ‘name’ em cada um dos resultados da lista nesse caso .</blockquote><p>Arquivo completo para referência:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/d4139f6462e9334f24654180c6e61a77/href">https://medium.com/media/d4139f6462e9334f24654180c6e61a77/href</a></iframe><p>Execute o script acima entrando na pasta via terminal e use o comando (use o Crtl+Shift+` para chamar o terminal integrado se estiver usando o VSCode):</p><pre><em>python consulta_002.py</em></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/875/1*OS2IApC8l358tsjjkoZPZQ.png" /></figure><h4>Correlação entre dados da API usando select* e filtros de campos</h4><p>Nesse exemplo, você vai fazer a correlação de informações entre entidades no Zabbix quando o método da API possuir a opção de “select*” como por exemplo no “<a href="https://www.zabbix.com/documentation/current/manual/api/reference/hostgroup/get">hostgroup.get<em>”</em> na documentação</a>, e vai fazer também filtro dos campos pesquisados com o “output”:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/516/1*uGPElrUn27VfPzru_96j3Q.png" /><figcaption>Opções de select* dentro da API do hostgroup.get</figcaption></figure><p>Primeiro copie o consulta_001.py para o nosso terceiro exemplo:</p><pre>cp consulta_001.py consulta_003.py</pre><p>Adicione o “selectHosts” dentro do “hostgroup.get” para buscar os “hosts” dos grupos que estão sendo pesquisados:</p><pre>hostgroups <em>=</em> api.hostgroup.get(<br>    output<em>=</em>&#39;extend&#39;,<br>    excludeSearch<em>=</em>True,<br>    search<em>=</em>{<br>        &#39;name&#39;: &#39;Templates&#39;<br>    },<br>    selectHosts<em>=</em>&#39;extend&#39;<br>)</pre><p>Notou o “extend” acima? Essa opção trás todos os dados do host, o que pode ser desnecessário apenas gerando poluição de dados, confira isso rodando o comando no terminal.</p><pre><em>python consulta_003.py</em></pre><p>Para facilitar o trabalho, diminua o escopo com uma lista dos dados que você quer, como o exemplo abaixo, filtrando o “hostname<em>” </em>(no campo “host”) e o “display name”<em> </em>(no campo “name”):</p><pre>hostgroups <em>=</em> api.hostgroup.get(<br>    output<em>=</em>&#39;extend&#39;,<br>    excludeSearch<em>=</em>True,<br>    search<em>=</em>{<br>        &#39;name&#39;: &#39;Templates&#39;<br>    },<br>    selectHosts<em>=</em>[<br>        &#39;name&#39;,<br>        &#39;host&#39;<br>    ]<br>)</pre><p>Rode novamente o comando no terminal e veja o resultado:</p><pre><em>python consulta_003.py</em></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*L7fUjGtr2s2WyhUMgslU0Q.png" /><figcaption>Resultado do selecHosts com filtro de dados recuperados</figcaption></figure><p>Termine trocando o “pprint” pelo “print” com uso do “for”, e perceba que é necessário fazer um novo loop dentro de cada grupo, uma vez que veio como resultado uma lista de vários dicionários de informações sendo um para cada host :</p><pre><em>for</em> hostgroup <em>in</em> hostgroups:<br>    print(&#39;Grupo: &#39; <em>+</em> hostgroup[&#39;name&#39;])<br>    <br>    <em>for</em> host <em>in</em> hostgroup[&#39;hosts&#39;]:<br>        print(&#39;    Host: &#39; <em>+</em> host[&#39;name&#39;] <em>+</em> &#39;: &#39; <em>+</em> host[&#39;host&#39;])</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RMG2Gmd3gBzs52P55sW7tw.png" /></figure><p>Arquivo completo para referência:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/9396e4b7dd2f3328affca78d0c949974/href">https://medium.com/media/9396e4b7dd2f3328affca78d0c949974/href</a></iframe><h4>Correlação entre dados da API usando Python</h4><p>Em alguns casos não existe a opção de “select*” no método utilizado mas é necessário fazer uma integração entre ele e outra informação, nesse caso vamos buscar duas consultas em cascata e em seguida usar o Python para realizar a correlação entre elas.</p><p>Primeiro copie o consulta_001.py para o quarto exemplo:</p><pre>cp consulta_001.py consulta_004.py</pre><p>Vamos usar nesse exemplo duas chamadas na API para buscar os dados de todos os eventos de um grupo de hosts, então primeiro precisamos de dados sobre o grupo, para depois fazer o filtro dentro da opção “groupids” do método “event.get”<em>.</em></p><p>Primeiro adicione o “output” para ver apenas o “id” de cada grupo achado e vamos trocar o “search” pelo “filter” que vai trazer só o grupo que tiver o nome exato da busca.(O “search” retorna qualquer coisa “parecida” com o pesquisado lembrando com o LIKE no SQL. Mais detalhes sobre o “search” na referência de comentários da API que já citei anteriormente):</p><pre>hostgroups <em>=</em> api.hostgroup.get(<br>    output<em>=</em>[&#39;id&#39;],<br>    filter<em>=</em>{<br>        &#39;name&#39;: &#39;Linux servers&#39;<br>    }<br>)</pre><p>Para quem está chegando no Python agora, o resultado do “hostgroups” vai vir parecido com o abaixo (você pode testar fazendo um print do mesmo):</p><pre>[{&#39;groupid&#39;: &#39;2&#39;}]</pre><p>Então para acessar apenas o “id” 2, que vamos precisar na consulta abaixo, deve-se filtrar a primeira posição da lista com o “[0]” e em seguida o valor da chave ‘groupid’ dessa primeira posição com o “[‘groupid’]”, conforme abaixo:</p><pre>hostgroups[0][&#39;groupid&#39;]</pre><p>Adicione agora a pesquisa de eventos, filtrando o “groupids” pelo id do grupos pesquisado por nome anteriormente, e escolha alguns campos de output:</p><pre>events <em>=</em> api.event.get(<br>    output<em>=</em>[<br>        &#39;clock&#39;,<br>        &#39;name&#39;,<br>        &#39;value&#39;,<br>        &#39;severity&#39;,<br>    ],<br>    groupids<em>=</em>hostgroups[0][&#39;groupid&#39;],<br>)</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*QwqTueVco0bJRQYNl22Yhw.png" /></figure><p>Outros dois detalhes interessantes são:</p><ul><li>Primeiro todos os horários da API vem em formato timestamp (número de segundos passados desde 1 de Janeiro de 1970) então deve-se fazer a conversão, o que não é muito difícil com a função “fromtimestamp” da biblioteca “datetime” do Python dentro de um loop para cada evento e em seguida transformando o formato usando o “strftime”.</li></ul><pre><em>from</em> datetime <em>import</em> datetime<br><em>for</em> event <em>in</em> events:<br>    hora_evento <em>=</em> datetime.fromtimestamp(<br>        int(event[&#39;clock&#39;])<br>    ).strftime(&#39;%Y-%m-%d %H:%M:%S&#39;)</pre><ul><li>Em segundo lugar a severidade é um digito de 0 à 5 conforme o padrão do Zabbix na ordem, então podemos fazer uma lista das severidades na ordem correta e indexar as mesmas usando o número:</li></ul><pre>severidades <em>=</em> [<br>    &#39;Não classificada&#39;,<br>    &#39;Informação&#39;,<br>    &#39;Atenção&#39;,<br>    &#39;Média&#39;,<br>    &#39;Alta&#39;,<br>    &#39;Desastre&#39;<br>]<em><br></em><br><em>for</em> event <em>in</em> events:<br>    severidade <em>=</em> severidades[(int(event[&#39;severity&#39;]))]</pre><p>Note também nos dois casos que como todos os dados da API vem no formato de string então é necessário converter o tipo para inteiro para que o python use ele na indexação da lista, o que pode-se fazer usando a função “int()”.</p><p>Para fazer um print formatando uma mensagem final mais interessante, vou finalizar o tutorial deixando aqui um exemplo final desse código de eventos com a conversão do timestamp e do mapeamento de severidade:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/3ea5d3a6bdd1293a398805897587ffa9/href">https://medium.com/media/3ea5d3a6bdd1293a398805897587ffa9/href</a></iframe><p>Rodando o script no terminal:</p><pre><em>python consulta_003.py</em></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qxMHmB1HREJ-6-4ij-qfFA.png" /><figcaption>Resultado final de formatação dos eventos do grupo ‘Linux servers’</figcaption></figure><p>E é isso! Foco nos estudos e paciência nos testes é o segredo para fazer a combinação Python+Zabbix entregar relatórios e outros resultados que você precise.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=869b2b9f550f" width="1" height="1" alt=""><hr><p><a href="https://medium.com/zabbix-brasil/iniciando-r%C3%A1pido-com-a-api-do-zabbix-usando-python-3-869b2b9f550f">Iniciando rápido com a API do Zabbix usando Python 3</a> was originally published in <a href="https://medium.com/zabbix-brasil">Zabbix Brasil</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Passos de Instalação do GLPI 9.5]]></title>
            <link>https://isaqueprofeta.medium.com/passos-de-instala%C3%A7%C3%A3o-do-glpi-9-5-3ac1e8a27f1f?source=rss-c04e79af8ce1------2</link>
            <guid isPermaLink="false">https://medium.com/p/3ac1e8a27f1f</guid>
            <category><![CDATA[itil]]></category>
            <category><![CDATA[ticketing]]></category>
            <category><![CDATA[monitoramento]]></category>
            <category><![CDATA[glpi]]></category>
            <category><![CDATA[gestão]]></category>
            <dc:creator><![CDATA[Isaque Profeta]]></dc:creator>
            <pubDate>Thu, 06 Aug 2020 21:49:31 GMT</pubDate>
            <atom:updated>2020-08-06T22:00:23.551Z</atom:updated>
            <content:encoded><![CDATA[<p>Instalação do GLPI 9.5 com MariaDB 10, todos os módulos em apenas uma máquina no CentOS 8.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/295/1*UdnE-3UrpArpmn48aKo06A.png" /></figure><h4>Banco de dados: MariaDB 10</h4><p>Instale o módulo do MariaDB via dnf:</p><pre>dnf module install mariadb</pre><p>Inicie o serviço do MariaDB, e habilite o inicio com o sistema operacional:</p><pre>systemctl start mariadb &amp;&amp; systemctl enable mariadb</pre><p>Execute a configuração inicial do banco de dados (Minhas orientações de como preencher estão entre !!Exclamações!! ):</p><pre>mysql_secure_installation</pre><pre># opções<br>Enter current password for root (enter for none): !!Aperte ENTER!!<br>Set root password? [Y/n] !!Y!!<br>New password: !!Digite a senha do root para o BD!!<br>Re-enter new password: !!Digite a senha do root para o BD!!<br>Remove anonymous users? [Y/n] !!Y!!<br>Disallow root login remotely? [Y/n] !!Y!!<br>Remove test database and access to it? [Y/n] !!Y!!<br>Reload privilege tables now? [Y/n] !!Y!!</pre><p>Crie um usuário no banco de dados com senha, crie o banco a ser usado e dê permissões de acesso banco para o usuário (altere a “MinhaSenhaDoGLPI”):</p><pre># acesso a console<br>mysql -u root -p</pre><pre># criação do usuário e permissão<br>CREATE USER &#39;glpi&#39;@&#39;%&#39; IDENTIFIED BY &#39;MinhaSenhaDoGLPI&#39;;<br>GRANT USAGE ON *.* TO &#39;glpi&#39;@&#39;%&#39; IDENTIFIED BY &#39;MinhaSenhaDoGLPI&#39;;</pre><pre># criação do banco de dados e permissão<br>CREATE DATABASE IF NOT EXISTS `glpi` ;<br>GRANT ALL PRIVILEGES ON `glpi`.* TO &#39;glpi&#39;@&#39;%&#39;;</pre><pre># atualização global das permissões<br>FLUSH PRIVILEGES;</pre><pre>exit</pre><h4>Servidor Web</h4><p>Instale os repositórios EPEL e REMI, trocando a fonte de instalação do PHP para os mesmos:</p><pre># Instalação dos repositórios<br>dnf install epel-release<br>dnf install <a href="https://rpms.remirepo.net/enterprise/remi-release-8.rpm">https://rpms.remirepo.net/enterprise/remi-release-8.rpm</a></pre><pre># Troca da fonte de instalação padrão do PHP<br>dnf module reset php<br>dnf module enable php:remi-7.4</pre><p>Instale o Apache2, as dependências de sistema operacional e os pacotes do PHP necessários para o funcionamento do GLPI:</p><pre>dnf install wget tar zip bzip2 httpd php php-{curl,fileinfo,gd,json,mbstring,mysqli,session,zlib,simplexml,xml,cli,domxml,imap,ldap,openssl,xmlrpc,pecl-apcu,pecl-zip,intl}</pre><p>Se necessário, edite, alterando ou removendo os comentários, nas linhas no /etc/php.ini que tem as opções:</p><pre>memory_limit = 128M<br>file_uploads = On<br>max_execution_time = 30<br>session.auto_start = 0<br>session.use_trans_sid = 0</pre><p>Vá até o <a href="https://github.com/glpi-project/glpi/releases">GitHub do GLPI</a> e copie o endereço para download da versão mais atual (9.5.1 no momento deste artigo) e faça o download na pasta /tmp:</p><pre># acessar diretório temporário<br>cd /tmp</pre><pre># download do GLPI<br>wget <a href="https://github.com/glpi-project/glpi/releases/download/9.5.1/glpi-9.5.1.tgz">https://github.com/glpi-project/glpi/releases/download/9.5.1/glpi-9.5.1.tgz</a></pre><p>Faça a extração do projeto na pasta do serviço do Apache2 e corrija as permissões de acesso:</p><pre># descompactar <br>tar xzf glpi-9.5.1.tgz -C /var/www/html/</pre><pre># correção das permissões<br>chown -R apache:apache /var/www/html/glpi<br>chmod -R 755 /var/www/html/glpi/files/<br>chmod -R 755 /var/www/html/glpi/config/</pre><p>Crie o arquivo de configuração do GLPI /etc/httpd/conf.d/glpi.conf para o Apache2 com o seguinte conteúdo (Pode adequar o ServerName a um de sua preferência):</p><pre>&lt;VirtualHost *:80&gt;<br>   ServerName glpi.local<br>   DocumentRoot /var/www/html/glpi</pre><pre>   ErrorLog &quot;/var/log/httpd/glpi_error.log&quot;<br>   CustomLog &quot;/var/log/httpd/glpi_access.log&quot; combined</pre><pre>&lt;Directory&gt; /var/www/html/glpi/config&gt;<br>           AllowOverride None<br>           Require all denied<br>   &lt;/Directory&gt;<br>   &lt;Directory&gt; /var/www/html/glpi/files&gt;<br>           AllowOverride None<br>           Require all denied<br>   &lt;/Directory&gt;<br>&lt;/VirtualHost&gt;</pre><p>Inicie e habilite o Apache2 na inicialização do sistema:</p><pre>systemctl start httpd &amp;&amp; systemctl enable httpd</pre><h4>Sistema operacional: CentOS 8</h4><p>Adicione as regras de exceção do SELinux:</p><pre>setsebool -P httpd_unified 1<br>setsebool -P httpd_can_network_connect 1<br>setsebool -P httpd_graceful_shutdown 1<br>setsebool -P httpd_can_network_relay 1<br>setsebool -P nis_enabled 1<br>setsebool -P httpd_can_network_connect_db 1<br>setsebool -P httpd_can_sendmail on</pre><p>Configure a regra de firewall para acesso ao frontend e recarregue as regras:</p><pre># acesso ao frontend web<br>firewall-cmd --add-service={http,https} --permanent</pre><pre># recarrega as regras de firewall<br>firewall-cmd --reload</pre><h4>GLPI instalação web:</h4><p>Siga com o processo de instalação via browser em <a href="http://ip_zabbix/zabbix:">http://ip_glpi/:</a> (Note que eu ignoro a extensão de php-cas uma vez que não é necessária se você não precisa da funcionalidade extra)</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2Fll-EgIZgXkk%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dll-EgIZgXkk&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2Fll-EgIZgXkk%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/4d1c71ad3ddaa341d5b48ede2b511a77/href">https://medium.com/media/4d1c71ad3ddaa341d5b48ede2b511a77/href</a></iframe><h4>GLPI Pós-instalação:</h4><p>Por questão de segurança remova (ou renomeie) o arquivo da página de instalação web:</p><pre>rm /var/www/html/glpi/install/install.php</pre><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=3ac1e8a27f1f" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Erros na atualização de versões, ou recuperação de backup de banco de dados do Zabbix]]></title>
            <link>https://medium.com/zabbix-brasil/erros-na-atualiza%C3%A7%C3%A3o-de-vers%C3%B5es-ou-recupera%C3%A7%C3%A3o-de-backup-de-banco-de-dados-do-zabbix-5abd27fd1975?source=rss-c04e79af8ce1------2</link>
            <guid isPermaLink="false">https://medium.com/p/5abd27fd1975</guid>
            <category><![CDATA[monitoramento]]></category>
            <category><![CDATA[zabbix]]></category>
            <category><![CDATA[ferramentas]]></category>
            <category><![CDATA[iniciante]]></category>
            <category><![CDATA[infraestrutura]]></category>
            <dc:creator><![CDATA[Isaque Profeta]]></dc:creator>
            <pubDate>Thu, 06 Aug 2020 02:52:07 GMT</pubDate>
            <atom:updated>2021-06-09T21:47:22.218Z</atom:updated>
            <content:encoded><![CDATA[<p>Em resumo, é preciso executar o processo do zabbix_server após atualização ou restauração do banco de dados ANTES de acessar o <em>Frontend</em> PHP no<em> browser</em>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/441/1*YwNZEXRQZBiHIi4zGntIDQ.png" /></figure><h4>O problema recorrente</h4><p>Participo do grupo de <a href="https://t.me/ZabbixBrasil">Telegram do Zabbix Brasil</a> e várias vezes vejo uma pergunta sobre o mesmo erro quando se tenta fazer a atualização (ou restauração de <em>backup</em>) de versão mais antiga para uma versão mais nova da ferramenta de monitoração <a href="https://www.zabbix.com/">Zabbix</a>, erro esse que ocorre quando se tenta acessar o <em>Frontend</em> PHP:</p><p>“Database error: The frontend does not match Zabbix database. Current database version (mandatory/optional): 4020000/4020001. Required mandatory version: 4040000. Contact your system administrator.”</p><h4>“Entender o problema é igual a saber 50% da solução”</h4><p>Esse erro normalmente acontece porque o Zabbix tem no seu banco de dados uma tabela com um identificador de versão do banco, esse parâmetro pode ser alterado pelo <em>daemon</em> do zabbix_server quando o mesmo inicia. O <em>Frontend</em> PHP tem o mesmo identificador fixo no código de acordo com a versão, e ao ser acesso via web browser ele compara a sua versão <em>Major</em> (Os três dígitos iniciais) com a do Zabbix <em>Server</em>. Alguns exemplos de identificador de versão:</p><ul><li>Versão 3.4: 3040000</li><li>Versão 4.0: 4000000</li><li>Versão 4.4: 4040000</li><li>Versão 5.0: 5000000</li></ul><h4>Primeiro caso — Frontend novo com banco de dados velho…</h4><p>Conforme vimos então, num primeiro caso em que o identificador do banco de dados esteja na versão 4.4 (Id 4040000) e ocorra atualização da ferramenta do Zabbix para a versão 5.0 (Id 5000000). Ao acessar (sem executar o <em>daemon</em> do zabbix_server) o <em>Frontend</em> PHP, ele vai comparar a versão <em>Major</em> e ver que são diferentes e vai apresentar o famigerado erro.</p><p>Para resolver esse primeiro caso logo após executar a atualização dos pacotes (via yum, apt ou compilação) é preciso <strong>primeiro </strong>iniciar/reiniciar o processo do zabbix_server pois só então ele vai identificar a versão mais antiga no banco, fazer as atualizações necessárias na estrutura desse último e depois disso vai atualizar o identificador de versão. Se você <strong>estiver recuperando um backup</strong>, primeiro recupere ele na mesma versão na qual ele foi realizado e <strong>apenas depois</strong> faça o upgrade.</p><p><strong>Acompanhe as logs do zabbix_server</strong> e aguarde primeiro que as mesmas estejam normalizadas com a informação de que o processo subiu com sucesso, pois o mesmo não vai subir enquanto não terminar de migrar o banco de dados (o que pode demorar, dependendo do tamanho do banco).</p><p>Outra coisa que pode acontecer é que, dependendo da diferença da versão, você pode precisar atualizar manualmente alguns scripts de banco de dados então<strong> dê atenção redobrada</strong> <strong>as logs do zabbix_server.</strong></p><h4>Segundo caso — Frontend velho com banco de dados novo…</h4><p>Num primeiro caso em que o identificador do banco de dados esteja atualizado para a versão 5.0 (Id 5000000) e o erro indique que o <em>Frontend</em> PHP está esperando uma versão mais velha, 4.4 (Id 4040000) por exemplo, para resolver basta atualizar os pacotes do frontend que tenham sido esquecidos ou que tenham falhado na atualização.</p><h4>Passo a passo de como atualizar corretamente a versão do Zabbix</h4><ol><li>Pare o processo do httpd (Apache ou Nginx);</li><li>Pare o processo do zabbix_server;</li><li><strong>Faça backup</strong> do banco de dados do Zabbix;</li><li><strong>Realize a atualização</strong> dos pacotes da ferramenta Zabbix usando o método necessário (apt, yum, compilação…);</li><li><strong>Inicie o zabbix_server</strong> e espere ele atualizar o banco de dados, acompanhando nas logs e no status do serviço a situação, pois quanto maior o banco, mais tempo leva essa fase;</li><li><strong>Revise as logs do zabbix_server.log</strong>, para ver se a atualização do banco de dados foi bem sucedida, ou se falta alguma dependência de atualização.</li><li>Inicie o processo do httpd (Apache ou Nginx);</li><li>Agora o <em>frontend</em> deve funcionar sem erros.</li></ol><p>Se o inglês não for barreira, você pode ver este <a href="https://www.youtube.com/watch?v=Meyiiht5WxE">vídeo oficial</a> da ferramenta sobre o processo e dicas de upgrade.</p><h4>Não existe downgrade da versão do banco de dados do Zabbix</h4><p>FAÇA SEU <em>BACKUP</em>! <a href="https://www.zabbix.com/forum/zabbix-troubleshooting-and-problems/375864-downgrade-zabbix-database-version?p=376141#post376141">Conforme post do Dimitri</a> (Desenvolvimento e suporte oficial da Zabbix Inc.) nos fóruns oficiais, não existe procedimento para mudar o banco de dados para uma versão anterior, eles oferecem o suporte para esse tipo de situação mediante contratação oficial paga.</p><p>Artigo originalmente publicado no <a href="https://www.linkedin.com/pulse/erros-na-atualiza%C3%A7%C3%A3o-de-vers%C3%B5es-ou-recupera%C3%A7%C3%A3o-backup-isaque-profeta/">LinkedIn</a>.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=5abd27fd1975" width="1" height="1" alt=""><hr><p><a href="https://medium.com/zabbix-brasil/erros-na-atualiza%C3%A7%C3%A3o-de-vers%C3%B5es-ou-recupera%C3%A7%C3%A3o-de-backup-de-banco-de-dados-do-zabbix-5abd27fd1975">Erros na atualização de versões, ou recuperação de backup de banco de dados do Zabbix</a> was originally published in <a href="https://medium.com/zabbix-brasil">Zabbix Brasil</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Passos de Instalação do Zabbix 5.2 no Centos8]]></title>
            <link>https://medium.com/zabbix-brasil/passos-de-instala%C3%A7%C3%A3o-do-zabbix-5-0-f94f93a80e20?source=rss-c04e79af8ce1------2</link>
            <guid isPermaLink="false">https://medium.com/p/f94f93a80e20</guid>
            <category><![CDATA[zabbix]]></category>
            <category><![CDATA[infraestrutura]]></category>
            <category><![CDATA[iniciante]]></category>
            <category><![CDATA[ferramentas]]></category>
            <category><![CDATA[monitoramento]]></category>
            <dc:creator><![CDATA[Isaque Profeta]]></dc:creator>
            <pubDate>Thu, 06 Aug 2020 02:49:11 GMT</pubDate>
            <atom:updated>2023-05-11T14:59:23.166Z</atom:updated>
            <content:encoded><![CDATA[<h3>Passos de Instalação do Zabbix 6.0 no Rocky/Alma Linux 8</h3><p>Instalação do Zabbix 6.0 com PostgresSQL 15, todos os módulos em apenas uma máquina no Rocky/Alma Linux versão 8, com dicas de SELinux e TimescaleDB (testado com vagrant com a imagem almalinux/8 no virtualbox)</p><blockquote>Atualizado em 11/05/2023 : Zabbix 6.0 + Postgres 15</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*laN-70Rl3nb3AtjKiNaX2A.jpeg" /></figure><blockquote>Todo o tutorial desta instalação prevê o uso direto do usuário <strong>root</strong></blockquote><h4>Sistema operacional: CentOS 8</h4><p>Desabilitar o SELinux (No final dou uma dica de como manter ele ligado e em modo <em>enforcing</em>):</p><pre>sed -i &quot;s/SELINUX=enforcing/SELINUX=disabled/&quot; /etc/selinux/config</pre><pre>setenforce 0</pre><p>Configure o <em>firewall</em> e reinicie a máquina para desativar o SELinux editado anteriormente:</p><pre># monitorações agente zabbix<br>firewall-cmd --add-port={10051/tcp,10050/tcp} --permanent</pre><pre># monitorações agente snmp<br>firewall-cmd --add-port={161/udp,162/udp} --permanent</pre><pre># acesso ao frontend web<br>firewall-cmd --add-service={http,https} --permanent</pre><pre># recarrega as regras de firewall<br>firewall-cmd --reload</pre><h4>Banco de dados: PostgreSQL 15</h4><p>Adicione o repositório para o PostgresSQL, desabilite o repositório padrão do CentOS para esse pacote e finalmente instale os pacotes do sistema de banco de dados, executando logo depois o setup inicial do sistema de banco:</p><pre>yum -y install <a href="https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm">https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm</a></pre><pre>dnf -y module disable postgresql</pre><pre>dnf -y install postgresql15 postgresql15-server</pre><pre>/usr/pgsql-15/bin/postgresql-15-setup initdb</pre><p>Edite o modo de autenticação, alterando a opção ident para md5 nas linhas do arquivo /var/lib/pgsql/15/data/pg_hba.conf:</p><pre>sed -i &quot;s/ident/md5/g&quot; /var/lib/pgsql/15/data/pg_hba.conf</pre><p>Configure para que o PostgreSQL responda em todos os endereços IP do servidor (para facilitar integrações), alterando a opção listen_addresses na linha abaixo no arquivo /var/lib/pgsql/15/data/postgresql.conf:</p><pre>sed -i &quot;s/#listen_addresses = &#39;localhost&#39;/listen_addresses = &#39;*&#39;/&quot; /var/lib/pgsql/15/data/postgresql.conf</pre><p>Inicie o serviço do postgresql-12, habilite o inicio com o sistema operacional:</p><pre>systemctl enable --now postgresql-15</pre><p>Crie um usuário no banco de dados com senha e crie o banco a ser usado (o segundo comando pode apresentar um erro de “<em>could not change directory</em>” que deve ser ignorado):</p><blockquote>Atenção, troque a senha abaixo de exemplo “Z4bb1xD4t4b4s3”</blockquote><pre>sudo -u postgres psql -c &quot;CREATE USER zabbix WITH ENCRYPTED PASSWORD &#39;Z4bb1xD4t4b4s3&#39;&quot; 2&gt;/dev/null</pre><pre>sudo -u postgres createdb -O zabbix -E Unicode -T template0 zabbix 2&gt;/dev/null</pre><h4>Zabbix Server 6.0</h4><p>Adicione o repositório do Zabbix, instalando o zabbix-server-pgsql em seguida:</p><pre>rpm -Uvh <a href="https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-6.0-1.el8.noarch.rpm">https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-6.0-1.el8.noarch.rpm</a></pre><pre>dnf -y install zabbix-server-pgsql zabbix-sql-scripts</pre><p>Crie o <em>schema</em> do banco de dados (novamente pode apresentar um erro de “<em>could not change directory</em>” que deve ser ignorado):</p><pre>zcat /usr/share/zabbix-sql-scripts/postgresql/server.sql.gz | sudo -u zabbix PGPASSWORD=Z4bb1xD4t4b4s3 psql -hlocalhost -Uzabbix zabbix 2&gt;/dev/null</pre><p>Edite, alterando ou removendo os comentários, nas linhas no /etc/zabbix/zabbix_server.conf:</p><blockquote>Atenção, troque a senha abaixo de exemplo “Z4bb1xD4t4b4s3”</blockquote><pre>DBHost=localhost<br>DBName=zabbix<br>DBUser=zabbix<br>DBPassword=Z4bb1xD4t4b4s3</pre><p>Inicie o serviço do zabbix-server e habilite o inicio com o sistema operacional:</p><pre>systemctl enable --now zabbix-server</pre><h4>Zabbix Frontend</h4><p>Considerando que o repositório do zabbix já foi configurado, instale os pacotes de <em>frontend</em> e de configurações do Apache:</p><pre>dnf -y install zabbix-web-pgsql zabbix-nginx-conf</pre><p>Editar o arquivo /etc/php-fpm.d/zabbix.conf adicionando a configuração de timezone:</p><pre>echo &quot;php_value[date.timezone] = America/Sao_Paulo&quot; &gt;&gt; /etc/php-fpm.d/zabbix.conf</pre><p>Agora configura-se o Zabbix para ser o Virtual Server principal na porta 80, e em seguida é necessário substituir o padrão do NGINX do Debian pelo padrão do Zabbix:</p><pre>echo &quot;       listen          80;/        listen 80 default_server;\\n        listen [::]:80 default_server;/&quot; /etc/nginx/conf.d/zabbix.conf&quot;<br>echo &quot;       server_name     example.com;/        server_name _;/&quot; /etc/nginx/conf.d/zabbix.conf&quot;<br>sed -i &quot;/.*listen.*/d&quot; /etc/nginx/nginx.conf<br>sed -i &quot;/.*server_name.*/d&quot; /etc/nginx/nginx.conf</pre><p>Inicie primeiro o serviço do php-fpm e depois o do Apache, habilitando também os mesmos no inicio com o sistema operacional:</p><pre>systemctl enable --now php-fpm</pre><pre>systemctl enable --now httpd</pre><h4>Zabbix Frontend - Setup Wizard</h4><p><strong>Normalmente</strong> existe a configuração via wizard web, mas vamos fazer essa configuração pela linha de comando neste artigo. (<strong>caso prefira</strong>, pode usar o link do YouTube da versão antiga deste artigo na 5.0: <a href="https://www.youtube.com/watch?v=qYc_bs5VfpY">Link do vídeo</a>)</p><blockquote>Atenção, troque a senha abaixo de exemplo “Z4bb1xD4t4b4s3”</blockquote><pre>sudo tee /etc/zabbix/web/zabbix.conf.php &lt;&lt;EOL<br>&lt;?php<br>    \$DB[&quot;TYPE&quot;] = &quot;POSTGRESQL&quot;;<br>    \$DB[&quot;SERVER&quot;] = &quot;localhost&quot;;<br>    \$DB[&quot;PORT&quot;] = &quot;5432&quot;;<br>    \$DB[&quot;DATABASE&quot;] = &quot;zabbix&quot;;<br>    \$DB[&quot;USER&quot;] = &quot;zabbix&quot;;<br>    \$DB[&quot;PASSWORD&quot;] = &quot;Z4bb1xD4t4b4s3&quot;;<br>    \$DB[&quot;SCHEMA&quot;] = &quot;&quot;;<br>    \$DB[&quot;ENCRYPTION&quot;] = false;<br>    \$DB[&quot;KEY_FILE&quot;] = &quot;&quot;;<br>    \$DB[&quot;CERT_FILE&quot;] = &quot;&quot;;<br>    \$DB[&quot;CA_FILE&quot;] = &quot;&quot;;<br>    \$DB[&quot;VERIFY_HOST&quot;] = false;<br>    \$DB[&quot;CIPHER_LIST&quot;] = &quot;&quot;;<br>    \$DB[&quot;VAULT_URL&quot;] = &quot;&quot;;<br>    \$DB[&quot;VAULT_DB_PATH&quot;] = &quot;&quot;;<br>    \$DB[&quot;VAULT_TOKEN&quot;] = &quot;&quot;;<br>    \$DB[&quot;DOUBLE_IEEE754&quot;] = true;<br>    \$ZBX_SERVER = &quot;localhost&quot;;<br>    \$ZBX_SERVER_PORT = &quot;10051&quot;;<br>    \$ZBX_SERVER_NAME = &quot;zabbix&quot;;<br>    \$IMAGE_FORMAT_DEFAULT = IMAGE_FORMAT_PNG;<br>EOL</pre><p>Agora basta acessar via browser o Zabbix em <a href="http://ip/_do/_servidor/](http://ip_do_servidor/zabbix)">http://ip_do_servidor/</a> (Essa instalação coloca o Zabbix direto na raiz do site “/” e não no “/zabbix”)</p><h4>Zabbix Agent para a instalação deste Zabbix Server</h4><p>Considerando que o repositório do Zabbix já está instalado (essa instalação coloca todos os módulos na mesma máquina), instale o agente:</p><pre>dnf install zabbix-agent</pre><p>Edite, alterando ou removendo os comentários, se necessário nas linhas do arquivo /etc/zabbix/zabbix_agentd.conf:</p><pre>Server=127.0.0.1<br>ServerActive=127.0.0.1<br>Hostname=Zabbix server</pre><p>Inicie o serviço do zabbix-agent e habilite o inicio com o sistema operacional:</p><pre>systemctl enable --now zabbix-agent</pre><h4>Dando tudo certo</h4><p>Espere alguns segundos e veja que o host zabbix-server já está com agente verde e o ambiente pronto para uso.</p><h4>Caso algo dê errado</h4><p>Revise todo o passo-a-passo verificando o status dos serviços e as <em>logs</em>, e se precisar de ajuda dê um pulo no canal do <a href="https://t.me/ZabbixBrasil">Telegram do Zabbix Brasil</a>.</p><p>Zabbix Server:</p><pre>systemctl status zabbix-server</pre><pre>cat /var/log/zabbix/zabbix_server.log</pre><p>PostgreSQL:</p><pre>systemctl status postgresql-15</pre><pre>cat /var/lib/pgsql/15/data/log/postgresql*.log</pre><p>Apache:</p><pre>systemctl status httpd</pre><pre>cat /var/log/httpd/error_log</pre><p>php-fpm:</p><pre>systemctl status php-fpm</pre><pre>cat /var/log/php-fpm/error.log</pre><p>Zabbix Agente:</p><pre>systemctl status zabbix-agent</pre><pre>cat /var/log/zabbix/zabbix_agentd.log</pre><h4>Extra 1: SELinux em modo enforcing</h4><p>Pare todos os serviços ligados ao zabbix-server na ordem:</p><pre>systemctl stop httpd<br>systemctl stop php-fpm<br>systemctl stop zabbix-server<br>systemctl stop postgresql-15</pre><p>Habilite o SELinux como enforcing no /etc/selinux/config:</p><pre>SELINUX=enforcing</pre><p>Reinicie a máquina:</p><pre>reboot</pre><p>Verifique se todos os serviços já estão rodando, sendo que o zabbix-server deve estar com problemas:</p><pre>systemctl status httpd<br>systemctl status php-fpm<br>systemctl status zabbix-server<br>systemctl status postgresql-15</pre><p>Instale a ferramenta para facilitar a criação de exceções para a auditoria do SELinux:</p><pre>dnf install policycoreutils-python-utils</pre><p>O SELinux mantem todas as falhas não permitidas dentro de um arquivos de auditoria que são os /var/log/audit/audit.log* então a partir dessas falhas crie o arquivo de exceções:</p><pre>grep AVC /var/log/audit/audit.log* | audit2allow -M systemd-allow</pre><p>Aplique as exceções no sistema do SELinux:</p><pre>semodule -i systemd-allow.pp</pre><p>Confira com calma se tudo está funcionando, pois vai ser necessário repetir várias vezes essa liberação, em meus testes para esse artigo precisei de realizar o comando cinco vezes pelo motivo abaixo:</p><blockquote>IMPORTANTE: Tome o cuidado de revisar essas permissões sempre que criar novos tipos de monitoração uma vez que o SELinux funciona sempre negando acesso primeiro para depois permitir.</blockquote><p>Então tome o cuidado também de revisar essas permissões sempre que criar novos tipos de monitoração que dependam de outros acessos, ou até mesmo se você for configurar um envio de <em>e-mail</em> e mensagens via <em>bot telegram</em>, ou integração com LDAP e etc.</p><h4>Extra 2: TimescaleDB</h4><p>Para usar o sistema de particionamento de tabelas do TimescaleDB, primeiro instale o pacote da extensão:</p><pre>sudo tee /etc/yum.repos.d/timescale_timescaledb.repo &lt;&lt;EOL<br>[timescale_timescaledb]<br>name=timescale_timescaledb<br>baseurl=<a href="https://packagecloud.io/timescale/timescaledb/el/$(rpm">https://packagecloud.io/timescale/timescaledb/el/$(rpm</a> -E %{rhel})/\$basearch<br>repo_gpgcheck=1<br>gpgcheck=0<br>enabled=1<br>gpgkey=<a href="https://packagecloud.io/timescale/timescaledb/gpgkey">https://packagecloud.io/timescale/timescaledb/gpgkey</a><br>sslverify=1<br>sslcacert=/etc/pki/tls/certs/ca-bundle.crt<br>metadata_expire=300<br>EOL</pre><pre>dnf -y install timescaledb-2-postgresql-15</pre><p>Pare o banco de dados:</p><pre>systemctl stop zabbix-server</pre><p>Realize as configurações do postgres, o tunning do plugin e adicione a extensão ao banco de dados do zabbix:</p><pre>echo &quot;shared_preload_libraries = &#39;timescaledb&#39;&quot; &gt; /var/lib/pgsql/15/data/postgresql.conf</pre><pre>sudo sed -i &quot;s/max_connections = 20/max_connections = 50/&quot; /var/lib/pgsql/15/data/postgresql.conf</pre><pre>echo &quot;timescaledb.license=timescale&quot; &gt;&gt; /var/lib/pgsql/15/data/postgresql.conf</pre><pre>sudo systemctl restart postgresql-15</pre><pre>sudo -u postgres timescaledb-tune --quiet --yes --pg-config=/usr/pgsql-15/bin/pg_config</pre><pre>echo &quot;CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;&quot; | sudo -u postgres psql zabbix 2&gt;/dev/null</pre><p>Execute o script de migração e reinicie o ambiente:</p><pre>cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix</pre><pre>systemctl start zabbix-server</pre><pre>systemctl restart php-fpm</pre><pre>systemctl restart nginx</pre><p>Agora você pode configurar os prazos de dados no banco a partir do <em>frontend web</em> no caminho de <em>Administration -&gt; General -&gt; Housekeeping</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/738/1*V2E7dvfHMGSkghqb3QvMlA.png" /></figure><p>Artigo originalmente publicado no <a href="https://www.linkedin.com/pulse/passos-de-instala%C3%A7%C3%A3o-do-zabbix-50-isaque-profeta/">LinkedIn</a>.</p><blockquote>Atualizado em 11/12/2020 : Zabbix 5.2 + Postgres 12</blockquote><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f94f93a80e20" width="1" height="1" alt=""><hr><p><a href="https://medium.com/zabbix-brasil/passos-de-instala%C3%A7%C3%A3o-do-zabbix-5-0-f94f93a80e20">Passos de Instalação do Zabbix 5.2 no Centos8</a> was originally published in <a href="https://medium.com/zabbix-brasil">Zabbix Brasil</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>