Automated ELK Stack Deployment

This document contains the following details:

• Description of the Topology
• Access Policies
• ELK Configuration
• Target Machines & Beats
• How to Use the Ansible Build

Description of the Topology

The main purpose of this network is to expose a load-balanced and monitored instance of DVWA, the D*mn Vulnerable Web Application.

Load balancing ensures that the application will be highly available, in addition to restricting inbound access to the network. The load balancer ensures that work to process incoming traffic will be shared by all three vulnerable web servers.

Access controls will ensure that only authorized users — namely, ourselves — will be able to connect in the first place.

The additional use of a jump box provides a controlled means of access to manage our VMs in separate security zones.

Integrating an ELK server allows monitoring of the vulnerable VMs for file system changes and system metrics.

The configuration details of each machine may be found below. Note your IPs may differ.

Name	Function	IP Address	Operating System
Jump Box	Gateway	10.0.0.4	Linux
DVWA 1	Web Server	10.0.0.5	Linux
DVWA 2	Web Server	10.0.0.6	Linux
DVWA 3	Web Server	10.0.0.7	Linux
ELK	Monitoring	10.1.0.4	Linux

The network is depicted below.

Access Policies

The machines on the internal network are not exposed to the public Internet.

Only the jump box machine can accept connections from the Internet. Access to this machine is only allowed from your local host public IP address after configuring the network security rules to allow SSH from your local host public IP.

Machines within the network can only be accessed by each other. The DVWA Web-1, DVWA Web-2, and DVWA Web-3 VMs send system logs to the ELK server.

A summary of the access policies in place can be found in the table below.

Name	Publicly Accessible	Allowed IP Addressed
Jump Box	Yes	your local host IP
DVWA 1	No	10.0.0.1-254
DVWA 2	No	10.0.0.1-254
DVWA 3	No	10.0.0.1-254
ELK	No	10.0.0.1-254

Elk Configuration

Ansible was used to automate configuration of the ELK machine. No configuration was performed manually, which is advantageous because human errors and inconsistencies with manual configuration are removed when configuration is defined as code. Additionally, the labor cost with manual configuration is removed via automation. The files in this repo have been tested and used to generate a live ELK deployment on Azure. They can be used to either recreate the entire deployment pictured above, or alternatively, select files may be used to install only certain pieces of it, such as Filebeat.

The install_elk.yml playbook implements the following tasks:

• Increase virtual memory to avoid out of memory exceptions
• Install docker.io
• Install pip3
• Install docker python module
• Download and launch a docker elk container
• Enable service docker on boot

The following is the Ansible playbook for installing ELK:

---
  - name: Config elk VM with Docker
    hosts: elk
    remote_user: redadmin
    become: true
    tasks:

      - name: Use more memory
        sysctl:
          name: vm.max_map_count
          value: '262144'
          state: present
          reload: yes

      - name: docker.io
        apt:
          force_apt_get: yes
          update_cache: yes
          name: docker.io
          state: present

      - name: Install pip3
        apt:
          force_apt_get: yes
          name: python3-pip
          state: present

      - name: Install Python Docker module
        pip:
          name: docker
          state: present

        # Use docker_container module
      - name: download and launch a docker elk container
        docker_container:
          name: elk
          image: sebp/elk:761
          state: started
          restart_policy: always
          published_ports:
            - 5601:5601
            - 9200:9200
            - 5044:5044

        # Use systemd module
      - name: Enable service docker on boot
        systemd:
          name: docker
          enabled: yes

The following screenshot displays the result of running docker ps after successfully configuring the ELK instance:

Target Machines & Beats

This ELK server is configured to monitor the following machines:

• DVWA Web-1, DVWA Web-2, and DVWA Web-3 VMs at 10.0.0.5, 10.0.0.6, and 10.0.0.7 respectively. Note your IPs may differ.

The following Beats are installed on these machines and allow us to collect the following information from each machine:

• Filebeat: Filebeat detects changes to the filesystem. Specifically, we use it to collect Apache logs.
• Metricbeat: Metricbeat detects changes in system metrics, such as CPU usage. We use it to detect SSH login attempts, failed sudo escalations, and CPU/RAM statistics.

The playbook below installs Metricbeat on the DVWA hosts. The playbook for installing Filebeat looks essentially identical — simply replace metricbeat with filebeat, and it will work as expected.

---
- name: Install metric beat
  hosts: webservers
  become: true
  tasks:
    # Use command module
  - name: Download metricbeat
    command: curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-7.4.0-amd64.deb

    # Use command module
  - name: install metricbeat
    command: dpkg -i metricbeat-7.4.0-amd64.deb

    # Use copy module
  - name: drop in metricbeat config
    copy:
      src: /etc/ansible/files/metricbeat-config.yml
      dest: /etc/metricbeat/metricbeat.yml

    # Use command module
  - name: enable and configure docker module for metric beat
    command: metricbeat modules enable docker

    # Use command module
  - name: setup metric beat
    command: metricbeat setup

    # Use command module
  - name: start metric beat
    command: service metricbeat start

    # Use systemd module
  - name: Enable service metricbeat on boot
    systemd:
      name: metricbeat
      enabled: yes

How to Use the Ansible Build

In order to use the playbooks, you will need to have an Ansible control node already configured. We use the jump box for this purpose.

To use the playbooks, we must perform the following steps:

• Copy the playbooks to the Ansible Control Node
• Run each playbook on the appropriate targets

The easiest way to copy the playbooks is to use Git:

$ cd /etc/ansible
$ mkdir files
$ git clone https://github.com/changtb/ELK-Project.git        # Clone repository with IaC files
$ cp ELK-Project/ansible/* .                                  # Copy playbooks into /etc/ansible
$ cp ELK-Project/files/* ./files                              # Copy filebeat and metricbeat configurations into /etc/ansible/files

The etc/ansible/files/filebeat-config.yml has Elasticsearch output connecting to our ELK server on 10.1.0.4. If your ELK server IP differs, change it accordingly (line 1105).

Additionally, the Kibana endpoint configuration is set to 10.1.0.4 (line 1805) in etc/ansible/files/filebeat-config.yml. Change this to the IP address of your ELK server.

Again, make the same ELK server IP changes to the etc/ansible/files/metricbeat-config.yml if needed (lines 62 and 95).

Next, create a hosts file to specify which VMs to run each playbook on. Run the commands below after replacing IPs with the private IPs defined in your VMs.:

$ cd /etc/ansible
$ cat > hosts <<EOF
[webservers]
10.0.0.5 ansible_python_interpreter=/usr/bin/python3
10.0.0.6 ansible_python_interpreter=/usr/bin/python3
10.0.0.7 ansible_python_interpreter=/usr/bin/python3

[elk]
10.1.0.4 ansible_python_interpreter=/usr/bin/python3
EOF

Then run the playbooks:

$ cd /etc/ansible
$ ansible-playbook pentest.yml                   # Install Docker and configure VMs with the DVWA web app
$ ansible-playbook install_elk.yml               # Install ELK stack logging tool
$ ansible-playbook install_filebeat.yml
$ ansible-playbook install_metricbeat.yml 

To verify success, wait five minutes to give ELK time to start up. Then, run: curl http://10.1.0.4:5601/app/kibana. This is the address of Kibana. If the installation succeeded, this command should print HTML to the console.