system-ca
TypeScript icon, indicating that this package has built-in type declarations

1.0.2 • Public • Published

system-ca

Access the system certificate store on Windows, macOS and Linux.

import { systemCertsSync, systemCertsAsync } from 'system-ca';

console.log(systemCertsSync())
console.log(await systemCertsAsync())

tls.connect({
  host: 'google.com',
  port: 443,
  ca: await systemCertsAsync({ includeNodeCertificates: true })
})

The systemCertsSync() and systemCertsAsync() functions perform the same operation, namely, listing all trusted certificates as an array of PEM-formatted X.509 certificates.

The result can be passed directly to the ca option of tls.connect() and similar methods.

  • Using systemCertsAsync() may be preferable, because accessing the system store can be slow, especially on Windows.
  • systemCertsAsync() uses a worker thread under the hood on Windows and macOS.
  • On Windows and macOS, this package always uses native addons for accessing the system certificate store.
  • On all other platforms, both the async and the sync variant read from the typical system locations for storing trusted certificates (i.e. /etc/ssl, /etc/pki).

LICENSE

Apache-2.0

Package Sidebar

Install

npm i system-ca

Weekly Downloads

43,973

Version

1.0.2

License

Apache-2.0

Unpacked Size

32.7 kB

Total Files

13

Last publish

Collaborators

  • orechova
  • himanshusinghs
  • c-buckingham
  • mongo-j
  • mabaasit
  • alexander_schroll
  • chuck.kalmanek
  • mongodb-js-user
  • rueckstiess
  • durran
  • lerouxb
  • fredtruman
  • mbroadst
  • hswolff
  • satyasinha
  • matt_d_rat
  • rhysm
  • tomhollander
  • alena.khineika
  • jeff-allen-mongo
  • mmarcon
  • jonathan.balsano
  • mongodb-build
  • jack.weir
  • stennie
  • mcasimir
  • kristina.stefano
  • jarjee
  • shaketbaby
  • devtoolsbot
  • addaleax
  • gribnoysup
  • mutukrish