Skip to content

rdeak/jwe

Repository files navigation

JWE

npm version License: MIT

This repo exposes functions for encrypting JSON payloads, and decrypting JWE tokens into JSON from Node.js.

By default, dir algorithm is used for encryption of CEK, and A128GCM for encryption of a payload.

Underhood it uses jose library.

Installation

npm install @rdeak/jwe

or

npm install https://github.com/rdeak/jwe

Usage

import { encrypt, decrypt } from "@rdeak/jwe";

const jwe = JWE("0123456789123456");

const jweToken = await jwe.encrypt({ name: "John Doe" });
console.log("JWE:", jweToken);

const payload = await jwe.decrypt(jweToken);
console.table(payload);

API Documentation

JWE

Create handler for encrypting and decrypting JWE tokens.

Parameters

Name Type
secret string
options Options
type Options = {
  /***
   * cryptographic algorithm used to encrypt CEK
   */
  alg?: string;
  /***
   * cryptographic algorithm used to encrypt payload
   */
  enc?: string;
  /***
   * default content is converted to JSON
   */
  transform?: Transform<PAYLOAD>;
  /***
   * @deprecated https://www.rfc-editor.org/rfc/rfc8725#name-avoid-compression-of-encryp
   */
  compression?: Compression;
};

encrypt

encrypt(payload): Promise<string>

Encrypts and resolves the value of the Compact JWE string.

Parameters

Name Type
payload Record<string, unknown>

Returns

Promise<string>

decrypt

decrypt("jwe token....", "0123456789123456");

decrypt(jweToken): Promise<string>

Decrypts a Compact JWE into object.

Parameters

Name Type
jweToken string

Returns

Promise<Record<string, unknown>>

License

This project is licensed under the terms of the MIT license.