Back to Jose

Function: generateKeyPair()

docs/key/generate_key_pair/functions/generateKeyPair.md

6.2.21.7 KB
Original Source

Function: generateKeyPair()

šŸ’— Help the project

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(alg, options?): Promise<GenerateKeyPairResult>

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]
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'.

Parameters

ParameterTypeDescription
algstringJWA Algorithm Identifier to be used with the generated key pair. See Algorithm Key Requirements.
options?GenerateKeyPairOptionsAdditional options passed down to the key pair generation.

Returns

Promise<GenerateKeyPairResult>

Example

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