網站 TLS 憑證 CLI 檢視工具 PowerShell 版 ft. Github Copilot Labs

昨天寫好的網站 TLS 憑證 CLI 快速檢視工具只算是原型機，在工作環境 EXE 檔使用前需先部署，易有病毒木馬疑慮，應用阻力較大。相形之下，腳本形式的 PowerShell 傳送方便(可以貼在 Word 或 Email 裡)，程式為明文可直接審閱，從管理稽查角度較易接受，是更可行的方案。因此 PowerShell 版才是最終量產的實用版本，但我通常會先用熟悉順手的 C# 完成雛型再轉 PowerShell 版，事半功倍。

Github Copilot Labs 包含程式語言翻譯功能(Language Translation)，這回 C# 轉 PowerShell 的任務就交給它，實測一下效果。

選取程式碼後，點左側的飛行員圖示[1]，找到 Language Translation，程式碼會自動帶入[2]，從下拉選單選取要轉換成的程式語言 PowerShell [3]，按下【Ask Copilot】就能開始轉換：

翻譯結果會顯示在下方視窗：

PowerShell 不算熱門語言，訓練資料量不比 Python、JavaScript，翻譯品質略差在預期內，以下是原始翻譯結果。

$hostPort = $args[0];
 #
if (!$hostPort.Contains(":")) {
 #
    $hostPort+=":443";
 #
} #
$p = Start-Process "openssl" -ArgumentList "s_client -showcerts -connect $hostPort" -PassThru -NoNewWindow -Wait -RedirectStandardOutput $true -RedirectStandardInput $true -RedirectStandardError $true;
 #
$p.StandardInput.WriteLine("Q"); #按Q+Enter結束openssl
 #
$output = $p.StandardOutput.ReadToEnd();
 #
$p.WaitForExit();
 #
$highlightCN = {param($s)
 #
    $m = [Regex]::Match($s, '^CN=[^,]+');
 #
    if (!$m.Success) {return $s;}
 #
    return "$([char]0x1b)[33;1m" + $m.Value + "$([char]0x1b)[0m" + $s.Substring($m.Value.Length);
 #
};
 #
foreach ($certB64 in [Regex]::Matches($output, "(?ims)-----BEGIN CERTIFICATE-----(?<c>.+?)-----END CERTIFICATE-----"))
 #
{
 #
    $pem = $certB64.Groups["c"].Value.Replace("`r", "").Replace("`n", "");
 #
    $cert = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2([Convert]::FromBase64String($pem));
 #
    Write-Host "$([char]0x1b)[36m$([char]0x1b)[0m" -NoNewline;
 #
    Write-Host "$([char]0x1b)[36m$([char]0x1b)[0m".PadRight(64,"=");
 #
    Write-Host "發給: $($highlightCN.Invoke($cert.Subject))";
 #
    Write-Host "簽發者: $($highlightCN.Invoke($cert.Issuer))";
 #
    Write-Host "有效期自 $([char]0x1b)[33m$($cert.NotBefore.ToString("yyyy-MM-dd HH:mm:ss"))$([char]0x1b)[0m 到 $([char]0x1b)[33m$($cert.NotAfter.ToString("yyyy-MM-dd HH:mm:ss"))$([char]0x1b)[0m";
 #
    Write-Host "憑證指紋: $([char]0x1b)[33;3m$($cert.Thumbprint)$([char]0x1b)[0m";
 #
    Write-Host "";
 #
} #

Copilot 翻譯的版本有幾個問題：

1. args[0] 被硬翻成 $arg[0]，對應 PowerShell 應宣告 Param([string]$hostPort) 才順
2. Start-Process 雖有 -RedirectStandardInput、-RedirectStandardOutput 等參數，但須事先將輸入內容寫成檔案及從輸出檔案讀取結果，後面的 $p.StandardInput.WriteLine("Q")、$p.StandardOutput.ReadToEnd() 屬無效寫法。 我想維持資料不落地，仍得依賴 System.Diagnostics.Process。參考
3. New-Object System.Security.Cryptography.X509Certificates.X509Certificate2([Convert]::FromBase64String($pem)) 寫法傳入 byte[] 當建構式參數，byte[1200] 會被當成傳入 1200 個 byte 型別參數，正確做法是寫成 @(,$certBinary) 強制當成單一 byte[] 型別參數；或是改用 PS5 支援的 ::new 寫法 [System.Security.Cryptography.X509Certificates.X509Certificate2]::new($certBinary) 參考

微調後的版本如下：

param (
    [string]$hostPort
)
$ErrorActionPreference = "Stop"
if (!$hostPort) { $hostPort = 'www.google.com' }
if (!$hostPort.Contains(":")) {
    $hostPort+=":443";
} 
$p = New-Object System.Diagnostics.Process
$p.StartInfo.FileName = "openssl.exe"
$p.StartInfo.Arguments = "s_client -showcerts -connect $hostPort"
$p.StartInfo.UseShellExecute = $false
$p.StartInfo.RedirectStandardOutput = $true
$p.StartInfo.RedirectStandardInput = $true
$p.StartInfo.RedirectStandardError = $true
$p.Start() | Out-Null
$p.StandardInput.WriteLine("Q") #按Q+Enter結束openssl
$output = $p.StandardOutput.ReadToEnd();
$p.WaitForExit();
$highlightCN = {param($s)
    $m = [Regex]::Match($s, '^CN=[^,]+');
    if (!$m.Success) {return $s;}
    return "$([char]0x1b)[33;1m" + $m.Value + "$([char]0x1b)[0m" + $s.Substring($m.Value.Length);
};
foreach ($certB64 in [Regex]::Matches($output, "(?ims)-----BEGIN CERTIFICATE-----(?<c>.+?)-----END CERTIFICATE-----"))
{
    $pem = $certB64.Groups["c"].Value.Replace("`r", "").Replace("`n", "");
    $cert = [System.Security.Cryptography.X509Certificates.X509Certificate2]::new([Convert]::FromBase64String($pem))
    Write-Host "$([char]0x1b)[36m$([char]0x1b)[0m" -NoNewline;
    Write-Host "$([char]0x1b)[36m$([char]0x1b)[0m".PadRight(64,"=");
    Write-Host "發給: $($highlightCN.Invoke($cert.Subject))";
    Write-Host "簽發者: $($highlightCN.Invoke($cert.Issuer))";
    Write-Host "有效期自 $([char]0x1b)[33m$($cert.NotBefore.ToString("yyyy-MM-dd HH:mm:ss"))$([char]0x1b)[0m 到 $([char]0x1b)[33m$($cert.NotAfter.ToString("yyyy-MM-dd HH:mm:ss"))$([char]0x1b)[0m";
    Write-Host "憑證指紋: $([char]0x1b)[33;3m$($cert.Thumbprint)$([char]0x1b)[0m";
    Write-Host "";
}

使用 git diff -U0 ./show-cert.ps1 統計所有修改的行數並不多(忽略無效 # 註解)，而該解該查的問題純手刻也得花時間查，算算省下蠻多時間。

但我覺得使用 AI 輔助開發，仍需具備識別及驗證結果正確優劣的基本能力，才能充分發揮其威力，用到開心盡興。AI 生成結果不可能 100% 沒有錯誤，若缺乏基本知識背景抓不出問題，連為什麼能動跟為什麼不能動都沒頭緒，只會得到滿滿的挫折吧!

原本就會寫 PowerShell 用 Github Copilot 翻譯 C# 程式，基本上會用得很開心，輕鬆搞定。

Experience of using Github Copilot Labs to translate C# to PowerShell.