Устранение неполадок с подключением к проекту

Сервисы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Если у вас возникли проблемы с подключением к проекту в Azure DevOps, в этой статье приводятся пошаговые инструкции по устранению распространенных проблем с подключением и проверкой подлинности.

Необходимые условия

Быстрые действия по разрешению

Если у вас возникли проблемы с подключением, попробуйте сначала выполнить следующие действия.

1. Полностью очистите браузер: выйдите с помощьюhttps://aka.ms/VsSignout, а затем очистите все файлы cookie (CTRL SHIFT++DELETE).
2. Используйте частный сеанс браузера: откройте окно инкогнито или InPrivate и проверьте доступ.
3. Проверьте URL-адрес организации: убедитесь, что используется правильный формат URL-адреса: https://dev.azure.com/{organizationName}
4. Проверьте тип учетной записи: убедитесь, что вы вошли с правильным типом учетной записи (Идентификатор Microsoft Entra и личная учетная запись Майкрософт).

Если эти действия не устраняют проблему, перейдите к следующим подробным разделам по устранению неполадок.

Устранение ошибок аутентификации

Azure DevOps поддерживает учетные записи Microsoft Entra и личные учетные записи Майкрософт для проверки подлинности. Организациям, подключенным к идентификатору Microsoft Entra, требуется идентификация Microsoft Entra (учетные записи участников или гостевые учетные записи B2B).

Ошибки 401 - Не авторизован

Ошибка 401 Not Authorized является наиболее распространенной проблемой входа. Эта ошибка возникает, когда ваше удостоверение не имеет разрешений для доступа к организации или конкретным ресурсам. Наиболее вероятные причины:

• Идентификатор не добавлен в организацию: ваша учетная запись не указана в пользовательском каталоге организации.
• Псевдоним и путаница имени участника-пользователя: попытка входа с помощью псевдонима вместо имени участника-пользователя (UPN).
• Недостаточно разрешений проекта: отсутствие разрешений на чтение целевого проекта или ресурса.
• Ожидается приглашение гостя B2B: приглашение гостя Microsoft Entra B2B не было принято.
• Несоответствие типа учетной записи: попытка входа с неправильным типом учетной записи, если несколько учетных записей используют один и тот же адрес электронной почты.

Идентификатор не в организации

Действия по разрешению:

1. Обратитесь к администратору Azure DevOps, чтобы убедиться, что ваша учетная запись отображается в списке пользователей организации.
2. Для учетных записей Microsoft Entra: убедитесь, что идентификатор в списке пользователей точно соответствует вашему UPN в клиенте Microsoft Entra.
3. Для личных учетных записей Майкрософт: убедитесь, что личность соответствует основному адресу электронной почты учетной записи.
4. Для гостей B2B: убедитесь, что UPN в гостевом клиенте соответствует UPN домашнего клиента с учётом точного регистра.

Проблемы при входе с использованием UPN и псевдонима

Azure DevOps не поддерживает псевдонимы входа. Необходимо использовать точное имя участника-пользователя (UPN) для учетных записей Microsoft Entra или основной учетной записи для личных учетных записей Майкрософт.

Пример: Если ваше UPN , но у вас есть псевдоним john.doe@contoso.com, необходимо войти, используя jdoe@contoso.com.

Резолюция: Попросите администратора добавить ваше фактическое УЗН (john.doe@contoso.com) в организацию и всегда используйте его для входа.

Недостаточно разрешений

У вас может быть доступ к организации, но отсутствуют разрешения для определенных проектов или ресурсов.

Симптомы

• Можно получить доступ к https://dev.azure.com/{orgName}, но не к https://dev.azure.com/{orgName}/{projectName}.
• Получение ошибок 401 при доступе к определенным рабочим элементам, репозиториям или конвейерам.

Резолюция: Обратитесь к администратору Azure DevOps, чтобы проверить наличие по крайней мере разрешений на чтение целевого ресурса.

Проблемы с приглашением гостей B2B

Перед доступом к Azure DevOps гости B2B должны принять приглашение клиента Microsoft Entra.

Действия по разрешению для гостей:

1. Проверьте электронную почту на наличие приглашения от Microsoft Entra.
2. Выберите ссылку приглашения и завершите процесс принятия.
3. Повторите попытку входа в Azure DevOps.

Шаги решения для администраторов арендаторов:

1. Перейти к https://portal.azure.com.
2. Выберите Microsoft Entra ID>Пользователи.
3. Найдите гостевого пользователя и проверьте страницу обзора .
4. Если в статусе приглашения B2B указано "Ожидание принятия", используйте Повторно отправить приглашение.

Конфликты типов учетных записей

