Sdílet prostřednictvím

Použití cross-platformní CLI pro Azure DevOps s využitím osobních přístupových tokenů

  • Článek

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Používejte osobní přístupové tokeny (PAT) s multiplatformovým rozhraním příkazového řádku pro Azure DevOps.

Důležitý

Nedoporučujeme používat základní ověřování ani osobní přístupové tokeny. Místo toho doporučujeme používat ověřování pomocí Microsoft Entra, pokud pracujete s účty Microsoft Entra.

Požadavky

  • Nejnovější verze zdrojového kódu Node.js

  • rozhraní příkazového řádku pro různé platformy pro Azure DevOps

    • Nainstalujte tfx-cli pomocí npm, součásti Node.js spuštěním příkazu:
      npm i -g tfx-cli

    Další informace o tfx-cli najdete v Node CLI pro Azure DevOps na GitHubu.

Osobní přístupový token

Vytvořte osobní přístupový token a vložte ho do příkazu pro přihlášení.

~$ tfx login
Copyright Microsoft Corporation

> Service URL: {url}
> Personal access token: xxxxxxxxxxxx
Logged in successfully

Projděte si následující příklady platných adres URL:

  • https://marketplace.visualstudio.com
  • https://youraccount.visualstudio.com/DefaultCollection

Konfigurace základního ověřování

Varování

Nedoporučujeme základní ověřování. Zapnutí základního ověřování služby IIS způsobuje různé problémy a měli byste místo toho použít tokeny PAT (Personal Access Tokens). Pokud například zapnete základní ověřování služby IIS, příkazový řádek GIT přestane fungovat.

Pokud chcete pro instanci Azure DevOps povolit základní ověřování, postupujte takto:

Varování

Základní ověřování odesílá uživatelská jména a hesla ve formátu prostého textu. Zvažte konfiguraci Azure DevOps Serveru tak, aby při použití základního ověřování používala protokol SSL k povolení zabezpečené komunikace.

  1. Nainstalujte funkci Basic Authentication pro službu IIS ve Správci serveru.

    snímek obrazovky nastavení funkce základního ověřování

  2. Otevřete Správce služby IIS a rozbalte web Azure DevOps Server, poklikejte na dlaždici Authentication v zobrazení funkcí.

  3. V seznamu metod ověřování zvolte Basic Authentication. Zvolte Enable v pravém sloupci. Teď by se měla zobrazit Basic Authentication povolená.

Poznámka

Nechte nastavení domény a sféry pro základní ověřování prázdné.

tfx – přihlášení pomocí základního ověřování

Teď můžete začít používat tfx proti vašemu serveru. Než vydáte příkazy, přihlaste se.

  1. Zadejte následující příkaz:

    tfx login --auth-type basic

  2. Přidejte adresu URL služby.

  3. Přidejte svoje uživatelské jméno. Použijte domain\user (například fabrikam\peter). Pokud pracujete na počítači pracovní skupiny, použijte machinename\user.

  4. Přidejte heslo. Zadejte heslo pro uživatelské jméno, které jste zadali dříve.

Teď můžete použít jakýkoli jiný příkaz tfx.

> tfx login --auth-type basic
Copyright Microsoft Corporation

Enter service url > http://localhost:8080/tfs/defaultcollection
Enter username > fabfiber\peter
Enter password > *******
logged in successfully