Skip to main content
createSecureContext - tls - Node documentation
function createSecureContext

Usage in Deno

import { createSecureContext } from "node:tls";
createSecureContext(options?: SecureContextOptions): SecureContext

[createServer](../.././tls/~/createServer) sets the default value of the honorCipherOrder option to true, other APIs that create secure contexts leave it unset.

[createServer](../.././tls/~/createServer) uses a 128 bit truncated SHA1 hash value generated from process.argv as the default value of the sessionIdContext option, other APIs that create secure contexts have no default value.

The tls.createSecureContext() method creates a SecureContext object. It is usable as an argument to several tls APIs, such as server.addContext(), but has no public methods. The Server constructor and the createServer method do not support the secureContext option.

A key is required for ciphers that use certificates. Either key or pfx can be used to provide it.

If the ca option is not given, then Node.js will default to using Mozilla's publicly trusted list of CAs.

Custom DHE parameters are discouraged in favor of the new dhparam: 'auto' option. When set to 'auto', well-known DHE parameters of sufficient strength will be selected automatically. Otherwise, if necessary, openssl dhparam can be used to create custom parameters. The key length must be greater than or equal to 1024 bits or else an error will be thrown. Although 1024 bits is permissible, use 2048 bits or larger for stronger security.

Parameters

optional
options: SecureContextOptions

Return Type