Организации, не подключенные к идентификатору Microsoft Entra, поддерживают как персональные учетные записи Майкрософт, так и учетные записи Microsoft Entra. Первый тип учетной записи, который вы используете, постоянно устанавливает вашу личность.

Резолюция: Если необходимо изменить типы учетных записей:

1. Попросите администратора удалить вас из организации и добавить обратно.
2. При появлении запроса войдите с помощью предпочитаемого типа учетной записи.

Устранение неполадок с подключением

Проблемы, связанные с браузером

Полный выход из системы и очистка:

1. Выйдите полностью: перейдите к https://aka.ms/VsSignout.
2. Очистите все данные браузера: нажмите клавиши CTRL+SHIFT+Delete и удалите:
   • Файлы cookie и данные сайта.
   • Кэшированные изображения и файлы.
   • Данные формы автозаполнения.
3. Очистка данных Microsoft Edge: интегрированная среда разработки Visual Studio использует файлы cookie Microsoft Edge, поэтому очищайте данные Microsoft Edge, даже если вы используете другой браузер.
4. Закройте все приложения: закройте все браузеры и экземпляры интегрированной среды разработки Visual Studio.
5. Используйте режим инкогнито или окно InPrivate для тестирования доступа.

Проблемы с подключением интегрированной среды разработки Visual Studio

Если у вас возникли проблемы с подключением в Visual Studio:

1. Удалите существующие подключения: в Team Explorer удалите все подключения Azure DevOps.
2. Очистка кэша учетных данных: удаление кэшированных учетных данных из Диспетчера учетных данных Windows.
3. Перезапустите Visual Studio: закройте и снова откройте Visual Studio полностью.
4. Повторное добавление подключений: добавьте подключение Azure DevOps снова, используя ваши текущие учетные данные.

Проблемы с сетью и прокси-сервером

Устранение неполадок с корпоративной сетью:

1. Тестирование из другой сети. Попробуйте получить доступ к Azure DevOps из личного устройства или сети.
2. Проверьте параметры прокси-сервера: убедитесь, что корпоративный прокси-сервер разрешает доступ к доменам *.visualstudio.com и *.azure.com.
3. Конфигурация брандмауэра. Убедитесь, что брандмауэр разрешает трафик HTTPS в конечные точки Azure DevOps.
4. VPN-помеха: проверка с помощью VPN отключена, если применимо.

Расширенное устранение неполадок

Современная миграция аутентификации

Если вы используете устаревшие методы проверки подлинности, рассмотрите возможность миграции в современные альтернативные варианты:

• Личные токены доступа (PAT): Переход на приложения Microsoft Entra OAuth.
• Имя пользователя и пароль: переключитесь на учетные записи службы или управляемые удостоверения.
• Устаревшие маркеры: внедрение аутентификации Microsoft Entra для повышения безопасности.

Аутентификация подключения службы

Для подключений к службе Azure DevOps возникают проблемы с проверкой подлинности:

1. Обновление секретов учетной записи службы: обновление просроченных секретов клиента или сертификатов.
2. Проверка разрешений. Убедитесь, что субъекты-службы имеют соответствующие разрешения Azure DevOps.
3. Проверка срока действия токена: Убедитесь, что токены аутентификации не истекли.
4. Просмотрите журналы аудита Microsoft Entra. Проверьте их для выявления сбоев проверки подлинности.

Устранение неполадок с подключением с помощью искусственного интеллекта

В следующем примере подсказки Copilot Chat помогает Copilot устранять ошибки при подключении и проверке подлинности. Скопируйте и вставьте этот запрос в 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 работает на основе искусственного интеллекта, поэтому возможны сюрпризы и ошибки. Подробности см. в Общие вопросы об использовании Copilot.

Получить другую помощь

После выполнения всех действий по устранению неполадок и по-прежнему не удается подключиться:

1. Сбор диагностических сведений:создайте отслеживание в браузере для вашей неудачной попытки входа.
2. Обратитесь в службу поддержки Майкрософт: создайте запрос на поддержку и включите:
   • Подробное описание проблемы.
   • Шаги, которые вы уже пытались выполнить.
   • Файлы трассировки браузера.
   • Снимок экрана: сообщения об ошибках.
3. Поддержка сообщества: поиск или публикация вопросов в сообществе разработчиков Azure DevOps.

Связанный контент

• Все руководства по устранению неполадок и часто задаваемые вопросы
• Руководство по проверке подлинности Azure DevOps
• Проверка подлинности Microsoft Entra для Azure DevOps
• Устранение неполадок с доступом и разрешениями
• Отслеживание трассировок браузера для устранения неполадок