Struct aws_types::credentials::Credentials

pub struct Credentials(_);

AWS SDK Credentials

An opaque struct representing credentials that may be used in an AWS SDK, modeled on the CRT credentials implementation.

When Credentials is dropped, its contents are zeroed in memory. Credentials uses an interior Arc to ensure that even when cloned, credentials don’t exist in multiple memory locations.

Implementations

impl Credentials

pub fn new(
    access_key_id: impl Into<String>,
    secret_access_key: impl Into<String>,
    session_token: Option<String>,
    expires_after: Option<SystemTime>,
    provider_name: &'static str
) -> Self

Creates Credentials.

This is intended to be used from a custom credentials provider implementation. It is NOT secure to hardcode credentials into your application.

pub fn from_keys(
    access_key_id: impl Into<String>,
    secret_access_key: impl Into<String>,
    session_token: Option<String>
) -> Self

Creates Credentials from hardcoded access key, secret key, and session token.

Note: In general, you should prefer to use the credential providers that come with the AWS SDK to get credentials. It is NOT secure to hardcode credentials into your application. If you’re writing a custom credentials provider, then use Credentials::new instead of this.

This function requires the hardcoded-credentials feature to be enabled.

Credentials implement ProvideCredentials directly, so no custom provider implementation is required when wiring these up to a client:

use aws_types::Credentials;
use aws_types::region::Region;

let creds = Credentials::from_keys("akid", "secret_key", None);
let config = Config::builder()
    .credentials_provider(creds)
    .region(Region::new("us-east-1"))
    .build();
let client = Client::from_conf(config);

pub fn access_key_id(&self) -> &str

Returns the access key ID.

pub fn secret_access_key(&self) -> &str

Returns the secret access key.

pub fn expiry(&self) -> Option<SystemTime>

Returns the time when the credentials will expire.

pub fn expiry_mut(&mut self) -> &mut Option<SystemTime>

Returns a mutable reference to the time when the credentials will expire.

pub fn session_token(&self) -> Option<&str>

Returns the session token.

Trait Implementations

impl Clone for Credentials

fn clone(&self) -> Credentials

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Credentials

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq<Credentials> for Credentials

fn eq(&self, other: &Credentials) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl ProvideCredentials for Credentials

fn provide_credentials<'a>(&'a self) -> ProvideCredentials<'a> where
    Self: 'a,

Returns a future that provides credentials.

impl Eq for Credentials

impl StructuralEq for Credentials

impl StructuralPartialEq for Credentials