November
17th,
2021
我們知道要安裝 Azure DevOps 上私有的 npm 套件需要安裝 vsts-npm-auth 套件，詳細作法可以參考在 VSTS 中建立 npm 套件管理平台這篇文章，但企業內部可能為了資安，使用了 Zscaler 這類型的資安服務，而置換了連線過程的 SSL CA 憑證，所以在安裝 npm 套件時，可能會出現 unable to get local issuer certificate 錯誤，這時候該怎麼辦？
因為網路設備置換了 SSL 的 CA 憑證，因此你在安裝 npm 套件時會出現如下的錯誤畫面：
這裡提供幾種處理方法。
方法一
使用以下指令，關閉 npm 的 SSL 檢查機制：
npm config set strict-ssl false
但這樣做容易有安全上的疑慮，例如連線到惡意網站下載惡意套件，這樣的風險是可以藉由方法二來避免的。
方法二
Zscaler 官方這份文件有提到關於 NPM 要如何處理 CA 憑證的問題，方法如下：
# 下載 CA 憑證，並放在家目錄下
copy "T:\Temp\Poy Chang\Zscaler Cert\ZscalerRootCertificate-2048-SHA256.crt" $env:USERPROFILE
# 設定 npm 的設定檔，<Path to Certificate> 請改成你的 CA 憑證檔案的路徑，也就是上面的儲存路徑
npm config set cafile <Path to Certificate>/ZscalerRootCertificate-2048-SHA256.crt
這裡透過 npm config 中的 cafile 設定，這個設定可以加入多個 CA 根憑證，相關說明文件請參考這裡。
方法三
告訴 npm 我們有另外一個 CA 憑證，請使用這個憑證來處理 SSL 驗證，只需要在環境變數中增加一個 NODE_EXTRA_CA_CERTS 變數，並指定 CA 憑證的位置即可，PowerShell 指令如下：
# 下載 CA 憑證，並放在家目錄下
copy "T:\Temp\Poy Chang\Zscaler Cert\ZscalerRootCertificate-2048-SHA256.crt" $env:USERPROFILE
# 設定環境變數，並指定 CA 憑證的位置
SET NODE_EXTRA_CA_CERTS=$env:USERPROFILE\ZscalerRootCertificate-2048-SHA256.crt
接者檢查系統的環境變數是否有設定好 NODE_EXTRA_CA_CERTS 這個設定值，你可以參考下列 PowerShell 指令：
Get-ChildItem env:NODE_EXTRA_CA_CERTS
查詢結果的畫面如下：
如此一來 npm 在連線到套件網站時，就不會因為憑證無法驗證，造成問題了。
參考資料：