HADOOP-16930. Add hadoop-aws documentation for ProfileCredentialsProvider
Contributed by Nicholas Chammas.
This commit is contained in:
parent
d353b30baf
commit
25a03bfece
|
@ -400,6 +400,31 @@ for credentials to access S3. Within the AWS SDK, this functionality is
|
|||
provided by `InstanceProfileCredentialsProvider`, which internally enforces a
|
||||
singleton instance in order to prevent throttling problem.
|
||||
|
||||
### <a name="auth_named_profile"></a> Using Named Profile Credentials with `ProfileCredentialsProvider`
|
||||
|
||||
You can configure Hadoop to authenticate to AWS using a [named profile](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html).
|
||||
|
||||
To authenticate with a named profile:
|
||||
|
||||
1. Declare `com.amazonaws.auth.profile.ProfileCredentialsProvider` as the provider.
|
||||
1. Set your profile via the `AWS_PROFILE` environment variable.
|
||||
1. Due to a [bug in version 1 of the AWS Java SDK](https://github.com/aws/aws-sdk-java/issues/803),
|
||||
you'll need to remove the `profile` prefix from the AWS configuration section heading.
|
||||
|
||||
Here's an example of what your AWS configuration files should look like:
|
||||
|
||||
```
|
||||
$ cat ~/.aws/config
|
||||
[user1]
|
||||
region = us-east-1
|
||||
$ cat ~/.aws/credentials
|
||||
[user1]
|
||||
aws_access_key_id = ...
|
||||
aws_secret_access_key = ...
|
||||
aws_session_token = ...
|
||||
aws_security_token = ...
|
||||
```
|
||||
|
||||
### <a name="auth_session"></a> Using Session Credentials with `TemporaryAWSCredentialsProvider`
|
||||
|
||||
[Temporary Security Credentials](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)
|
||||
|
|
Loading…
Reference in New Issue