@aws-sdk/signature-v4-crt

What is @aws-sdk/signature-v4-crt?

@aws-sdk/signature-v4-crt is a package that provides AWS Signature Version 4 signing for requests made to AWS services. It is part of the AWS SDK for JavaScript and leverages the AWS Common Runtime (CRT) for enhanced performance and security.

What are @aws-sdk/signature-v4-crt's main functionalities?

Sign HTTP Requests

This feature allows you to sign HTTP requests to AWS services using AWS Signature Version 4. The code sample demonstrates how to sign a GET request to an S3 bucket using the SignatureV4Crt class.

const { SignatureV4Crt } = require('@aws-sdk/signature-v4-crt');
const { HttpRequest } = require('@aws-sdk/protocol-http');
const { defaultProvider } = require('@aws-sdk/credential-provider-node');

const signRequest = async () => {
  const signer = new SignatureV4Crt({
    service: 's3',
    region: 'us-east-1',
    credentials: defaultProvider(),
  });

  const request = new HttpRequest({
    method: 'GET',
    hostname: 'examplebucket.s3.amazonaws.com',
    path: '/exampleobject',
  });

  const signedRequest = await signer.sign(request);
  console.log(signedRequest);
};

signRequest();

Sign WebSocket Requests

This feature allows you to sign WebSocket requests to AWS services using AWS Signature Version 4. The code sample demonstrates how to sign a WebSocket request to an AWS IoT endpoint using the SignatureV4Crt class.

const { SignatureV4Crt } = require('@aws-sdk/signature-v4-crt');
const { WebSocketRequest } = require('@aws-sdk/protocol-websocket');
const { defaultProvider } = require('@aws-sdk/credential-provider-node');

const signWebSocketRequest = async () => {
  const signer = new SignatureV4Crt({
    service: 'iot',
    region: 'us-east-1',
    credentials: defaultProvider(),
  });

  const request = new WebSocketRequest({
    hostname: 'example.iot.us-east-1.amazonaws.com',
    path: '/mqtt',
  });

  const signedRequest = await signer.sign(request);
  console.log(signedRequest);
};

signWebSocketRequest();

Other packages similar to @aws-sdk/signature-v4-crt

@aws-sdk/signature-v4

@aws-sdk/signature-v4 is another package from the AWS SDK for JavaScript that provides AWS Signature Version 4 signing. Unlike @aws-sdk/signature-v4-crt, it does not leverage the AWS Common Runtime (CRT) and may have different performance characteristics.

aws4

aws4 is a lightweight library for signing AWS requests with Signature Version 4. It is not part of the AWS SDK for JavaScript and is often used in environments where a smaller dependency footprint is desired.

README

@aws-sdk/signature-v4

This package contains native modules that only executable in Node.js runtime. Please refer to this issue for more information.

See also https://github.com/aws/aws-sdk-js-v3/tree/main#functionality-requiring-aws-common-runtime-crt.

Changelog

3.495.0 (2024-01-18)

Features

• client-b2bi: Increasing TestMapping inputFileContent file size limit to 5MB and adding file size limit 250KB for TestParsing input file. This release also includes exposing InternalServerException for Tag APIs. (255a7b4)
• client-cloudtrail: This release adds a new API ListInsightsMetricData to retrieve metric data from CloudTrail Insights. (8bd69ca)
• client-connect: GetMetricDataV2 now supports 3 groupings (9f1a143)
• client-drs: Removed invalid and unnecessary default values. (d7c4d31)
• client-firehose: Allow support for Snowflake as a Kinesis Data Firehose delivery destination. (bdf431e)
• client-sagemaker-featurestore-runtime: Increase BatchGetRecord limits from 10 items to 100 items (f12c0b5)
• clients: update client endpoints as of 2024-01-18 (cfe6ad9)
• use bundled dist-cjs build (#5687) (5f79e22)