HOW TO：設定組建代理程式以要求 HTTPS 和 Secure Sockets Layer (SSL)

更新：2007 年 11 月

若要設定 SSL 連線的組建代理程式，您必須為每一個 IP 位址和通訊埠組合設定 HTTPS 憑證。如果所有組建代理程式共用建置電腦上的同一個通訊埠，您必須僅設定單一憑證。如果您在多個通訊埠上執行多個組建代理程式，則必須為每一個通訊埠設定憑證。

在為 SSL 連線設定組建代理程式之前，請先確認符合下列必要條件：

您擁有建置電腦上 Windows 系統管理憑證的存取權。
Team Foundation Build 和 Team 總管都已安裝且執行。
已發出組建代理程式的憑證。如需詳細資訊，請參閱逐步解說：設定 Team Foundation Server 以要求 HTTPS 和 Secure Sockets Layer (SSL)。
[Windows 支援工具] 已安裝在建置電腦上。建立憑證與 IP 位址和通訊埠的關聯時，需要這個工具。如需 [Windows 支援工具] 的詳細資訊，請參閱 https://go.microsoft.com/fwlink/?LinkId=93827。

若要將組建代理程式設定為需要 SSL，請依序執行下列工作：

必要的使用權限

您必須是安裝 Team Foundation Build 的電腦上 Administrators 群組的成員，才能完成這項程序。如需詳細資訊，請參閱 Team Foundation Server 使用權限。

使用該電腦上的 Administrators 群組成員之帳戶，登入建置電腦。
在組建電腦上，依序按一下 [開始]、[控制台]、[系統管理工具]，再按一下 [服務]。
在 [服務 (本機)] 窗格中，以滑鼠右鍵按一下 [Visual Studio Team Foundation Build]，然後按一下 [屬性]。

[Visual Studio Team Foundation Build 內容 (本機電腦)] 對話方塊隨即開啟。
按一下 [服務狀態] 下的 [停止]。

使用該電腦上的 Administrators 群組成員之帳戶，登入建置電腦。
開啟 Root:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies，以滑鼠右鍵按一下 TfsBuildservice.config.exe，然後按一下 [開啟]。

檔案會在 Visual Studio 的 XML 編輯器中開啟。
將 RequireSecureChannel 索引鍵 (位於 <appSettings> 區段中) 的值變更為 "true"。

例如，將索引鍵定義變更為下列字串：
```
<add key="RequireSecureChannel" value="true" />
```
儲存您做的變更，然後關閉檔案。

使用該電腦上的 Administrators 群組成員之帳戶，登入建置電腦。

注意事項：
在 Team Foundation Build 服務帳戶的個人存放區或本機電腦的個人存放區中安裝 Visual StudioTeam Foundation Build 服務的憑證。如果您在登入使用者的個人存放區中安裝憑證，Team Foundation Build 將不會執行。

使用 Certificates 嵌入式管理單元，尋找專為用戶端驗證目的提供的 X.509 憑證。

如需詳細資訊，請參閱 https://msdn2.microsoft.com/zh-tw/library/ms734695.aspx (英文)。
將憑證的指模複製到文字編輯器中，例如 [記事本]。
移除十六進位字元之間的所有空格。

您可以使用文字編輯器的 [尋找和取代] 功能，將每個空格取代為 null 字元，藉此移除空格。
在建置電腦上，依序按一下 [開始]、[所有程式]、[Windows 支援工具] 和 [命令提示字元]。
在 SSL 存放區上以 "set" 模式執行 HttpCfg.exe 工具，將憑證繫結至通訊埠號碼。

這個工具會使用指模識別憑證，如以下範例中所示：
```
httpcfg set ssl /i 0.0.0.0:9191 /h ThumbprintWithNoSpaces
```
/i 參數具有 IP-address:port 語法，並且會指示工具將憑證設為建置電腦的通訊埠 9191。為單純起見，IP 位址 0.0.0.0 會保留所有電腦位址。如果您需要其他精確內容，請指定發行代理程式服務的確實 IP 位址。/h 參數會指定憑證的指模。

如果必須交涉用戶端憑證，則加入引數 /f 2，如以下範例中所示：
```
httpcfg set ssl /i 0.0.0.0:9191 /h ThumbprintWithNoSpaces /f 2
```
如需 HttpCfg.exe 命令語法的詳細資訊，請參閱 https://msdn2.microsoft.com/zh-tw/library/ms733791.aspx (英文)。

注意事項：
如果您要使用 Windows Vista 或 Windows Server 2008 作業系統，請使用 netsh.exe 而非 HttpCfg.exe。如需 netsh.exe 的詳細資訊，請參閱 https://support.microsoft.com/kb/242468/zh-tw。

使用該電腦上的 Administrators 群組成員之帳戶，登入建置電腦。
在組建電腦上，依序按一下 [開始]、[控制台]、[系統管理工具]，再按一下 [服務]。
在 [服務 (本機)] 窗格中，以滑鼠右鍵按一下 [Visual Studio Team Foundation Build]，然後按一下 [屬性]。

[Visual Studio Team Foundation Build 內容 (本機電腦)] 對話方塊隨即開啟。
按一下 [服務狀態] 下的 [啟動]。

請參閱