Como Ter Seu Proprio Looking Glass

2022-03-11T14:29:23Z

Eduliraeal:

== Introdução ==

Assim como explicado em detalhes no artigo [[Looking Glass]], ter um LG é fundamental para sua rede, principalmente se o ISP em questão for transito. Mesmo se tratando de casos onde não é transito, ter um LG facilita muito o troubleshooting para o seu time técnico.

Na tentativa de incentivar todos os ISP's a terem seu próprio Looking Glass, vou explicar passo-a-passo como configurar um utilizando um LG OpenSource Web utilizando Debian 10, caso tenha preferencia por outra distribuição, apenas adapte conforme sua necessidade.
== Tutorial ==

Após instalar seu Debian 10, atualize seus repositórios com o comando abaixo:

<code>apt update -y</code>

Instale as dependências:

<code>apt install git apache2 libapache2-mod-php php php-common -y</code>

Faça o clone do LG no GitHub:

<code>git clone https://github.com/respawner/looking-glass.git /var/www/html/lg</code>

Reinicie o serviço do Apache2:

<code>systemctl restart apache2.service</code>

Mova os arquivos da pasta /var/www/html/lg para /var/www/html/ , de forma que consiga acessar sem especificar um folder:

<code>mv /var/www/html/lg/* /var/www/html/</code>

Por padrão você só conseguirá acessar o LG a partir do momento que copiar o arquivo config.php.example para config.php, e é exatamente o que faremos agora.

(Prefira copiar a mover/renomear, para que possa ter backup da configuração padrão)
[[Arquivo:LookingGlassDefaultScreen.png|miniaturadaimagem|295x295px]]
<code>cd /var/www/html</code>

<code>cp config.php.example config.php</code>

Caso tenha deixado seu linux em DHCP, verifique qual o IP recebido utilizando seguinte comando:

<code>ip addr</code>

Supondo que o IP seja 192.0.2.2, acesse com a seguinte URL:

[http://192.168.0.10/lg <code>http://192.0.2.2</code>]

O próximo passo é editar o arquivo de configuração que copiamos, para isso, utilize o editor de texto de sua preferencia.

<code>nano /var/www/html/config.php</code>

No arquivo de configuração possuímos alguns campos básicos como:
* Nome;
* E-mail;
* Titulo;
* Logo;
* Disclaimer.
Esses campos deverão ser preenchidos mediante suas informações, segue um exemplo:

[[Arquivo:LG-Interface-Configurado2.png|miniaturadaimagem]]
<code>$config['contact']['name'] = 'NOC HexaNetworks';</code>

<code>$config['contact']['mail'] = 'andredias@hexanetworks.com.br';</code>

<code>// Frontpage configuration</code>

<code>// Title of the page</code>

<code>$config['frontpage']['title'] = 'Looking Glass - Hexa Networks';</code>

<code>// Logo to display (remove it to not display any logo)</code>

<code>$config['frontpage']['image'] = 'logo.png';</code>

<code>// Disclaimer to inform people using the looking glass</code>

<code>// Set it to null to not display a disclaimer</code>

<code>$config['frontpage']['disclaimer'] = <nowiki>''</nowiki>;</code>

Esse arquivo vem pré-configurado para conversar com varios roteadores. Aqui explicarei um cenário simples, onde o FRRouting estará instalado no mesmo S.O. que o LG. Caso precise que funcione em um ambiente diferente, você terá que adaptar para o cenário de sua rede, utilizando a mesma lógica aqui explicada.

Da linha 38 em diante, teremos as configuraçoes relacionadas aos roteadores, vamos editar apenas as linhas relacionadas ao "router1".

Configure mediante o exemplo:

<code>// Authentication based on SSH or Telnet with password</code>

<code>// The hostname or the IP address</code>

<code>$config['routers']['router1']['host'] = '127.0.0.1';</code>

<code>// The user to use to connect to the router</code>

<code>$config['routers']['router1']['user'] = 'lookingglass';</code>

<code>// The password of the given user</code>

<code>$config['routers']['router1']['pass'] = 'SENHA-DO-USUARIO-LOOKINGGLASS';</code>

<code>// The authentication mechanism to use (can be ssh-password or telnet)</code>

<code>$config['routers']['router1']['auth'] = 'ssh-password';</code>

<code>// The router type (can be cisco, ios, juniper or junos)</code>

<code>$config['routers']['router1']['type'] = 'quagga';</code>

<code>// The router source interface to be used</code>

<code>//$config['routers']['router1']['source-interface-id'] = 'lo0';</code>

<code>// The router description to be displayed in the router list</code>
[[Arquivo:LG-Configurado-3.png|miniaturadaimagem]]
<code>$config['routers']['router1']['desc'] = 'Roteador de Borda';</code>

Acima determinamos que:
* O LG fará consulta local;
* Utilizará o usuário "lookingglass" para tal;
* Com a senha "SENHA-DO-USUARIO-LOOKINGGLASS";
* Utilizará SSH;
*O arquivo de configuração não suporta FRRouting como parâmetro, sendo assim, iremos setar como Quagga. Como ambos possuem sintaxes semelhantes (Cisco-Like), será totalmente compatível;
* Comentamos a interface de origem;
* A descrição do roteador é "Roteador de Borda".

Caso queira remover o restante dos roteadores que aparecem, basta apagar ou comentar (//) as linhas referente aos outros roteadores.

O proximo passo é instalar o FRRouting:

<code>apt-get install frr</code>

Adicione o usuario "lookingglass" no seu linux, e o adicione ao grupo "frr":

<code>adduser lookingglass</code>

Informe a senha

Repita a senha

<code>usermod -aG frrvty lookingglass</code>

Acesse a pasta o arquivo daemons do FRR:

<code>nano /etc/frr/daemons</code>

Altere a linha bgpd=no para bgpd=yes e reinicie o FRR:

<code>service frr restart</code>

Utilize o comando vtysh para acessar a VTY do frr.

O próximo passo é basicamente fechar uma sessão iBGP entre seu roteador de borda, e o FRR. Caso não esteja habituado com configuração Cisco-Like, segue um exemplo:

<code>router bgp 65000</code>

<code>neighbor 192.0.2.1 remote-as 65000</code>

<code>neighbor 2001:db8::2 remote-as 65000</code>

<code>!</code>

<code>address-family ipv4 unicast</code>

<code> neighbor 192.0.2.1 route-map IMPORT in</code>

<code> neighbor 192.0.2.1 route-map EXPORT out</code>

<code>exit-address-family</code>

<code>!</code>

<code>address-family ipv6 unicast</code>

<code> neighbor 2001:db8::2 route-map IMPORT in</code>

<code> neighbor 2001:db8::2 route-map EXPORT out</code>

<code>exit-address-family</code>

<code>!</code>

<code>route-map IMPORT permit 10</code>

<code>!</code>

<code>route-map EXPORT deny 1</code>

Após isso, já terá seu Looking Glass em funcionamento, sem ter que se preocupar com integração de vendor, e com total suporte a IPv6.

'''Autor: [https://wiki.brasilpeeringforum.org/w/Usuário:Andredias André Dias]'''
[[Categoria:Roteamento]]
[[Categoria:Infraestrutura]]

Wiki BPF - Contribuições do(a) usuário(a) [pt-br]

Como Ter Seu Proprio Looking Glass