ELK Stack with Google OAuth
ELK stands for Elasticsearch, Logstash and Kibana. It is being promoted by Elasticsearch as a "devops" logging solution.
This implemenation of an ELK stack is designed to run in AWS EC2 VPC and is secured using Google OAuth 2.0. It consists of one or more instances behind an Elastic Load Balancer (ELB) running the following components:
- Kibana 5.x
- Elasticsearch 5.x
- Logstash 5.x indexer
- Node.js application proxy
Security
Only the Logstash indexer and the application proxy ports are exposed on the ELB and all requests to the application proxy for Kibana or Elasticsearch are authenticated using Google OAuth.
Elasticsearch is configured to listen only on the local loopback address. Dynamic scripting has been disabled to address security concerns with remote code execution since elasticsearch version 1.4.3.
Healthcheck
The ELB requires a healthcheck to ensure instances in the load balancer are healthy. To achieve this, access to the root URL for Elasticsearch is available at the path /__es
and it is not authenticated.
Log Shippers
via TCP
Shipping logs to the ELK stack via tcp is left as an exercise for the user however example configurations are included in the repo under the /examples
directory. TBC
A very simple one that reads from stdin and tails a log file then echoes to stdout and forwards to the ELK stack is below:
$ logstash --debug -e '
input { stdin { } file { path => "/var/log/system.log" } }
output { stdout { } tcp { host => "INSERT-ELB-DNS-NAME-HERE" port => 6379 codec => json_lines } }'
via a Kinesis Stream
Logstash is also setup to ingest logs via a Kinesis Stream using the logstash-input-kinesis plugin.
You can find the Kinesis stream information in the Cloudformation stack output.
The expected input codec is json
.
VPC Configuration
This ELK stack assumes your AWS VPC is configured as per AWS guidelines which is to have a public and private subnet in each availability zone for the region. See Your VPC and Subnets guide for more information.
The easiest way to ensure you have the required VPC setup would be to delete your existing VPC, if possible, and then use the Start VPC Wizard which will create a correctly configured VPC for you.
Installation
-
Go to Google Developer Console and create a new client ID for a web application
You can leave the URLs as they are and update them once the ELK stack has been created. Take note of the Client ID and Client Secret as you will need them in the next step.
-
Enable the "Google+ API" for your new client. This is the only Google API needed.
-
Launch the ELK stack using the AWS console or
aws
command-line tool and enter the required parameters. Note that some parameters, like providing a Route53 Hosted Zone Name to create a DNS alias for the public ELB, are optional. -
Once the ELK stack has launched revisit the Google developer console and update the URLs copying the output for
GoogleOAuthRedirectURL
toAUTHORIZED REDIRECT URI
and the same URL but without to path toAUTHORISED JAVASCRIPT ORIGINS
.
Plugins
The following elasticsearch plugins are installed:
- X-Pack - Elastic extension that bundles security, alerting, monitoring, reporting, and graph.
- EC2 Discovery - uses AWS API for the unicast discovery mechanism.
- S3 Repository - adds support for using S3 as a repository for Snapshot.
Configuration
This ELK stack cloudformation template takes many parameters, explainations for each are shown when launching the stack. Note that Route 53 DNS, EBS volumes and S3 snapshots are optional.
Logstash grok patterns can be tested online at https://grokdebug.herokuapp.com/
The Kibana dashboards are configured via the GUI.
License
Guardian ELK Stack Cloudformation Templates and Logcabin Proxy
Copyright 2014-2016 Guardian News & Media
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.