共用方式為


Azure DevOps 的跨平臺 CLI 驗證

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

本文說明跨平臺 CLI (tfx-cli) 和 Azure DevOps 的驗證方法。

重要

我們建議使用 Microsoft Entra ID 驗證 作為驗證的主要方法。 僅當無法使用 Microsoft Entra ID 驗證時,才應該使用個人存取權杖(PAT)。 基本身份驗證已被取代,不建議使用。

先決條件

開始之前,請確定您有:

  • Node.js (建議使用最新的 LTS 版本)

  • 全域安裝的 tfx-cli

    npm install -g tfx-cli
    

如需 tfx-cli 的詳細資訊,請參閱 GitHub 上的 Azure DevOps 節點 CLI

身份驗證方法

根據您的環境選擇適當的驗證方法:

方法 建議用於
Microsoft Entra ID Azure DevOps Services
PAT Azure DevOps Server, 自動化腳本
基本身份驗證 僅限 Azure DevOps Server

針對 Azure DevOps Services,請使用 Microsoft Entra ID 驗證,以獲得最佳安全性:

tfx login

出現提示時:

  1. 輸入您的服務網址,例如 https://dev.azure.com/Your_Organization
  2. 遵循瀏覽器型驗證流程。
  3. 在瀏覽器中完成登入程式。

如需Microsoft Entra ID 驗證的詳細指引,請參閱 Microsoft Entra 為基礎的驗證

PAT 驗證

當無法使用 Microsoft Entra ID 驗證時,請使用 PAT,例如在 Azure DevOps Server 上。

建立及使用 PAT

  1. 建立 具有必要範圍的 PAT。

  2. 使用 PAT 登入:

    tfx login
    
  3. 出現提示時,請提供:

    • 服務 URL:您的 Azure DevOps 實例 URL。
    • 個人存取令牌:您所建立的 PAT。

範例 URL:

  • Azure DevOps Services: https://dev.azure.com/Your_Organization
  • Azure DevOps Server:https://yourserver/tfs/DefaultCollection
  • Visual Studio Marketplace: https://marketplace.visualstudio.com

範例會話:

~$ tfx login
Copyright Microsoft Corporation

> Service URL: https://dev.azure.com/Your_Organization
> Personal access token: **********************
Logged in successfully

基本身份驗證 (已淘汰)

警告

基本身份驗證已被取代,不建議使用。 請改用Microsoft Entra ID。 基本身份驗證:

  • 以純文本傳送認證
  • 可能會導致 Git 命令行作業發生問題
  • 造成安全性風險

設定基本身份驗證 (僅限 Azure DevOps Server)

如果您在 Azure DevOps Server 安裝中必須使用基本身份驗證:

  1. 啟用 IIS 基本身份驗證:

    • 開啟 [伺服器管理員] 。
    • 安裝 IIS 的基本身份驗證功能。
    • 在 IIS 管理員中,移至您的 Azure DevOps Server 網站。
    • 在 [功能] 檢視中按兩下 [ 驗證 ]。
    • 啟用基本身份驗證。
    • 將網域和領域設定保留空白。
  2. 使用基本身份驗證登入:

    tfx login --auth-type basic
    
  3. 出現提示時,請提供:

    • 服務 URL:您的內部部署伺服器 URL (例如 , http://yourserver:8080/tfs/DefaultCollection)。
    • 使用者名稱:使用 domain\username 格式(例如 fabrikam\john
    • 密碼:您的網域密碼。

小提示

請考慮在使用基本身份驗證時 設定 SSL 以進行安全通訊。

後續步驟