75 lines
2.9 KiB
Plaintext
75 lines
2.9 KiB
Plaintext
[[quick-getting-started]]
|
|
== Getting Started (Short Version)
|
|
|
|
The following tutorial will get you up and running with Shield in 2 minutes.
|
|
|
|
[float]
|
|
=== Assumptions
|
|
|
|
* You have Java(TM) 7 or above installed.
|
|
* You have downloaded elasticsearch 1.5.0+ and extracted it (from now on, we'll refer to the elasticsearch directory as `ES_HOME`).
|
|
If you haven't done so, you can download it https://download.elastic.co/elasticsearch/elasticsearch/elasticsearch-1.5.1.tar.gz[here].
|
|
* You are *not* using a package installation (RPM/DEB) or a custom configuration directory. If you are, please see the full <<getting-started,getting started>> guide.
|
|
|
|
[float]
|
|
=== Installation
|
|
|
|
1. `cd` to `ES_HOME`
|
|
|
|
2. Install the license plugin
|
|
+
|
|
[source,shell]
|
|
----------------------------------------------------------
|
|
bin/plugin -i elasticsearch/license/latest
|
|
----------------------------------------------------------
|
|
|
|
3. Next, install the shield plugin
|
|
+
|
|
[source,shell]
|
|
----------------------------------------------------------
|
|
bin/plugin -i elasticsearch/shield/latest
|
|
----------------------------------------------------------
|
|
|
|
4. Start Elasticsearch
|
|
+
|
|
[source,shell]
|
|
----------------------------------------------------------
|
|
bin/elasticsearch
|
|
----------------------------------------------------------
|
|
|
|
5. Add a `es_admin` user with administrative permissions
|
|
+
|
|
[source,shell]
|
|
----------------------------------------------------------
|
|
bin/shield/esusers useradd es_admin -r admin
|
|
----------------------------------------------------------
|
|
|
|
6. Try it out - without username/password, the request should be rejected:
|
|
+
|
|
[source,shell]
|
|
----------------------------------------------------------
|
|
curl -XGET 'http://localhost:9200/'
|
|
----------------------------------------------------------
|
|
|
|
7. Now try with username and password
|
|
+
|
|
[source,shell]
|
|
----------------------------------------------------------
|
|
curl -u es_admin -XGET 'http://localhost:9200/'
|
|
----------------------------------------------------------
|
|
|
|
8. Optionally, verify the Shield version
|
|
+
|
|
[source,shell]
|
|
----------------------------------------------------------
|
|
curl -u es_admin -XGET 'http://localhost:9200/_shield'
|
|
----------------------------------------------------------
|
|
|
|
[float]
|
|
=== Next Steps
|
|
|
|
* For a more in-depth look into the meaning of each step above, please proceed to the full <<getting-started,getting started>> guide.
|
|
* For better understanding of the authentication mechanisms we just used, please refer to <<esusers, esusers - internal file based authentication>>
|
|
* To learn about how to create roles and customize the permissions for users, please refer to the <<authorization, authorization>> section.
|
|
* To enable secure SSL/TLS encryption of cluster and client communication, please refer to the <<securing-nodes, securing nodes>> section.
|
|
* If you are new to Shield, we suggest following the guide's natural path and reading each section in order. To continue, <<getting-started, proceed to the next section>> |