Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022
この記事では、クロスプラットフォーム CLI (tfx-cli) と Azure DevOps の認証方法について説明します。
Von Bedeutung
認証の主な方法として Microsoft Entra ID 認証 を使用することをお勧めします。 個人用アクセス トークン (AT) は、Microsoft Entra ID 認証を使用できない場合にのみ使用する必要があります。 基本認証は非推奨であり、推奨されません。
[前提条件]
開始する前に、次のことを確認します。
Node.js (最新の LTS バージョンを推奨)
グローバルにインストールされている tfx-cli:
npm install -g tfx-cli
tfx-cli の詳細については、 GitHub の Azure DevOps の Node CLI を参照してください。
認証方法
環境に基づいて適切な認証方法を選択します。
| メソッド | 推奨対象 |
|---|---|
| Microsoft Entra ID | Azure DevOps Services |
| PAT | Azure DevOps Server、自動化スクリプト |
| 基本認証 | Azure DevOps Server のみ |
Microsoft Entra ID 認証 (推奨)
Azure DevOps Services の場合は、最適なセキュリティのために Microsoft Entra ID 認証を使用します。
tfx login
プロンプトが表示されたら、次を実行します。
- サービスの URL (例:
https://dev.azure.com/Your_Organization) を入力します。 - ブラウザー ベースの認証フローに従います。
- ブラウザーでサインイン プロセスを完了します。
Microsoft Entra ID 認証の詳細なガイダンスについては、 Microsoft Entra ベースの認証に関する記事を参照してください。
PAT 認証
Azure DevOps Server など、Microsoft Entra ID 認証を使用できない場合は、PAT を使用します。
PAT を作成して使用する
必要なスコープを持つ PAT を作成します。
PAT を使用してサインインします。
tfx loginメッセージが表示されたら、次を指定します。
- サービス 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
基本認証 (非推奨)
Warnung
基本認証は非推奨であり、推奨されません。 代わりに Microsoft Entra ID を使用してください。 基本認証:
- プレーンテキストで資格情報を送信する
- Git コマンド ライン操作で問題が発生する可能性がある
- セキュリティ上のリスクを引き起こす
基本認証を構成する (Azure DevOps Server のみ)
Azure DevOps Server のインストールで基本認証を使用する必要がある場合:
IIS 基本認証を有効にする:
- サーバー マネージャーを開きます。
- IIS の基本認証機能をインストールします。
- IIS マネージャーで、Azure DevOps Server Web サイトに移動します。
- [機能] ビューで [ 認証 ] をダブルクリックします。
- 基本認証を有効にします。
- ドメインと領域の設定は空のままにします。
基本認証を使用してサインインします。
tfx login --auth-type basicメッセージが表示されたら、次を指定します。
-
サービス URL: オンプレミス のサーバー URL (たとえば、
http://yourserver:8080/tfs/DefaultCollection)。 -
ユーザー名:
domain\username形式を使用する (たとえば、fabrikam\john) - パスワード: ドメイン パスワード。
-
サービス URL: オンプレミス のサーバー URL (たとえば、
ヒント
基本認証を使用する場合は、 SSL を構成 して通信をセキュリティで保護することを検討してください。