@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.614.0 (2024-07-10)

Bug Fixes

• util-dynamodb: perform global interface check in NativeAttributeBinary union (#6261) (e116b4c)

Features

• client-batch: This feature allows AWS Batch Jobs with EKS container orchestration type to be run as Multi-Node Parallel Jobs. (bda616d)
• client-bedrock-agent-runtime: Introduces query decomposition, enhanced Agents integration with Knowledge bases, session summary generation, and code interpretation (preview) for Claude V3 Sonnet and Haiku models. Also introduces Prompt Flows (preview) to link prompts, foundational models, and resources for end-to-end solutions. (f2f40c1)
• client-bedrock-agent: Introduces new data sources and chunking strategies for Knowledge bases, advanced parsing logic using FMs, session summary generation, and code interpretation (preview) for Claude V3 Sonnet and Haiku models. Also introduces Prompt Flows (preview) to link prompts, foundational models, and resources. (6d701b1)
• client-bedrock-runtime: Add support for contextual grounding check and ApplyGuardrail API for Guardrails for Amazon Bedrock. (8863b77)
• client-bedrock: Add support for contextual grounding check for Guardrails for Amazon Bedrock. (f8cc6bd)
• client-ec2: Add parameters to enable provisioning IPAM BYOIPv4 space at a Local Zone Network Border Group level (d835dbb)
• client-glue: Add recipe step support for recipe node (c9d85d8)
• client-license-manager-linux-subscriptions: Add support for third party subscription providers, starting with RHEL subscriptions through Red Hat Subscription Manager (RHSM). Additionally, add support for tagging subscription provider resources, and detect when an instance has more than one Linux subscription and notify the customer. (e490334)
• client-mediaconnect: AWS Elemental MediaConnect introduces the ability to disable outputs. Disabling an output allows you to keep the output attached to the flow, but stop streaming to the output destination. A disabled output does not incur data transfer costs. (427a732)
• clients: update client endpoints as of 2024-07-10 (3a748e5)