Open Distro For Elasticsearch Security Parent

Open Distro for Elasticsearch Security Parent is the parent repo for the Open Distro for Elasticsearch security plugin repositories, including:

Security

Security-SSL

Security Advanced Modules

Security Kibana Plugin

Documentation

Please refer to the technical documentation for detailed information.

Requirements

Make sure you are in the elasticsearch/linux_distributions folder. Here are the instructions for installing Java (OpenJDK 11) for Debian based distributions.

sudo add-apt-repository ppa:openjdk-r/ppa
sudo apt-get update
sudo apt install openjdk-11-jdk

Build

To build the security plugin from source follow these instructions in this order:

1. Download the security-parent source code:

git clone https://github.com/opendistro-for-elasticsearch/security-parent.git

2. Install to the local repository folder named .m2:

cd security-parent
mvn clean install
cd ..

3. Download the security-ssl source code:

(Note: This step is needed only for the security plug-in for Open Distro version 0.10.0 supporting Elasticsearch 6.8.1 and below.)

git clone https://github.com/opendistro-for-elasticsearch/security-ssl.git

4. Install to the local repository folder named .m2:

cd security-ssl
mvn clean install
cd ..

5. Download the security source code:

git clone https://github.com/opendistro-for-elasticsearch/security.git

6. Install to the local repository folder named .m2:

cd security
mvn clean install
cd ..

7. Download the security-advanced-modules source code:

git clone https://github.com/opendistro-for-elasticsearch/security-advanced-modules.git

8. Install to the local repository folder named .m2:

cd security-advanced-modules
mvn clean install
cd ..

9. Build the Elasticsearch plugin and install final artifacts:

cd security
mvn clean package -Padvanced

The above builds the final artifacts in zip format.

cd target/releases/

The artifacts can be found in the folder listed above.

10. Detailed instructions on how to build the security-kibana plugin can be found here:

https://github.com/opendistro-for-elasticsearch/security-kibana-plugin/blob/master/README.md#build

Install

Install the plugin to your Elasticsearch cluster with the following commands:

cd elasticsearch/bin
./elasticsearch-plugin install file:///path/to/security/target/releases/opendistro_security-<version>.zip

License

This code is licensed under the Apache 2.0 License.

Copyright

Open Distro For Elasticsearch Security Copyright 2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.