다음을 통해 공유

개발 환경 인증 문제 해결

이 문서에서는 개발자 컴퓨터에서 로컬로 실행되는 Java 애플리케이션용 Azure SDK를 인증할 때 발생하는 문제를 다양한 TokenCredential 구현을 통해 처리하는 방법에 대한 지침을 제공합니다. 자세한 내용은 Java 개발 환경에서 Azure 인증을 참조하세요.

AzureCliCredential 문제 해결

AzureCliCredential를 사용할 때, 필요에 따라 CredentialUnavailableException에 대해 시도하거나 잡을 수 있습니다. 다음 표에서는 이 예외가 나타내는 오류와 완화 방법을 보여 줍니다.

오류 메시지 설명 완화 방법
Azure CLI not installed Azure CLI가 설치되지 않았거나 찾을 수 없습니다. - Azure CLI를 제대로 설치했는지 확인하십시오.
- 설치 위치가 PATH 환경 변수에 추가되었는지 확인합니다.
Please run 'az login' to set up account 현재 Azure CLI에 로그인한 계정이 없거나 로그인이 만료되었습니다. - 명령어를 사용하여 Azure CLI에 로그인합니다. 자세한 내용은 Azure CLI로 로그인을 참조하세요.
- Azure CLI가 토큰을 가져올 수 있도록 유효성을 검사합니다. 자세한 내용은 다음 섹션을 참조하세요.

Azure CLI가 토큰을 가져올 수 있는지 확인합니다.

Azure CLI를 제대로 인증했는지 수동으로 확인할 수 있으며 토큰을 가져올 수 있습니다. 먼저 다음 명령을 사용하여 계정이 현재 Azure CLI에 로그인되어 있는지 확인합니다.

az account show

Azure CLI가 올바른 계정을 사용하고 있는지 확인한 후 다음 명령을 사용하여 이 계정에 대한 토큰을 가져올 수 있는지 확인합니다.

az account get-access-token \
    --output json \
    --resource https://management.core.windows.net

경고

이 명령의 출력에는 유효한 액세스 토큰이 포함되어 있습니다. 계정 보안이 손상되지 않도록 하려면 이 액세스 토큰을 공유하지 마세요.

AzureDeveloperCliCredential 문제 해결

AzureDeveloperCliCredential를 사용할 때, 필요에 따라 CredentialUnavailableException에 대해 시도하거나 잡을 수 있습니다. 다음 표에서는 이 예외가 나타내는 오류와 완화 방법을 보여 줍니다.

오류 메시지 설명 완화 방법
Azure Developer CLI not installed Azure 개발자 CLI가 설치되지 않았거나 찾을 수 없습니다. - Azure 개발자 CLI를 제대로 설치했는지 확인합니다.
- 설치 위치가 PATH 환경 변수에 추가되었는지 확인합니다.
Please run 'azd auth login' to set up account 현재 Azure Developer CLI에 로그인한 계정이 없거나 로그인이 만료되었습니다. - azd auth login 명령을 사용하여 Azure 개발자 CLI에 로그인합니다.
- Azure 개발자 CLI가 토큰을 가져올 수 있는지 확인합니다. 자세한 내용은 다음 섹션을 참조하세요.

Azure 개발자 CLI가 토큰을 가져올 수 있는지 확인합니다.

Azure 개발자 CLI를 제대로 인증했는지 수동으로 확인할 수 있으며 토큰을 가져올 수 있습니다. 먼저 다음 명령을 사용하여 계정이 현재 Azure Developer CLI에 로그인되어 있는지 확인합니다.

azd config list

Azure 개발자 CLI가 올바른 계정을 사용하고 있는지 확인한 후 다음 명령을 사용하여 이 계정에 대한 토큰을 가져올 수 있는지 확인할 수 있습니다.

azd auth token --output json --scope https://management.core.windows.net/.default

경고

이 명령의 출력에는 유효한 액세스 토큰이 포함되어 있습니다. 계정 보안이 손상되지 않도록 하려면 이 액세스 토큰을 공유하지 마세요.

AzurePowerShellCredential 문제 해결

AzurePowerShellCredential를 사용할 때, 필요에 따라 CredentialUnavailableException에 대해 시도하거나 잡을 수 있습니다. 다음 표에서는 이 예외가 나타내는 오류와 완화 방법을 보여 줍니다.

