Skip to content

aws/aws-sdk-js-crypto-helpers

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Aug 2, 2024
fffa3e1 · Aug 2, 2024
Aug 2, 2024
Jul 13, 2023
Jul 24, 2024
Sep 16, 2021
Jul 12, 2021
Jul 5, 2023
Jan 16, 2020
Oct 16, 2023
Jan 16, 2020
Jan 16, 2020
Sep 20, 2018
Sep 20, 2018
Jul 6, 2023
Jul 12, 2023
Oct 16, 2023
Jul 24, 2024
Jul 24, 2024
Sep 16, 2021

Repository files navigation

AWS SDK JS Crypto Helpers

AWS Cryptographic Helpers for Javascript and Node.js

Security issue notifications

Scope

This repository collects cryptographic helper packages. We have designed it to gather packages that implement simple primitives for the browser or Node.js. More information about AWS Crypto Tools can be found here

Project Status

This project is still in its early stages. Please send us your feedback. We might make breaking changes in future releases while the SDK is still in developer preview.

Getting started

Let’s walk through setting up a project that requires a cryptographically secure random value. The following steps use npm as an example. They assume you have node.js and npm already installed.

  1. Create a new node.js project.
  2. In the project, run: npm install --save @aws-crypto/random-source-node@preview
  3. Create a new file called index.js, require the function, and then use it to get a random value.
const { randomValues } = require("@aws-crypto/random-source-node");
async function example() {
  try {
    const rand = await randomValues(32);
    console.log(rand.length);
  } catch (err) {
    console.error(err);
  }
}
example();

Crypto Helper Package Index

Each package has readme details.

Testing

To run the tests in every package.

npm install
npm test

Feedback

We welcome your feedback! If you have comments, questions, or suggestions, open a GitHub issue. We are actively monitoring issues and will respond to feedback as we prepare for our GA launch.

Contributing

We welcome your contributions! To fix a problem, or add to an existing package: create a pull request. You must submit all pull requests under the Apache 2.0 license. They will be reviewed by a team member prior to merging. We would appreciate, but do not require, unit tests for all significant contributions. See Contributing for more information.

License

This library is licensed under the Apache 2.0 License.