이 문서에서는 Microsoft Fabric 확장성 도구 키트의 아키텍처와 사용자 지정 워크로드가 패브릭 플랫폼과 통합되는 방법에 대해 설명합니다. 이 문서에서는 런타임 구성 요소, 패브릭 프런트 엔드, 워크로드 및 패브릭 서비스 간의 흐름 및 매니페스트 및 항목 모델이 패브릭에서 워크로드를 네이티브로 만드는 방법을 설명합니다.
아키텍처 구성 요소
패브릭 프런트 엔드(호스트)
패브릭 프런트 엔드는 호스트 환경입니다. 워크로드를 iFrame으로 렌더링하고 iFrame에 보안 호스트 API를 노출하므로 워크로드가 격리된 상태로 유지되는 동안 패브릭과 상호 작용할 수 있습니다. 호스트는 매니페스트(진입점, 경로 및 기능)에 따라 워크로드를 부트스트래핑하고, Microsoft Entra ID를 통해 인증 토큰을 관리하고, 워크로드에서 패브릭 공용 API 및 플랫폼 서비스로의 호출을 중재합니다.
워크로드 웹 애플리케이션
워크로드는 클라우드에서 호스트하는 웹 애플리케이션(예: React 또는 Angular)입니다. 패브릭은 iFrame에 로드하고 플랫폼과 통합할 호스트 API를 제공합니다. 앱은 매니페스트에 선언된 경로 및 UI 화면을 구현하고, Microsoft Entra ID 토큰(호스트에서 제공)을 사용하여 Fabric 공용 API를 호출하고, 필요한 경우 사용자 고유의 백 엔드 서비스를 호출하고, 네이티브 환경처럼 보이고 동작하도록 패브릭 UX 지침을 따릅니다.
패브릭 서비스 및 공용 API
Fabric 서비스는 메타데이터 및 콘텐츠를 읽고 쓰고, 항목을 관리하고, 플랫폼 기능과 통합하기 위한 공용 API를 노출합니다. 워크로드는 Microsoft Entra ID를 통해 발급된 범위가 지정된 토큰을 사용하여 이러한 API를 호출합니다. 예를 들어 항목 CRUD 작업 및 수명 주기 작업을 수행하고 , OneLake에 저장된 데이터 및 콘텐츠에 액세스하고, 검색 및 검색과 같은 작업 영역 기능에 참여합니다. 엔드포인트, 범위 및 ID 지침은 패브릭 공용 REST API를 참조하세요.
Microsoft Entra(인증)
인증 및 권한 부여는 Microsoft Entra ID에 의해 처리됩니다. 워크로드의 매니페스트는 필요한 권한을 선언합니다. 패브릭 호스트는 적절한 토큰을 가져오고 해당 선언에 따라 동의 및 액세스를 적용합니다.
워크로드 모델 및 매니페스트
워크로드는 ID, 기능, 경로, UI 진입점 및 필요한 권한을 설명하는 매니페스트에 의해 정의됩니다. 매니페스트는 웹앱과 패브릭 간의 계약입니다. 스키마, 예제 및 유효성 검사 지침은 매니페스트 개요를 참조하세요.
항목 및 네이티브 참여
워크로드는 일반적으로 하나 이상의 항목 유형을 제공합니다. 워크로드에서 만든 항목은 작업 영역에 표시되고 네이티브 패브릭 항목처럼 동작합니다. 공동 작업 및 공유에 참여하고, 검색에서 검색할 수 있으며, 수명 주기 작업 및 거버넌스를 따르고, CrUD용 패브릭 공용 API를 사용하는 동안 OneLake를 통해 데이터를 저장합니다.
종단 간 흐름
- 사용자가 작업 영역을 열고 워크로드에서 제공하는 항목 또는 진입점으로 이동합니다.
- 패브릭 프런트 엔드는 매니페스트를 기반으로 iFrame에서 웹 애플리케이션을 로드합니다.
- 호스트는 워크로드에 필요한 범위로 Microsoft Entra 토큰을 획득하고 호스트 API를 iFrame에 노출합니다.
- 워크로드는 이러한 토큰을 사용하여 Fabric 공용 API(및 해당하는 경우 사용자 고유의 서비스)를 호출합니다.
- 항목 데이터는 OneLake에 저장되고 항목 메타데이터는 패브릭 API를 통해 관리되므로 다른 패브릭 항목처럼 동작합니다.
다음 단계
로컬로 개발하고 워크로드를 게시하려면 워크로드 게시를 참조하세요. 매니페스트 스키마 및 로컬 개발 지침은 매니페스트 개요, DevServer 및 DevGateway를 참조하세요. API 엔드포인트, 범위 및 ID 지침은 Fabric 공용 REST API를 참조하세요.