오류 메시지 설명 완화 방법
PowerShell isn't installed. PowerShell의 로컬 설치를 찾을 수 없습니다. 컴퓨터에 PowerShell이 제대로 설치되었는지 확인하십시오.
Az.Account module >= 2.2.0 isn't installed. Az.Account 모듈이 Azure PowerShell에서 인증에 필요하지만 설치되어 있지 않습니다. 최신 Az.Account 모듈을 설치합니다. 자세한 내용은 Azure PowerShell 설치 방법을 참조하세요.
Please run 'Connect-AzAccount' to set up account. 현재 Azure PowerShell에 로그인된 계정이 없습니다. - Connect-AzAccount 명령을 사용하여 Azure PowerShell에 로그인합니다. 자세한 내용은 Azure PowerShell로 로그인을 참조하세요.
- Azure PowerShell에서 토큰을 가져올 수 있는지 확인합니다. 자세한 내용은 다음 섹션을 참조하세요.

Azure PowerShell에서 토큰을 가져올 수 있는지 확인

Azure PowerShell을 올바르게 인증했는지 수동으로 확인할 수 있으며 토큰을 가져올 수 있습니다. 먼저 다음 명령을 사용하여 계정이 현재 Azure CLI에 로그인되어 있는지 확인합니다.

Get-AzContext

이 명령은 다음 예제와 유사한 출력을 생성합니다.

Name                                     Account             SubscriptionName    Environment         TenantId
----                                     -------             ----------------    -----------         --------
Subscription1 (xxxxxxxx-xxxx-xxxx-xxx... test@outlook.com    Subscription1       AzureCloud          xxxxxxxx-x...

Azure PowerShell이 올바른 계정을 사용하고 있는지 확인한 후 다음 명령을 사용하여 이 계정에 대한 토큰을 가져올 수 있는지 확인할 수 있습니다.

Get-AzAccessToken -ResourceUrl "https://management.core.windows.net"

경고

이 명령의 출력에는 유효한 액세스 토큰이 포함되어 있습니다. 계정 보안이 손상되지 않도록 하려면 이 액세스 토큰을 공유하지 마세요.

VisualStudioCodeCredential 문제 해결

주의

알려진 문제로, VisualStudioCodeCredential보다 최신 버전의 0.9.11와 호환되지 않습니다. 이 문제에 대한 장기적인 수정이 진행 중입니다. 우선은 Azure CLI를 통해 인증하는 것을 고려하시기 바랍니다.

VisualStudioCodeCredential를 사용할 때, 필요에 따라 CredentialUnavailableException에 대해 시도하거나 잡을 수 있습니다. 다음 표에서는 이 예외가 나타내는 오류와 완화 방법을 보여 줍니다.

오류 메시지 설명 완화 방법
Failed To Read VS Code Credentials</p></p>OR</p>Authenticate via Azure Tools plugin in VS Code VS Code 구성에서 Azure 계정 정보를 찾을 수 없습니다. - Azure 계정 플러그 인을 제대로 설치했는지 확인합니다.
- 보기 명령 팔레트를 사용하여 Azure: 로그인 명령을 실행합니다.> 이 명령은 브라우저 창을 열고 Azure에 로그인할 수 있는 페이지를 표시합니다.
- Azure 계정 확장이 이미 설치되어 있고 계정에 로그인한 경우 로그아웃하고 다시 로그인해 보세요. 이 작업을 수행하면 캐시가 다시 채워지고 발생할 수 있는 오류가 완화될 수 있습니다.
MSAL Interaction Required Exception VisualStudioCodeCredential 캐시에서 자격 증명을 읽을 수 있었지만, 캐시된 토큰은 만료되었을 가능성이 큽니다. VS Code IDE에서 > 명령을 실행하려면 View Command Palette를 통해 Azure 계정 확장에 로그인하세요.
ADFS tenant not supported Visual Studio Azure 서비스 인증은 현재 ADFS 테넌트를 지원하지 않습니다. Visual Studio를 사용하여 인증할 때 지원되는 클라우드의 자격 증명을 사용합니다. 지원되는 클라우드에 대한 자세한 내용은 국가별 클라우드를 참조하십시오.

다음 단계

이 문서의 문제 해결 지침이 Java용 Azure SDK 클라이언트 라이브러리를 사용할 때 발생하는 문제를 해결하는 데 도움이 되지 않는 경우, Azure SDK for Java GitHub 리포지토리에 이슈를 등록하는 것을 권장합니다.