Merge branch 'vscode'

README.md

@@ -148,6 +148,19 @@ For other Node.js versions
 speciall fallback utility is called
 in the background to fetch the list anyway.
 
+## VSCode extension
+
+Special [extension](vscode) for [VSCode][]
+was created to import `win-ca`
+in context of VSCode's Extension Host.
+
+Since all VSCode extensions share the same process,
+root certificates imported by one of them
+are immediately available to others.
+This can allow VSCode to connect to
+(properly configured)
+intranet sites from Windows machines.
+
 ## Building
 
 - npm install
@@ -178,3 +191,4 @@ See also [OpenSSL::Win::Root][].
 [nvm$]: https://github.com/ukoloff/nvms
 [N-API]: https://nodejs.org/api/n-api.html
 [N-API-support]: https://github.com/nodejs/node-addon-api/blob/master/index.js#L17
+[VSCode]: https://code.visualstudio.com/

vscode/README.md

@@ -0,0 +1,44 @@
+# win-ca @VSCode
+
+Make Trusted Root Certificates @Windows available to VSCode extensions
+
+## Abstract
+
+This is minimal possible VSCode Extension.
+It's only purpose is to run [win-ca][] package,
+so all Trusted Root Certificates becomes
+available to other VSCode extensions.
+
+This extensions may appear usable when all three conditions are met:
+
+1. You run VSCode on Microsoft Windows
+
+2. You trust some non-standard (not [Mozilla][]) root certificates
+(in most cases - your Enterprise Trust)
+
+3. You use some other VSCode extensions that connects to some server
+that uses certificate, signed by root from 2.
+
+In other words,
+you can connect to
+(most likely) intranet site
+with Internet Explorer or Chrome,
+but VSCode fails to connect to it.
+
+In this case you can install this extension.
+It fetches list of Windows'
+*Trusted Root Certification Authorities*
+and make those certitficates available
+to other VSCode extensions as `https.globalAgent.options.ca`.
+
+In some cases this helps.
+
+## Installation
+
+Install from [here][ukoloff.win-ca] or open VS Code,
+hit `Ctrl+Shift+X` (Extensions pane),
+search for `win-ca` and press `Install`.
+
+[win-ca]: https://ukoloff@github.com/ukoloff/win-ca
+[Mozilla]: https://wiki.mozilla.org/CA/Included_Certificates
+[ukoloff.win-ca]: https://marketplace.visualstudio.com/items?itemName=ukoloff.win-ca

vscode/index.js

@@ -0,0 +1,6 @@
+require('win-ca')
+
+exports.activate = activate
+
+function activate() {
+}

vscode/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "win-ca",
+  "private": true,
+  "version": "2.1.0",
+  "description": "Make Trusted Root Certificates @Windows available to VSCode extensions",
+  "main": "index.js",
+  "engines": {
+    "vscode": "^1.0.0"
+  },
+  "publisher": "ukoloff",
+  "repository": {
+    "type": "git",
+    "url": "git+https://ukoloff@github.com/ukoloff/win-ca.git"
+  },
+  "activationEvents": [
+    "*"
+  ],
+  "scripts": {},
+  "keywords": [
+    "vscode",
+    "ssl",
+    "ca",
+    "root",
+    "windows"
+  ],
+  "author": {
+    "name": "Stas Ukolov",
+    "email": "ukoloff@gmail.com"
+  },
+  "license": "ISC",
+  "dependencies": {
+    "win-ca": "^2.1.0"
+  }
+}