Azure Digital Twins 알려진 문제
이 문서에서는 Azure Digital Twins와 관련된 알려진 문제에 대한 정보를 제공합니다.
Azure Digital Twins Explorer는 프라이빗 엔드포인트를 지원하지 않습니다.
문제 설명: 공용 액세스를 사용하지 않도록 설정하기 위해 Private Link를 사용하는 Azure Digital Twins 인스턴스와 함께 Azure Digital Twins Explorer를 사용하려고 하면 오류가 표시됩니다. 모델을 가져오는 중 오류가 발생했습니다.라는 팝업이 표시될 수 있습니다.
| 어떤 영향이 있나요? | 원인 | 해결 방법 |
|---|---|---|
| 프라이빗 엔드포인트/Private Link와 함께 Azure Digital Twins를 사용하는 경우 이 문제는 Azure Digital Twins Explorer에서 인스턴스를 보려고 할 때 영향을 미칩니다. | Azure Digital Twins Explorer는 프라이빗 엔드포인트를 지원하지 않습니다. | Azure Digital Twins Explorer 코드베이스의 자체 버전을 클라우드에 비공개로 배포할 수 있습니다. 이를 수행하는 방법에 대한 지침은 Azure Digital Twins Explorer: 클라우드에서 실행을 참조하세요. 또는 대신 API 및 SDK를 사용하여 Azure Digital Twins 인스턴스를 관리할 수 있습니다. |
Cloud Shell의 "400 클라이언트 오류: 잘못된 요청"
문제 설명: https://shell.azure.com에서 Cloud Shell을 실행하는 명령이 간헐적으로 실패하고 "URL http://localhost:50342/oauth2/token에 대한 400 클라이언트 오류: 잘못된 요청"과 전체 스택 추적이 표시될 수 있습니다.
| 어떤 영향이 있나요? | 원인 | 해결 방법 |
|---|---|---|
Azure Digital Twins에서 이 문제는 다음 명령 그룹에 영향을 미칩니다.az dt routeaz dt modelaz dt twin |
이는 Cloud Shell의 알려진 문제, Cloud Shell에서 토큰 가져오기가 400 클라이언트 오류: 잘못된 요청과 함께 간헐적으로 실패로 인한 결과입니다. 이는 Azure Digital Twins 인스턴스 인증 토큰과 Cloud Shell의 기본 관리 ID 기반 인증의 문제를 나타냅니다. az dt 또는 az dt endpoint 명령 그룹의 Azure Digital Twins 명령에 영향을 미치지 않는데, Cloud Shell의 관리 ID 인증 관련 문제가 없는 다른 유형의 인증 토큰(Azure Resource Manager 기반)을 사용하기 때문입니다. |
이 문제를 해결하는 한 가지 방법은 Cloud Shell에서 az login 명령을 다시 실행하고 다음에 나오는 로그인 단계를 완료하는 것입니다. 이 작업을 통해 관리 ID 인증 외부로 세션이 전환되어 근본적인 문제가 방지됩니다. 그런 다음, 명령을 다시 실행할 수 있습니다.그렇지 않으면 Azure Portal에서 Cloud Shell 창을 열고 여기에서 Cloud Shell 작업을 완료합니다. 
마지막 해결 방법은 Azure CLI 명령을 로컬로 실행할 수 있도록 컴퓨터에 Azure CLI를 설치하는 것입니다. 로컬 CLI에서는 이 문제가 발생하지 않습니다. |
Azure.Identity 1.2.0의 대화형 브라우저 인증 문제
문제 설명: Azure.Identity 라이브러리 버전 1.2.0을 사용하여 Azure Digital Twins 애플리케이션에서 인증 코드를 작성할 때 InteractiveBrowserCredential 메서드에 문제가 발생할 수 있습니다. 이 문제는 브라우저 창에서 인증을 시도할 때 "Azure.Identity.AuthenticationFailedException" 오류 응답으로 표시됩니다. 브라우저 창이 완전히 시작되지 않거나 사용자를 성공적으로 인증하는 것처럼 보일 수 있지만 클라이언트 애플리케이션이 오류와 함께 실패합니다.
| 어떤 영향이 있나요? | 원인 | 해결 방법 |
|---|---|---|
| 영향을 받는 메서드는 다음 문서에서 사용됩니다. 클라이언트 앱 코딩 앱 인증 코드 작성 Azure Digital Twins API 및 SDK |
일부 사용자는 Azure.Identity 라이브러리 버전 1.2.0에서 문제를 겪습니다. |
해결하려면 Azure.Identity의 최신 버전을 사용하도록 애플리케이션을 업데이트합니다. 라이브러리 버전을 업데이트한 후 브라우저에서 예상대로 로드하고 인증해야 합니다. |
Azure.Identity 1.3.0의 기본 Azure 자격 증명 인증 문제
문제 설명: Azure.Identity 라이브러리 버전 1.3.0을 사용하여 인증 코드를 작성할 때 일부 사용자가 Azure Digital Twins 문서 전반에 걸쳐 많은 샘플에 사용되는 DefaultAzureCredential 메서드와 관련된 문제를 경험했습니다. 이 문제는 코드가 인증을 시도할 때 "Azure.Identity.AuthenticationFailedException: SharedTokenCacheCredential 인증 실패"라는 오류 응답으로 나타납니다.
| 어떤 영향이 있나요? | 원인 | 해결 방법 |
|---|---|---|
DefaultAzureCredential은 인증을 포함하는 서비스의 대부분 설명서 예제에서 사용됩니다. Azure.Identity 라이브러리 버전 1.3.0과 함께 DefaultAzureCredential을 사용하여 인증 코드를 작성하고 이 오류 메시지가 표시되는 경우 이 문제가 영향을 미치는 것입니다. |
이는 Azure.Identity 라이브러리 및 해당 인증 클래스인 DefaultAzureCredential의 일부 구성 문제로 인한 것일 수 있습니다. 이 클래스는 순서대로 시도되는 여러 자격 증명 형식을 포함하는 래퍼입니다. 인증 흐름이 SharedTokenCacheCredential 형식에 도달하면 문제가 발생할 수 있습니다. |
이 문제를 해결하는 한 가지 방법은 현재 Azure.Identity에 대해 열려 있는 DefaultAzureCredential 문제에서 설명하는 것과 같이 자격 증명에서 SharedTokenCacheCredential을 제외하는 것입니다. 다음 선택적 매개 변수를 사용하여 DefaultAzureCredential 클래스를 인스턴스화하여 자격 증명에서 SharedTokenCacheCredential을 제외할 수 있습니다. new DefaultAzureCredential(new DefaultAzureCredentialOptions { ExcludeSharedTokenCacheCredential = true }); 또 다른 옵션은 이전 버전의 Azure.Identity(예: 버전 1.2.3)를 사용하도록 애플리케이션을 변경하는 것입니다. 이전 버전을 사용하면 Azure Digital Twins의 기능에 영향을 주지 않으므로 허용된 해결책입니다. |
다음 단계
Azure Digital Twins의 보안 및 사용 권한에 대해 자세히 알아보세요.