cognitect.aws.credentials — com.cognitect.aws/api 0.8.271

Contains credentials providers and helpers for discovering credentials.

Alpha. Subject to change.

auto-refreshing-credentials clj

(auto-refreshing-credentials provider)

(auto-refreshing-credentials provider scheduler)

Create auto-refreshing credentials using the specified provider.

Return a derefable containing the credentials.

Call stop to stop the auto-refreshing process.

The default ScheduledExecutorService uses a ThreadFactory that spawns daemon threads. You can override this by providing your own ScheduledExecutorService.

Alpha. Subject to change.

basic-credentials-provider clj

(basic-credentials-provider {:keys [access-key-id secret-access-key]})

Given a map with :access-key-id and :secret-access-key, returns an implementation of CredentialsProvider which returns those credentials on fetch.

Alpha. Subject to change.

chain-credentials-provider clj

(chain-credentials-provider providers)

Chain together multiple credentials provider.

Calls each provider in order until one return a non-nil result. This provider is then cached for future calls to fetch.

Returns nil if none of the providers return credentials.

Alpha. Subject to change.

container-credentials-provider clj

(container-credentials-provider)

Return credentials from ECS iff one of AWS_CONTAINER_CREDENTIALS_RELATIVE_URI or AWS_CONTAINER_CREDENTIALS_FULL_URI is set.

Alpha. Subject to change.

CredentialsProvider clj protocol

fetch clj

(fetch _)

Return the credentials found by this provider, or nil.

Credentials should be a map with the following keys:

:aws/access-key-id string required :aws/secret-access-key string required :aws/session-token string optional :cognitect.aws.credentials/ttl number optional Time-to-live in seconds

default-credentials-provider clj

(default-credentials-provider)

Return a chain-credentials-provider comprising, in order:

environment-credentials-provider system-property-credentials-provider profile-credentials-provider container-credentials-provider instance-profile-credentials-provider

Alpha. Subject to change.

environment-credentials-provider clj

(environment-credentials-provider)

Return the credentials from the environment variables.

Look at the following variables:

• AWS_ACCESS_KEY_ID required
• AWS_SECRET_ACCESS_KEY required
• AWS_SESSION_TOKEN optional

Returns nil if any of the required variables is blank.

Logs error if one required variable is blank but the other is not.

Alpha. Subject to change.

global-provider clj

instance-profile-credentials-provider clj

(instance-profile-credentials-provider)

For internal use. Do not call directly.

Return credentials from EC2 metadata service iff neither of AWS_CONTAINER_CREDENTIALS_RELATIVE_URI or AWS_CONTAINER_CREDENTIALS_FULL_URI is set.

Alpha. Subject to change.

profile-credentials-provider clj

(profile-credentials-provider)

(profile-credentials-provider profile-name)

(profile-credentials-provider profile-name f)

Return credentials in an AWS configuration profile.

Arguments:

profile-name string The name of the profile in the file. (default: default) f File The profile configuration file. (default: ~/.aws/credentials)

https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html Parsed properties:

aws_access_key required aws_secret_access_key required aws_session_token optional

Alpha. Subject to change.

stop clj

(stop credentials)

Stop auto-refreshing the credentials.

Alpha. Subject to change.

Stoppable clj protocol

-stop clj

(-stop _)

system-property-credentials-provider clj

(system-property-credentials-provider)

Return the credentials from the system properties.

Look at the following properties:

• aws.accessKeyId required
• aws.secretKey required

Returns nil if any of the required properties is blank.

Logs error if one of the required properties is blank but the other is not.

Alpha. Subject to change.