Instalação e configuração do Elastic Stack 8 em ambiente Windows
Neste artigo irei demonstrar em 10 passos como realizar a instalação do Elastic Stack na versão 8.2 no Windows. Se você ainda não sabe o que é Elastic Stack, neste artigo eu faço uma pequena introdução desse conjunto de soluções da Elastic.
A versão 8 da stack incluiu por padrão algumas funções importantes de segurança, entre elas podemos destacar:
- Autenticação de usuário
- Autorização de usuário com Role-Based Access Control (RBAC)
- Multi-tenancy com Kibana Spaces
- Comunicação criptografada de ponta a ponta com TLS
- Comunicação criptografada com a API Elasticsearch em HTTPS
No site oficial da Elastic tem um guia dos passos de instalação, porém na versão 8 o processo de instalação modificou em relação as versões anteriores e por isso, algumas pessoas que estão conhecendo agora a stack estão com dificuldade neste primeiro contato com a instalação. Se é o seu caso, acompanhe abaixo o processo de instalação:
Passo 1: Fazer o download do binário no site oficial da Elastic
Acesse o site através do link: Get Started with Elasticsearch, Kibana, and the Elastic Stack | Elastic
Na sessão do Elasticsearch, selecione a plataforma Windows e clique no botão para iniciar o download:
Em seguida, faça o download do binário do Kibana, escolhendo também a plataforma Windows:
Aguarde a conclusão do download e avance para o passo 2!
Passo 2: Extrair o binário do Elasticsearch
Provavelmente os binários que você fez o download ficou na pasta de downloads do Windows, caso contrario, navegue até o diretório onde você salvou os binários.
Selecione o binário do elasticsearch e clique com o botão direito do mouse na opção de extrair. Quando concluir o processo de extração, avance para o passo 3.
Passo 3: Executar o binário através do Windows PowerShell
Abra o Windows PowerShell ou CMD e navegue até o diretório extraído do elasticsearch:
Dentro do diretório do elasticsearch execute o comando: .\bin\elasticsearch.bat
Aguarde todo o processo e não feche a janela do PowerShell ! pois, nos logs de output da instalação terá uma informação essencial para os próximos passos.
Passo 4: Salvar o output da instalação do Elasticsearch
No final do processo de instalação você verá uma mensagem semelhante a esta:
Durante o processo de instalação do Elasticsearch, os recursos de segurança são habilitados e configurados por padrão:
- A autenticação e a autorização são habilitadas e uma senha é gerada para o super usuário interno elastic.
- Certificados e chaves para TLS são gerados para a camada de transporte e HTTP, e o TLS é habilitado e configurado com essas chaves e certificados.
- Token para integração e configuração do Kibana.
OBS1.: Copie essas informações e salve em um bloco de notas, pois são as informações de segurança do elasticsearch e que você precisará para configurar o Kibana e credencias de acesso a stack.
OBS2.: Cuidado ao executar o comando (control + C) para realizar a cópia do output do Elasticsearch, pois o comando pode cancelar o processo de instalação. Então, o recomendado é selecionar com o mouse e clicar com o botão direito, no qual copiará automaticamente.
Deixe minimizado a janela do powershell e siga para o passo de instalação do Kibana (Passo 5).
Passo 5: Extrair o binário do Kibana
Semelhante ao passo de extração do elasticsearch, selecione o binário do Kibana e clique com o botão direito do mouse a opção de extrair.
Você perceberá a criação de uma pasta com o nome iniciado com Kibana e o do elasticsearch que foi extraído anteriormente. Avance para o próximo passo.
Passo 6: Executar o binário do Kibana em outra janela do Windows PowerShell
Abra uma segunda janela do Windows PowerShell ou CMD, navegue até o diretório do Kibana que você extraiu e execute o comando: .\bin\kibana.bat
Aguarde o processo de instalação e siga para o próximo passo.
Passo 7: Copiar o link do Kibana no output da instalação
No final do processo de instalação o binário irá gerar um link no output dos logs, semelhante a imagem abaixo:
Clique no link gerado e você será direcionado ao browser para finalizar o processo de instalação do Kibana:
Siga para o próximo passo.
Passo 8: Copiar o token do elasticsearch no Kibana
Recupere no bloco de notas que você salvou anteriormente no processo de instalação do elasticsearch, copie o token do kibana e cole no espaço correspondente no browser:
OBS.: O token tem uma expiração de 30min, caso o tempo tenha excedido o tempo, você terá que gerar um novo token.
insira o token no campo correspondente e clique no botão “Configure Elastic” e avance para o próximo passo.
Passo 9: Validação da instalação
Automaticamente o Kibana fará a integração com o elasticsearch (que está em execução na primeira janela do powershell) e deixará todo o ambiente pronto e seguro para uso.
Passo 10: Tela de boas vindas no Kibana
Após conclusão do processo de configuração, você será redirecionado a tela de login do Kibana, no qual será solicitado o usuário e senha para acesso.
O usuário e senha para acessar o Kibana é o usuário interno que foi gerado pelo elasticsearch e você salvou no bloco de notas:
Só digitar o nome do usuário e a senha nos campos correspondentes e você será autenticado com sucesso ;)
Conclusão
Com todo o processo concluído você terá uma stack protegida e preparada para os diversos caso de uso:
Onde aprender mais?
Caso você queira aprender um pouco mais sobre o Elastic Stack, estou iniciando um canal no Youtube com o objetivo de explicar do zero, como instalar a solução e falar mais aprofundado sobre cada módulo que compõe a stack. Também existe a comunidade oficial da elastic e os grupos de meetups e telegram em várias cidades do Brasil.
Espero que tenham conseguido extrair novos conhecimentos. Caso tenham alguma dúvida, sintam-se livres para em entrar em contato, ou deixar um comentário que irei responder assim que possível.
Obrigado!