Rozwiązywanie problemów z nawiązywaniem połączenia z projektem

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

Jeśli występują problemy z nawiązywaniem połączenia z projektem w usłudze Azure DevOps, ten artykuł zawiera szczegółowe wskazówki dotyczące rozwiązywania problemów w celu rozwiązania typowych problemów z łącznością i uwierzytelnianiem.

Warunki wstępne

Szybkie kroki rozwiązywania problemów

Jeśli występują problemy z połączeniem, najpierw spróbuj wykonać następujące szybkie kroki:

1. Wyczyść przeglądarkę całkowicie: wyloguj się przy użyciu polecenia https://aka.ms/VsSignout, a następnie wyczyść wszystkie pliki cookie (Ctrl+Shift+Delete).
2. Użyj prywatnej sesji przeglądarki: otwórz okno incognito lub InPrivate i przetestuj dostęp.
3. Sprawdź adres URL organizacji: upewnij się, że używasz poprawnego formatu adresu URL: https://dev.azure.com/{organizationName}.
4. Sprawdź typ konta: Sprawdź, czy logujesz się przy użyciu poprawnego typu konta (Identyfikator Entra Firmy Microsoft a osobiste konto Microsoft).

Jeśli te kroki nie rozwiążą problemu, przejdź do poniższych szczegółowych sekcji rozwiązywania problemów.

Rozwiązywanie problemów z uwierzytelnianiem

Usługa Azure DevOps obsługuje konta Microsoft Entra i konta osobiste Microsoft na potrzeby uwierzytelniania. Organizacje połączone z Microsoft Entra ID wymagają uwierzytelniania Microsoft Entra dla kont członków lub gości B2B.

401 — Błędy nieautoryzowane

Błąd 401 Not Authorized jest najczęstszym problemem z logowaniem. Ten błąd występuje, gdy tożsamość nie ma uprawnień dostępu do organizacji lub określonych zasobów. Typowe przyczyny:

• Tożsamość nie została dodana do organizacji: Twoje konto nie znajduje się w katalogu użytkowników organizacji.
• Nieporozumienie aliasu i UPN: Próba zalogowania się przy użyciu aliasu zamiast nazwy głównej użytkownika (UPN).
• Niewystarczające uprawnienia projektu: brak uprawnień do odczytu w docelowym projekcie lub zasobie.
• Oczekujące zaproszenie gościa B2B: zaproszenie gościa Microsoft Entra B2B nie zostało zaakceptowane.
• Niezgodność typu konta: próba zalogowania się przy użyciu nieprawidłowego typu konta, gdy wiele kont współużytkuje ten sam adres e-mail.

Tożsamość nie znajduje się w organizacji

Kroki rozwiązania problemu:

1. Skontaktuj się z administratorem usługi Azure DevOps, aby sprawdzić, czy tożsamość jest wyświetlana na liście Użytkownicy organizacji.
2. W przypadku kont Microsoft Entra: upewnij się, że tożsamość na liście Użytkownicy dokładnie odpowiada twojemu UPN w dzierżawie Microsoft Entra.
3. W przypadku osobistych kont Microsoft: potwierdź, że tożsamość jest zgodna z podstawowym adresem e-mail konta.
4. W przypadku gości B2B: sprawdź, czy nazwa UPN w dzierżawie gościa jest zgodna z nazwą UPN w Twojej dzierżawie macierzystej, w tym dokładną wielkość liter.

UPN vs. problemy z logowaniem przy użyciu aliasu

Usługa Azure DevOps nie obsługuje aliasów logowania. Musisz użyć dokładnej głównej nazwy użytkownika (UPN) dla kont Microsoft Entra lub konta podstawowego dla osobistych kont Microsoft.

Przykład: Jeśli twoje UPN to john.doe@contoso.com, ale masz alias jdoe@contoso.com, musisz zalogować się przy użyciu john.doe@contoso.com.

Rezolucja: Poproś administratora o dodanie rzeczywistej nazwy UPN (john.doe@contoso.com) do organizacji i zawsze użyj tej nazwy UPN do logowania.

Niewystarczające uprawnienia

Być może masz dostęp do organizacji, ale nie masz uprawnień do określonych projektów lub zasobów.

Objawy:

• Może uzyskać dostęp do https://dev.azure.com/{orgName}, ale nie https://dev.azure.com/{orgName}/{projectName}.
• Występują błędy 401 podczas uzyskiwania dostępu do określonych elementów pracy, repozytoriów lub potoków.

Rezolucja: Skontaktuj się z administratorem usługi Azure DevOps, aby sprawdzić, czy masz co najmniej uprawnienia do odczytu dla zasobu docelowego.

Problemy z zaproszeniem gościa B2B

Goście B2B muszą zaakceptować zaproszenie do dzierżawy Microsoft Entra przed uzyskaniem dostępu do Azure DevOps.

Kroki rozwiązywania problemów dla gości:

1. Sprawdź swój e-mail, aby znaleźć zaproszenie do Microsoft Entra.
2. Wybierz link zaproszenia i ukończ proces akceptacji.
3. Spróbuj ponownie zalogować się do usługi Azure DevOps.

Kroki rozwiązywania problemów dla administratorów dzierżawy:

1. Przejdź do https://portal.azure.com.
2. Wybierz Microsoft Entra ID>Użytkownicy.
3. Znajdź użytkownika-gościa i sprawdź stronę Przegląd .
4. Jeśli stan zaproszenia B2B to "Oczekujące na akceptację", użyj Wyślij ponownie zaproszenie.

Konflikty typów kont

