From 7af13165bf2cfa2de174f931e0cf78b687c03d9c Mon Sep 17 00:00:00 2001
From: Phil Wills <otherphil@gmail.com>
Date: Fri, 30 May 2014 12:51:37 +0100
Subject: [PATCH] Elaborate on how to specify AWS credentials

Closes #85.
---
 README.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 491203e466b..2b1bd9e6ffb 100644
--- a/README.md
+++ b/README.md
@@ -23,8 +23,10 @@ Please read documentation relative to the version you are using:
 
 ## Generic Configuration
 
-The plugin will automatically use the instance level security credentials (as of 1.7.0), but they can be provided explicitly using `cloud.aws.access_key` and `cloud.aws.secret_key`:
-
+The plugin will default to using [IAM Role](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html) credentials 
+for authentication. These can be overridden by, in increasing order of precedence, system properties `aws.accessKeyId` and `aws.secretKey`, 
+environment variables `AWS_ACCESS_KEY_ID` and `AWS_SECRET_KEY`, or the elasticsearch config using `cloud.aws.access_key` and `cloud.aws.secret_key`:
+ 
 ```
 cloud:
     aws: