@aws-sdk/credential-provider-http

What is @aws-sdk/credential-provider-http?

The @aws-sdk/credential-provider-http package is designed to retrieve AWS credentials from a remote endpoint, such as the Amazon EC2 Instance Metadata Service (IMDS) or a custom HTTP endpoint. It is part of the AWS SDK for JavaScript (v3), which is a modular collection of software for interacting with AWS services. This package is particularly useful for applications running on AWS infrastructure that need to securely obtain temporary credentials without hardcoding them.

What are @aws-sdk/credential-provider-http's main functionalities?

Retrieving credentials from EC2 Instance Metadata Service (IMDS)

This feature allows applications running on an Amazon EC2 instance to automatically retrieve temporary AWS credentials. The credentials are provided by the EC2 Instance Metadata Service without requiring manual credential management.

const { fromInstanceMetadata } = require('@aws-sdk/credential-provider-http');

const credentials = fromInstanceMetadata();

Retrieving credentials from a custom HTTP endpoint

This feature enables the retrieval of AWS credentials from a custom HTTP endpoint. It is useful for scenarios where credentials are centrally managed and distributed via an internal HTTP service.

const { fromHttp } = require('@aws-sdk/credential-provider-http');

const credentials = fromHttp({
  url: 'http://my-custom-credential-provider/',
  requestOptions: { // Optional HTTP request options
    method: 'GET'
  }
});

Other packages similar to @aws-sdk/credential-provider-http

@aws-sdk/credential-provider-ini

Similar to @aws-sdk/credential-provider-http, this package is used to load AWS credentials. However, it loads credentials from local INI-formatted files (e.g., ~/.aws/credentials). It's useful for development environments but less suited for production environments compared to @aws-sdk/credential-provider-http, which can dynamically fetch credentials.

@aws-sdk/credential-provider-imds

This package specifically targets the retrieval of AWS credentials from the EC2 Instance Metadata Service (IMDS). It offers functionality similar to one aspect of @aws-sdk/credential-provider-http but is exclusively focused on EC2 instances. The @aws-sdk/credential-provider-http package is more versatile as it also supports custom HTTP endpoints.

@aws-sdk/credential-provider-env

This package retrieves AWS credentials set in environment variables. It's a simpler approach compared to @aws-sdk/credential-provider-http, suitable for scenarios where credentials are statically defined in the environment. However, it lacks the dynamic credential retrieval capabilities of @aws-sdk/credential-provider-http.

README

@aws-sdk/credential-provider-http

An internal transitively required package.

Usage

See https://www.npmjs.com/package/@aws-sdk/credential-providers

Changelog

3.620.0 (2024-07-25)

Bug Fixes

• eventstream-handler-node: start streaming without waiting for response (#6311) (0072f42)

Features

• client-application-auto-scaling: Application Auto Scaling is now more responsive to the changes in demand of your SageMaker Inference endpoints. To get started, create or update a Target Tracking policy based on High Resolution CloudWatch metrics. (961af9b)
• client-application-signals: CloudWatch Application Signals now supports application logs correlation with traces and operational health metrics of applications running on EC2 instances. Users can view the most relevant telemetry to troubleshoot application health anomalies such as spikes in latency, errors, and availability. (ef30775)
• client-bedrock-runtime: Provides ServiceUnavailableException error message (690bc7f)
• client-codecommit: CreateRepository API now throws OperationNotAllowedException when the account has been restricted from creating a repository. (9195ee7)
• client-datazone: Introduces GetEnvironmentCredentials operation to SDK (2156a87)
• client-ec2: EC2 Fleet now supports using custom identifiers to reference Amazon Machine Images (AMI) in launch requests that are configured to choose from a diversified list of instance types. (88cbe69)
• client-ecr: API and documentation updates for Amazon ECR, adding support for creating, updating, describing and deleting ECR Repository Creation Template. (83e5411)
• client-eks: This release adds support for EKS cluster to manage extended support. (45cb022)
• client-elastic-load-balancing-v2: This release adds support for sharing trust stores across accounts and organizations through integration with AWS Resource Access Manager. (4a753d9)
• client-network-firewall: You can now log events that are related to TLS inspection, in addition to the existing alert and flow logging. (ab0e00e)
• client-outposts: Adding default vCPU information to GetOutpostSupportedInstanceTypes and GetOutpostInstanceTypes responses (2e67698)
• client-sfn: This release adds support to customer managed KMS key encryption in AWS Step Functions. (895cc68)