Organizacje, które nie są połączone z identyfikatorem Entra firmy Microsoft, obsługują zarówno osobiste konta Microsoft, jak i konta Microsoft Entra. Pierwszy typ konta, którego używasz, ustala tożsamość trwale.

Rezolucja: Jeśli musisz zmienić typy kont:

1. Poproś administratora o usunięcie i ponowne dodanie Cię do organizacji.
2. Po wyświetleniu monitu zaloguj się przy użyciu preferowanego typu konta.

Rozwiązywanie problemów z łącznością

Problemy związane z przeglądarką

Ukończ wylogowanie i czyszczenie:

1. Wyloguj się całkowicie: przejdź do https://aka.ms/VsSignout strony.
2. Wyczyść wszystkie dane przeglądarki: Wybierz Ctrl+Shift+Delete i usuń:
   • Pliki cookie i dane witryn.
   • Buforowane obrazy i pliki.
   • Dane formularza autowypełniania.
3. Wyczyść dane przeglądarki Microsoft Edge: środowisko IDE programu Visual Studio używa plików cookie przeglądarki Microsoft Edge, dlatego wyczyść dane przeglądarki Microsoft Edge, nawet jeśli używasz innej przeglądarki.
4. Zamknij wszystkie aplikacje: Wyjdź ze wszystkich przeglądarek i instancji IDE programu Visual Studio.
5. Testowanie za pomocą przeglądania prywatnego: użyj okna incognito lub InPrivate, aby przetestować dostęp.

Problemy z połączeniem środowiska IDE programu Visual Studio

Jeśli występują problemy z połączeniem w programie Visual Studio:

1. Usuń istniejące połączenia: w programie Team Explorer usuń wszystkie połączenia usługi Azure DevOps.
2. Wyczyść pamięć podręczną poświadczeń: Usuń buforowane poświadczenia z Menedżera poświadczeń Windows.
3. Uruchom ponownie program Visual Studio: zamknij i otwórz ponownie program Visual Studio całkowicie.
4. Połączenia odczytane: dodaj ponownie połączenie usługi Azure DevOps przy użyciu bieżących poświadczeń.

Problemy z siecią i serwerem proxy

Rozwiązywanie problemów z siecią firmową:

1. Przetestuj z innej sieci: spróbuj uzyskać dostęp do usługi Azure DevOps z urządzenia osobistego/sieci.
2. Zweryfikuj ustawienia serwera proxy: Upewnij się, że firmowy serwer proxy zezwala na domeny *.visualstudio.com i *.azure.com.
3. Konfiguracja zapory: upewnij się, że zapora zezwala na ruch HTTPS do punktów końcowych usługi Azure DevOps.
4. Interferencja sieci VPN: przetestuj z wyłączoną siecią VPN, jeśli ma to zastosowanie.

Zaawansowane rozwiązywanie problemów

Migracja do nowoczesnych metod uwierzytelniania

Jeśli używasz starszych metod uwierzytelniania, rozważ migrację do nowoczesnych alternatyw:

• Osobiste tokeny dostępu (PATs): migrowanie do aplikacji Microsoft Entra OAuth.
• Nazwa użytkownika/hasło: przejdź do jednostek usługi lub tożsamości zarządzanych.
• Starsze tokeny: zaimplementuj uwierzytelnianie Microsoft Entra, aby uzyskać lepsze zabezpieczenia.

Uwierzytelnianie połączenia z usługą

W przypadku połączeń usługi Azure DevOps występują problemy z uwierzytelnianiem:

1. Odświeżanie tajnych kluczy tożsamości aplikacji: zaktualizuj wygasłe tajne klucze lub certyfikaty klienta.
2. Sprawdź uprawnienia: Upewnij się, że jednostki usługi mają odpowiednie uprawnienia usługi Azure DevOps.
3. Sprawdź wygaśnięcie tokenu: sprawdź, czy tokeny uwierzytelniania nie wygasły.
4. Przejrzyj dzienniki inspekcji: Sprawdź dzienniki inspekcji Microsoft Entra pod kątem błędów uwierzytelniania.

Rozwiązywanie problemów z połączeniem za pomocą sztucznej inteligencji

Poniższy przykład monitu Copilot Chat pomaga Copilot w rozwiązywaniu problemów z połączeniem i błędami uwierzytelniania. Skopiuj i wklej ten monit do aplikacji Copilot Chat, zastępując symbol zastępczy określonym komunikatem o błędzie lub opisem problemu.

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 jest obsługiwany przez sztuczną inteligencję, więc możliwe są niespodzianki i błędy. Aby uzyskać więcej informacji, zobacz także Copilot często zadawane pytania dotyczące ogólnego użytkowania.

Uzyskaj inną pomoc

Po wykonaniu wszystkich kroków rozwiązywania problemów nadal nie można nawiązać połączenia:

1. Zbierz informacje diagnostyczne: utwórz ślad przeglądarki po nieudanej próbie logowania.
2. Skontaktuj się z pomocą techniczną firmy Microsoft: utwórz wniosek o pomoc techniczną i dołącz:
   • Szczegółowy opis problemu.
   • Kroki, które już próbowano wykonać.
   • Pliki śledzenia przeglądarki.
   • Zrzuty ekranu komunikatów o błędach.
3. Pomoc techniczna społeczności: wyszukiwanie lub publikowanie pytań w społeczności deweloperów usługi Azure DevOps.

Treści powiązane

• Wskazówki dotyczące uwierzytelniania w usłudze Azure DevOps
• Uwierzytelnianie Microsoft Entra dla Azure DevOps
• Rozwiązywanie problemów z dostępem i uprawnieniami
• Przechwytywanie śladów przeglądarki na potrzeby rozwiązywania problemów