Graph Data Connect와 Microsoft Graph 권한 해설: 설정, 동의, 최소 권한
By Mirko Peters ·
Microsoft Graph Data Connect의 기능, Graph API와의 차이, 설정 및 승인 단계, 그리고 Graph 권한(위임된 권한, 애플리케이션 권한, 동의)의 작동 방식을 설명합니다.
Automatically translated with AI from the original post. Read the English original
Microsoft Graph Data Connect와 Microsoft Graph 권한은 별개의 주제이지만 자주 함께 검색됩니다. Data Connect는 Microsoft 365 분석을 위한 대량 데이터 추출 서비스입니다. Graph 권한은 앱이 Graph API를 통해 수행할 수 있는 작업을 제어합니다. 두 가지 모두 동의를 기반으로 하며, 같은 습관이 중요합니다. 즉, 작업을 수행하는 데 필요한 최소한의 액세스 권한만 요청하는 것입니다.
핵심 포인트
- Graph Data Connect는 분석을 위해 Microsoft 365 데이터를 Azure 스토리지로 대량 추출합니다. Graph API는 선택한 사용자와 그룹의 적은 양의 데이터에 적합합니다.
- 설정하려면 이를 활성화할 전역 관리자, Entra 앱 등록, Azure Storage 계정, 그리고 데이터 액세스 요청에 대한 관리자 승인이 필요합니다.
- 파이프라인에는 약 45분의 오버헤드가 있으며, 동의 과정을 포함하면 첫 실행에 40분 이상 걸릴 수 있습니다.
- Graph 권한에는 두 가지 유형이 있습니다. 위임된 권한은 로그인한 사용자를 대신해 작동합니다. 애플리케이션 권한은 사용자 없이 작동하며 관리자 동의가 필요합니다.
- Microsoft는 앱의 요구를 충족하는 경우 위임 모델을 권장하며, 작동하는 가장 작은 권한을 사용할 것을 권장합니다.
- 권한 이름은 Application.ReadWrite.OwnedBy와 같이 {resource}.{operation}.{constraint} 형식을 따릅니다.
Graph Data Connect란 무엇인가
Microsoft는 Data Connect를 엔터프라이즈 분석을 위해 Microsoft Fabric, Azure Synapse, Azure Data Factory에서 Microsoft 365 데이터 세트에 안전하고 확장 가능한 방식으로 액세스하는 기능이라고 설명합니다. 데이터는 Microsoft Entra ID, Outlook, Teams, SharePoint, Viva Insights, Microsoft 그룹 등의 소스에서 가져옵니다.
데이터 세트는 기본(고객이 만든 원시 콘텐츠), 정리됨(정규화 또는 중복 제거), 큐레이션됨(특정 시나리오용으로 구성) 세 가지 그룹으로 나뉩니다. 데이터 세트 목록에는 예를 들어 TeamsCallRecords_v1, SharePointPermissions_v1, GroupMembers_v0, PlannerTasks_v0가 포함됩니다. Viva Insights 데이터 세트에는 Viva Insights 라이선스가 필요하며, 이는 데이터 세트 페이지에 있는 유일한 라이선스 관련 안내입니다.
Data Connect 또는 Graph API
Data Connect FAQ는 다음과 같이 설명합니다. 두 방식 모두 같은 기반 데이터에 접근합니다. Data Connect는 조직 전체에서 대량의 데이터를 일괄 추출합니다. Graph API는 선택한 사용자와 그룹의 적은 양의 데이터에 적합합니다. FAQ는 두 방식을 함께 사용할 것을 제안합니다. 예를 들어 초기 추출에는 Data Connect를, 이후 실시간 작업에는 Graph API를 사용하는 방식입니다.
FAQ에서 안내하는 알려진 제한 사항은 다음과 같습니다.
- 데이터 크기와 관계없이 파이프라인에는 약 45분의 오버헤드가 있습니다.
- 하이브리드 구성을 포함하여 Exchange 온-프레미스 사용자는 지원되지 않습니다.
- 리소스 계정의 메시지와 이벤트는 지원되지 않습니다.
- 테넌트 간 데이터 세트 액세스는 사용할 수 없습니다. Azure 리소스와 Microsoft 365는 같은 Entra 테넌트에 있어야 합니다.
설정 단계
빠른 시작 안내에서 다음 단계를 설명합니다. 메뉴 이름은 Microsoft가 표시한 그대로 적었습니다.
- Data Connect 사용하도록 설정합니다. 전역 관리자 계정으로 admin.microsoft.com에 로그인합니다. 설정 > 조직 설정을 선택한 다음 서비스 탭에서 Microsoft Graph Data Connect를 선택합니다. 전체 조직에 대해 사용하도록 설정하는 옵션을 선택하고 저장합니다.
- Entra 애플리케이션을 만듭니다. Microsoft Entra 관리 센터에서 앱 등록 > 새 등록으로 이동합니다. "이 조직 디렉터리의 계정만"을 선택합니다. 애플리케이션(클라이언트) ID와 테넌트 ID를 복사하고, 클라이언트 비밀을 만든 뒤 그 값을 즉시 저장합니다. 애플리케이션 소유자에게는 사서함이 필요하며, 빠른 시작 가이드에 따르면 작동하는 E5 구독도 필요합니다.
- Azure Storage를 만듭니다. Microsoft 365 리전과 일치하는 리전에 스토리지 계정을 만듭니다. 액세스 제어(IAM)에서 애플리케이션에 Storage Blob Data Contributor 역할을 부여하고, 프라이빗 컨테이너를 만듭니다.
- Azure Portal에서 Data Connect에 애플리케이션을 등록합니다. 대상, 애플리케이션, 데이터 세트와 열을 선택합니다.
- 요청을 승인합니다. 관리자는 설정 > 조직 설정 > 보안 및 개인 정보 보호 > Microsoft Graph Data Connect 애플리케이션을 엽니다. 애플리케이션에는 사전 동의가 표시됩니다. 데이터 세트를 검토한 후 승인을 선택합니다. 빠른 시작 가이드에서는 자체 승인이 불가능하다고 경고합니다.
- Synapse, Data Factory 또는 Fabric에서 파이프라인을 실행합니다. 상태는 Initializing, Consent Pending, Extracting Data, Persisting Data, Succeeded 순으로 바뀝니다. 첫 실행에는 40분 넘게 걸릴 수 있습니다.
지원되는 싱크는 Azure Data Lake Storage Gen2, Azure Storage Blob, Azure SQL DB(매핑 데이터 흐름에만 해당) 및 Microsoft Fabric OneLake입니다. 지원되는 인증 방식은 서비스 주체 인증뿐입니다.
동의와 비용
동의는 추출 범위(데이터 세트, 열, 사용자, 싱크)에 적용됩니다. 범위가 같은 실행에는 새 요청이 필요하지 않습니다. 비용은 Azure 구독을 통해 파이프라인 실행 단위로 청구되며, 소수 단위는 올림 처리됩니다. FAQ 예시에 따르면 각 500행인 실행 20회는 10단위가 아니라 20단위로 청구됩니다. 확인한 페이지에는 요금이 명시되어 있지 않습니다.
Graph 권한: 기본 사항
Graph API에서 Microsoft는 두 가지 권한 유형을 정의합니다.
| | 위임됨 | 애플리케이션 | |---|---|---| | 작동 주체 | 로그인한 사용자를 대신하여 | 사용자 없이 | | 실제 액세스 | 앱 권한과 사용자 자신의 권한에 따라 제한됨 | 권한이 포함하는 모든 데이터 | | 동의 가능 대상 | 사용자, 또는 모든 사용자에 대해 관리자 | 관리자만 | | 다른 이름 | 범위 | 앱 역할 |
애플리케이션 권한에 대한 동의에는 권한 있는 역할 관리자 또는 전역 관리자 역할이 필요합니다. 위임된 권한에 대한 사용자 동의는 테넌트 앱 동의 정책에 따라 여전히 제한될 수 있습니다.
명명 규칙과 최소 권한
권한은 {resource}.{operation}.{constraint} 형식을 따릅니다. 문서의 예시에서는 Read, ReadWrite 같은 작업과 All, OwnedBy 같은 제약 조건을 사용합니다. 제약 조건이 없으면 액세스는 로그인한 사용자가 소유한 데이터로 제한됩니다. 예를 들어 Application.ReadWrite.OwnedBy는 앱이 만들었거나 소유한 애플리케이션만 관리하는 반면, Application.ReadWrite.All은 모든 애플리케이션을 관리합니다.
Microsoft의 권장 사항은 필요한 최소 권한만 부여하는 것입니다. Directory.AccessAsUser.All, Directory.ReadWrite.All, Directory.Read.All은 신중하게 사용하고, 가능하면 더 낮은 권한을 선택하십시오. 리소스별 동의를 사용하면 사용자가 테넌트 전체가 아니라 팀 같은 단일 리소스 인스턴스에 대한 액세스만 허용할 수 있습니다. 이 기능은 일부 기능에서만 지원됩니다.
자주 발생하는 문제
- 커넥터 에이전트 등록이 실패합니다. Learn에 따르면 커넥터 에이전트 등록에서는 위임된 권한이 지원되지 않습니다. 최소 권한의 애플리케이션 권한을 요청하고 테넌트 전체에 대한 관리자 동의를 부여하십시오.
- 구성원에 id와 @odata.type만 표시됩니다. 앱에 해당 구성원 유형을 읽을 권한이 없습니다.
- 한 앱에 권한이 너무 많습니다. 로그인 대상에 개인 Microsoft 계정이 포함된 앱은 최대 30개의 권한을 요청할 수 있으며, 조직 대상 앱은 최대 400개까지 요청할 수 있습니다.
문서에서 다루지 않는 내용
확인한 Data Connect 페이지에는 승인이 얼마나 오래 유효한지에 대한 설명이 없고, 요금도 나와 있지 않습니다. 또한 빠른 시작 가이드의 튜토리얼 설정 외에 라이선스 요구 사항은 나열되어 있지 않습니다.
관련 자료
데이터 원본
- Microsoft Graph Data Connect 개요
- Data Connect 빠른 시작
- Data Connect 자주 묻는 질문
- 데이터 세트, 리전 및 싱크
- Microsoft Graph 권한 개요
FAQ
Graph Data Connect와 Microsoft Graph API의 차이는 무엇인가요?
Microsoft Learn의 Data Connect FAQ에 따르면, 두 방식 모두 같은 기반 데이터에 서로 다른 방식으로 접근할 수 있게 해 줍니다. Data Connect는 조직 전체의 대량 데이터를 일괄 추출하도록 설계되어 있으며, Graph API는 선택한 사용자와 그룹의 적은 양의 데이터에 적합합니다.
Graph Data Connect 애플리케이션은 누가 승인하나요?
Microsoft의 빠른 시작 가이드에서는 관리자가 Microsoft 365 관리 센터의 설정 > 조직 설정 > 보안 및 개인 정보 보호 > Microsoft Graph Data Connect 애플리케이션에서 요청을 승인합니다. 이 가이드에는 자신이 만든 앱을 스스로 승인할 수 없다는 내용도 나와 있습니다.
파이프라인을 실행할 때마다 새로운 동의 요청이 필요한가요?
아닙니다. Data Connect FAQ에 따르면 데이터 세트, 열, 사용자, 싱크에 대한 범위가 그대로 유지되는 한 실행할 때마다 새로운 동의 요청이 필요하지 않습니다. 날짜만 다르고 동일한 범위로 실행하는 경우도 여기에 해당합니다.
앱은 위임된 권한과 애플리케이션 권한 중 무엇을 사용해야 하나요?
Microsoft Learn에 따르면 애플리케이션 권한은 권한 수준이 매우 높습니다. 최소 권한 관점에서는 앱의 요구를 충족하는 한 위임 모델을 권장합니다. 애플리케이션 권한에는 항상 관리자 동의가 필요합니다.