次の方法で共有

プロジェクトへの接続のトラブルシューティング

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022

Azure DevOps でプロジェクトへの接続で問題が発生している場合、この記事では、接続と認証に関する一般的な問題を解決するための詳細なトラブルシューティング ガイダンスを提供します。

前提 条件

カテゴリ 必要条件
プロジェクト アクセス プロジェクト メンバー。

迅速な解決手順

接続の問題が発生している場合は、最初に次の簡単な手順を試してください。

  1. ブラウザーを完全にクリアする: https://aka.ms/VsSignoutを使用してサインアウトしてから、すべての Cookie をクリアします (Ctrl+Shift+Delete)。
  2. プライベート ブラウザー セッションを使用する: incognito または InPrivate ウィンドウを開き、アクセスをテストします。
  3. 組織の URL を確認する: 正しい URL 形式 ( https://dev.azure.com/{organizationName}) を使用していることを確認します。
  4. アカウントの種類を確認する: 正しいアカウントの種類 (Microsoft Entra ID と個人用 Microsoft アカウント) でサインインしていることを確認します。

これらの手順で問題が解決しない場合は、次の詳細なトラブルシューティング セクションに進んでください。

認証エラーのトラブルシューティング

Azure DevOps では、認証のために Microsoft Entra アカウントと Microsoft 個人アカウントがサポートされています。 Microsoft Entra ID に接続されている組織には、Microsoft Entra 認証 (メンバーまたは B2B ゲスト アカウント) が必要です。

401 - 承認されていないエラー

Azure DevOps 接続 401 エラーを示すスクリーンショット。

401 承認されていないエラーは、最も一般的なサインインの問題です。 このエラーは、ID に組織または特定のリソースにアクセスするためのアクセス許可がない場合に発生します。 一般的な原因には、次のようなものがあります。

  • ID が組織に追加されない: アカウントが組織のユーザー ディレクトリに一覧表示されません。
  • エイリアスと UPN の混乱: ユーザー プリンシパル名 (UPN) の代わりにエイリアスを使用してサインインしようとしています。
  • プロジェクトのアクセス許可が不十分: ターゲット プロジェクトまたはリソースに対する読み取りアクセス許可がありません。
  • 処理中の B2B ゲスト招待: Microsoft Entra B2B ゲスト招待がまだ受け入れられていません。
  • アカウントの種類の不一致: 複数のアカウントが同じメール アドレスを共有している場合に、間違ったアカウントの種類でサインインしようとしています。

組織に属さない識別子

解決手順:

  1. 組織の [ユーザー ] リストに ID が表示されていることを確認するには、Azure DevOps 管理者に問い合わせてください。
  2. Microsoft Entra アカウントの場合: [ユーザー] リストの ID が Microsoft Entra テナントの UPN と正確に一致していることを確認します。
  3. 個人の Microsoft アカウントの場合: ID がプライマリ アカウントの電子メールと一致であることを確認します。
  4. B2B ゲストの場合: ゲスト テナント内の UPN が、正確な大文字と小文字を含め、ホーム テナントの UPN と一致するかどうかを確認します。

注

B2B ゲストは Microsoft Entra ID に表示され、UPN は {username}_{homeDomain}#EXT#@{guestDomain} として書式設定されます。 {username}_{homeDomain}部分は、ホーム テナントの UPN と一致する必要があります。_を@に置き換えます。

UPN とエイリアスのサインインに関する問題

Azure DevOps では、サインイン エイリアスはサポートされていません。 Microsoft Entra アカウントには正確なユーザー プリンシパル名 (UPN) を、個人の Microsoft アカウントにはプライマリ アカウントを使用する必要があります。

例： UPN が john.doe@contoso.com されているが、エイリアス jdoe@contoso.comがある場合は、 john.doe@contoso.comを使用してサインインする必要があります。

解決： 実際の UPN (john.doe@contoso.com) を組織に追加するよう管理者に依頼し、サインインには常にこの UPN を使用します。

アクセス許可が不十分です

組織にアクセスできるが、特定のプロジェクトまたはリソースに対するアクセス許可がない可能性があります。

症状：

  • https://dev.azure.com/{orgName}にアクセスできますが、https://dev.azure.com/{orgName}/{projectName}にはアクセスできません。
  • 特定の作業項目、リポジトリ、またはパイプラインにアクセスすると、401 エラーが発生します。

解決： Azure DevOps 管理者に問い合わせて、ターゲット リソースに対する 読み取り アクセス許可が少なくとも付与されていることを確認してください。

B2B ゲスト招待の問題

B2B ゲストは、Azure DevOps にアクセスする前に、Microsoft Entra テナントの招待に同意する必要があります。

ゲストの解決手順:

  1. メールで Microsoft Entra への招待を確認します。
  2. 招待リンクを選択し、同意プロセスを完了します。
  3. Azure DevOps へのサインインをもう一度試みます。

テナント管理者の解決手順:

  1. https://portal.azure.com にアクセスします。
  2. Microsoft Entra ID>ユーザーを選択します。
  3. ゲスト ユーザーを見つけて、[ 概要] ページを確認します。
  4. B2B 招待の状態に "承認待ち" と表示される場合は、[ 招待の再送信] を使用します。

アカウントの種類の競合

Microsoft Entra ID に接続されていない組織では、個人の Microsoft アカウントと Microsoft Entra アカウントの両方がサポートされます。 最初に使用するアカウントの種類によって、ID が永続的に確立されます。

解決： アカウントの種類を変更する必要がある場合:

  1. 管理者にあなたを組織から削除し、再追加してもらってください。
  2. メッセージが表示されたら、任意のアカウントの種類でサインインします。

ヒント

個人アカウントと Microsoft Entra アカウントの照合は避けてください。 混乱を防ぐために 、個人用アカウントの名前を変更 することを検討してください。

接続の問題のトラブルシューティング

サインアウトとクリーンアップを完了します。

  1. 完全にサインアウトするには、https://aka.ms/VsSignoutに移動します。
  2. すべてのブラウザー データをクリアする: Ctrl+Shift+Delete を選択して削除します。
    • Cookie とサイト データ。
    • キャッシュされたイメージとファイル。
    • フォーム データのオートフィル。
  3. Microsoft Edge データをクリアする: Visual Studio IDE では Microsoft Edge Cookie が使用されるため、別のブラウザーを使用している場合でも Microsoft Edge データをクリアします。
  4. すべてのアプリケーションを閉じる: すべてのブラウザーと Visual Studio IDE インスタンスを終了します。
  5. プライベート ブラウズを使用してテストする: incognito ウィンドウまたは InPrivate ウィンドウを使用してアクセスをテストします。

Visual Studio IDE の接続に関する問題

Visual Studio 内で接続の問題が発生している場合:

  1. 既存の接続を削除する: チーム エクスプローラーで、すべての Azure DevOps 接続を削除します。
  2. 資格情報キャッシュをクリアする: Windows 資格情報マネージャーからキャッシュされた資格情報を削除します。
  3. Visual Studio を再起動する: Visual Studio を完全に閉じて再度開きます。
  4. 読み取られた接続: 現在の資格情報を使用して、Azure DevOps 接続をもう一度追加します。

ネットワークとプロキシの問題

企業ネットワークのトラブルシューティング:

  1. 別のネットワークからテストする: 個人用デバイス/ネットワークから Azure DevOps にアクセスしてみてください。
  2. プロキシ設定を確認する: 企業プロキシで *.visualstudio.com ドメインと *.azure.com ドメインが許可されていることを確認します。
  3. ファイアウォールの構成: ファイアウォールで Azure DevOps エンドポイントへの HTTPS トラフィックが許可されていることを確認します。
  4. VPN 干渉: 該当する場合は、VPN を無効にしてテストします。

高度なトラブルシューティング

先進認証の移行

従来の認証方法を使用している場合は、最新の代替手段への移行を検討してください。

サービス接続認証

認証の問題が発生している Azure DevOps サービス接続の場合:

  1. サービス プリンシパル シークレットの更新: 期限切れのクライアント シークレットまたは証明書を更新します。
  2. アクセス許可を確認する: サービス プリンシパルに適切な Azure DevOps アクセス許可があることを確認します。
  3. トークンの有効期限を確認する: 認証トークンの有効期限が切れていないことを検証します。
  4. 監査ログを確認する: Microsoft Entra 監査ログで認証エラーを確認します。

AI を使用して接続の問題のトラブルシューティングを行う

次の例では、Copilot Chat のプロンプトを使用して、接続と認証エラーのトラブルシューティングを行います。 このプロンプトをコピーして Copilot Chat に貼り付け、プレースホルダーを特定のエラー メッセージまたは問題の説明に置き換えます。

I'm getting this Azure DevOps connection/authentication error: [PASTE YOUR ERROR MESSAGE HERE]

Can you help me troubleshoot this issue? Please provide step-by-step instructions to:
1. Identify the root cause of the connection problem
2. Fix the authentication or access issue
3. Verify I can successfully connect to my Azure DevOps project

Context: This is for connecting to an Azure DevOps organization and project. I've already tried basic troubleshooting like clearing browser cache and using a private browser session.

Copilot では AI を利用しているため、想定外のことや間違いが起こる可能性があります。 詳細については、「Copilot の一般的な使用に関する FAQ」を参照してください。

その他のヘルプを表示する

すべてのトラブルシューティング手順を完了しても接続できない場合:

  1. 診断情報の収集: 失敗したサインイン試行の ブラウザー トレース を作成します。
  2. Microsoft サポートに問い合わせる: サポート リクエストを作成 し、次の内容を含めます。
    • 問題の詳細な説明。
    • 既に試行した手順。
    • ブラウザー トレース ファイル。
    • エラー メッセージのスクリーンショット。
  3. コミュニティ サポート: Azure DevOps Developer Community で質問を検索または投稿します。

関連コンテンツ

  • Last updated on