Skip to content

Latest commit

 

History

History
42 lines (28 loc) · 1.94 KB

generateKeyPair.md

File metadata and controls

42 lines (28 loc) · 1.94 KB

Function: generateKeyPair()

Support from the community to continue maintaining and improving this module is welcome. If you find the module useful, please consider supporting the project by becoming a sponsor.

generateKeyPair<KeyLikeType>(alg, options?): Promise<GenerateKeyPairResult<KeyLikeType>>

Generates a private and a public key for a given JWA algorithm identifier. This can only generate asymmetric key pairs. For symmetric secrets use the generateSecret function.

Note: Under Web Crypto API runtime the privateKey is generated with extractable set to false by default. See GenerateKeyPairOptions.extractable to generate an extractable privateKey.

This function is exported (as a named export) from the main 'jose' module entry point as well as from its subpath export 'jose/generate/keypair'.

Type Parameters

Type Parameter Default type
KeyLikeType extends KeyLike KeyLike

Parameters

Parameter Type Description
alg string JWA Algorithm Identifier to be used with the generated key pair.
options? GenerateKeyPairOptions Additional options passed down to the key pair generation.

Returns

Promise<GenerateKeyPairResult<KeyLikeType>>

Example

const { publicKey, privateKey } = await jose.generateKeyPair('PS256')
console.log(publicKey)
console.log(privateKey)