Azure Data Explorer에서 Microsoft Entra 애플리케이션 등록 만들기

Microsoft Entra 애플리케이션 인증 은 사용자 없이 Azure Data Explorer에 액세스해야 하는 무인 서비스 또는 예약된 흐름과 같은 애플리케이션에 사용됩니다. 웹앱과 같은 애플리케이션을 사용하여 Azure Data Explorer 데이터베이스에 연결하는 경우 서비스 주체 인증을 사용하여 인증해야 합니다. 이 문서에서는 Microsoft Entra 서비스 주체를 만들고 등록한 다음 Azure Data Explorer 데이터베이스에 액세스하도록 권한을 부여하는 방법을 자세히 설명합니다.

Microsoft Entra 애플리케이션 등록 만들기

Microsoft Entra 애플리케이션 인증을 사용하려면 Microsoft Entra ID를 사용하여 애플리케이션을 만들고 등록해야 합니다. Microsoft Entra 테넌트에서 애플리케이션 등록을 만들 때 서비스 주체가 자동으로 만들어집니다.

앱 등록은 Azure Portal에서 만들거나 Azure CLI를 사용하여 프로그래밍 방식으로 만들 수 있습니다. 시나리오에 맞는 탭을 선택합니다.

애플리케이션에 대한 위임된 권한 구성 - 선택 사항

애플리케이션이 호출하는 사용자의 자격 증명을 사용하여 데이터베이스에 액세스해야 하는 경우 애플리케이션에 대해 위임된 권한을 구성합니다. 예를 들어 웹 API를 빌드하고 API를 호출하는 사용자의 자격 증명을 사용하여 인증하려는 경우입니다.

권한 있는 데이터 리소스에만 액세스해야 하는 경우 이 섹션을 건너뛰고 데이터베이스에 대한 서비스 주체 액세스 권한을 계속 부여할 수 있습니다.

1. 앱 등록의 API 권한 블레이드로 이동합니다.

2. 권한 추가를 선택합니다.

3. 내 조직에서 사용하는 API를 선택합니다.

4. Azure Data Explorer를 검색하여 선택합니다.

   

5. 위임된 사용 권한에서 user_impersonation 상자를 선택합니다.

6. 권한 추가를 선택합니다.

   

데이터베이스에 대한 서비스 주체 액세스 권한 부여

애플리케이션 등록이 만들어지면 해당 서비스 주체에게 데이터베이스에 대한 액세스 권한을 부여해야 합니다. 다음 예제에서는 뷰어에 액세스 권한을 제공합니다. 다른 역할은 데이터베이스 권한 관리를 참조 하세요.

1. 이전 단계에서 복사한 대로 애플리케이션 ID 및 테넌트 ID의 값을 사용합니다.

2. 쿼리 편집기에서 다음 명령을 실행하여 자리 표시자 값 ApplicationID 및 TenantID를 실제 값으로 바꿉 있습니다.

   .add database <DatabaseName> viewers ('aadapp=<ApplicationID>;<TenantID>') '<Notes>'
   

   예시:

   .add database Logs viewers ('aadapp=1234abcd-e5f6-g7h8-i9j0-1234kl5678mn;9876abcd-e5f6-g7h8-i9j0-1234kl5678mn') 'App Registration'
   

   마지막 매개 변수는 데이터베이스와 연결된 역할을 쿼리할 때 메모로 표시되는 문자열입니다.

   참고 항목

   애플리케이션 등록을 만든 후 참조할 수 있을 때까지 몇 분 정도 지연될 수 있습니다. 애플리케이션을 찾을 수 없다는 오류가 표시되면 기다렸다가 다시 시도합니다.

역할에 대한 자세한 내용은 역할 기반 액세스 제어를 참조하세요.

애플리케이션 자격 증명을 사용하여 데이터베이스 액세스

애플리케이션 자격 증명을 사용하여 클라이언트 라이브러리를 사용하여 프로그래밍 방식으로 데이터베이스에 액세스합니다.

. . .
string applicationClientId = "<myClientID>";
string applicationKey = "<myApplicationKey>";
string authority = "<myApplicationTenantID>";
. . .
var kcsb = new KustoConnectionStringBuilder($"https://{clusterName}.kusto.windows.net/{databaseName}")
    .WithAadApplicationKeyAuthentication(
        applicationClientId,
        applicationKey,
        authority);
var client = KustoClientFactory.CreateCslQueryProvider(kcsb);
var queryResult = client.ExecuteQuery($"{query}");

자세한 내용은 앱에서 MSAL(Microsoft 인증 라이브러리)로 인증하고 .NET Core 웹앱에서 Azure Key Vault를 사용하는 방법을 참조하세요.

문제 해결

잘못된 리소스 오류

애플리케이션을 사용하여 사용자 또는 애플리케이션의 액세스를 인증하는 경우 서비스 애플리케이션에 대해 위임된 권한을 설정해야 합니다. 애플리케이션이 액세스를 위해 사용자 또는 애플리케이션을 인증할 수 있다고 선언합니다. 이렇게 하지 않으면 인증이 시도될 때 다음과 같은 오류가 발생합니다.

AADSTS650057: Invalid resource. The client has requested access to a resource which is not listed in the requested permissions in the client's application registration...

지침 에 따라 애플리케이션에 대한 위임된 권한을 구성해야 합니다.

사용자 동의 오류 사용

Microsoft Entra 테넌트 관리자는 테넌트 사용자가 애플리케이션에 동의하지 못하도록 하는 정책을 제정할 수 있습니다. 이 경우 사용자가 애플리케이션에 로그인하려고 하면 다음과 같은 오류가 발생합니다.

AADSTS65001: The user or administrator has not consented to use the application with ID '<App ID>' named 'App Name'

테넌트의 모든 사용자에 대한 동의를 부여하거나 특정 애플리케이션에 대한 사용자 동의를 사용하도록 설정하려면 Microsoft Entra 관리자에게 문의해야 합니다.

관련 콘텐츠

• Kusto 연결 문자열
• 리소스에 액세스할 수 있는 Microsoft Entra 애플리케이션 및 서비스 주체 만들기