Поделиться через


Известные проблемы Azure Digital Twins

В этой статье содержатся сведения о известных проблемах, связанных с Azure Digital Twins.

Azure Digital Twins Explorer не поддерживает частные конечные точки

описание проблемы: Azure Digital Twins Explorer отображает ошибки при попытке использовать его с экземпляром Azure Digital Twins, использующим приватный канал для отключения общедоступного доступа. Появится всплывающее окно с сообщением: Ошибка при получении моделей.

Влияет ли это на меня? Причина Резолюция
Если вы используете Azure Digital Twins с частной конечной точкой или Private Link, эта проблема будет влиять на доступ к вашему экземпляру в Azure Digital Twins Explorer. Azure Digital Twins Explorer не поддерживает частные конечные точки. Вы можете развернуть собственную версию базы кода Azure Digital Twins Explorer в частном порядке в облаке. Для инструкций о том, как это сделать, см. Azure Digital Twins Explorer: работа в облаке. В качестве альтернативы вы можете управлять экземпляром Azure Digital Twins с помощью API и SDK.

"Ошибка клиента 400: недопустимый запрос" в Cloud Shell

описание проблемы: команды в Cloud Shell, выполняющиеся в https://shell.azure.com, могут периодически завершиться с ошибкой "Ошибка клиента 400: недопустимый запрос для URL-адреса: http://localhost:50342/oauth2/token", после чего следует полная трассировка стека.

Влияет ли это на меня? Причина Резолюция
В Azure Digital Twins эта проблема влияет на следующие группы команд:

az dt route

az dt model

az dt twin
Это результат известной проблемы в Cloud Shell: периодически происходит сбой при получении токена из Cloud Shell с ошибкой 400 клиента: Некорректный запрос.

Эта проблема связана с токенами аутентификации экземпляра Azure Digital Twins и системой аутентификации Cloud Shell, основанной на управляемом удостоверении по умолчанию.

Это не влияет на команды Azure Digital Twins из групп команд az dt или az dt endpoint, так как они используют другой тип маркера проверки подлинности (на основе Azure Resource Manager), что не вызывает проблем с проверкой подлинности управляемого удостоверения Cloud Shell.
Одним из способов устранения этой проблемы является повторное выполнение команды az login в Cloud Shell и выполнение следующих шагов входа. Это действие переключит сеанс с проверки подлинности с использованием управляемого удостоверения, избежав корневой проблемы. После этого можно повторно запустить команду.

В противном случае вы можете открыть панель Cloud Shell на портале Azure и завершить работу в Cloud Shell оттуда.
снимок экрана: значок Cloud Shell на панели значков портала Azure.

Наконец, другим решением является установить Azure CLI на компьютере, чтобы выполнять команды Azure CLI локально. Эта проблема не возникает в локальном интерфейсе командной строки.

Проблема с интерактивной проверкой подлинности браузера в Azure.Identity 1.2.0

описание проблемы: при написании кода аутентификации в приложениях Azure Digital Twins с помощью версии 1.2.0 библиотеки Azure.Identity вы можете столкнуться с проблемами с методом InteractiveBrowserCredential. Эта проблема представляет собой ответ об ошибке "Azure.Identity.AuthenticationFailedException" при попытке пройти проверку подлинности в окне браузера. Окно браузера не может полностью запуститься или похоже, успешно проверяет подлинность пользователя, в то время как клиентское приложение по-прежнему выдает ошибку.

Влияет ли это на меня? Причина Резолюция
Затронутый метод используется в следующих статьях:

Код клиентского приложения

Написание кода проверки подлинности приложения

API и пакеты SDK Azure Digital Twins
Некоторые пользователи имели эту проблему с версией 1.2.0 библиотеки Azure.Identity. Чтобы устранить проблему, обновите ваши приложения для использования более поздней версииAzure.Identity. После обновления версии библиотеки браузер должен загрузиться и аутентифицироваться должным образом.

Проблема с проверкой подлинности учетных данных Azure по умолчанию в Azure.Identity 1.3.0

описание проблемы: при написании кода аутентификации с помощью библиотеки Azure.Identity некоторые пользователи столкнулись с проблемами с методом DefaultAzureCredential, используемым во многих примерах в этих документах Azure Digital Twins. Эта проблема возникает как сообщение об ошибке "Azure.Identity.AuthenticationFailedException: сбой аутентификации SharedTokenCacheCredential", когда код пытается пройти аутентификацию.

Влияет ли это на меня? Причина Резолюция
DefaultAzureCredential используется в большинстве примеров документации для этой службы, включающих проверку подлинности. Если вы пишете код проверки подлинности с помощью DefaultAzureCredential с версией 1.3.0 библиотеки Azure.Identity и видите это сообщение об ошибке, эта проблема влияет на вас. Скорее всего, это результат некоторых проблем конфигурации с библиотекой Azure.Identity и классом проверки подлинности DefaultAzureCredential. Этот класс является оберткой, содержащей несколько типов учетных данных, которые проверяются по очереди. Проблема может возникать, когда поток проверки подлинности достигает типа SharedTokenCacheCredential. Одна из стратегий решения этой проблемы заключается в исключении SharedTokenCacheCredential из ваших учетных данных, как указано в этом вопросе DefaultAzureCredential, который в настоящее время открыт против Azure.Identity. Вы можете исключить SharedTokenCacheCredential из учетных данных, создав экземпляр класса DefaultAzureCredential с помощью следующего необязательного параметра: new DefaultAzureCredential(new DefaultAzureCredentialOptions { ExcludeSharedTokenCacheCredential = true });
Другим вариантом является изменение приложения на использование более ранней версии Azure.Identity, например версии 1.2.3. Использование более ранней версии не влияет на Azure Digital Twins, что делает его приемлемым решением.

Команды az dt не работают со старым расширением azure-iot.

Описание проблемы: Команды CLI из az dt набора команд завершаются ошибкой, если вы используете более раннюю версию azure-iot расширения, чем 0.26.0 (0.26.0 является приемлемым) вместе с версией 2.70.0 или более поздней версии Azure CLI. Сообщение об ошибке заканчивается AttributeError: объект CredentialAdaptor не имеет атрибута "signed_session".

Влияет ли это на меня? Причина Резолюция
Эта проблема влияет на возможность выполнения az dt команд, если вы используете Azure CLI версии 2.70.0 или более поздней, а также версию azure-iot расширения, которая находится в более ранней версии, чем 0.26.0. Вы можете проверить версию CLI с помощью команды az version, а версию расширения с помощью команды azure-iot. Для выполнения команд в версии 2.70.0 или более поздней Azure CLI требуется версия 0.26.0 или более поздняя расширения CLI azure-iot. Используйте команду az extension update, чтобы обновить расширение azure-iot до самой последней версии.

Дальнейшие действия

Дополнительные сведения о безопасности и разрешениях для Azure Digital Twins: