Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article décrit l’architecture du Kit de ressources d’extensibilité Microsoft Fabric et la façon dont les charges de travail personnalisées s’intègrent à la plateforme Fabric. ** Il explique les composants d’exécution, les flux entre le serveur frontal Fabric, votre charge de travail et les services Fabric, ainsi que comment le modèle de manifeste et d'élément donnent aux charges de travail une apparence native dans Fabric.
Composants architecturaux
Interface réseau (hôte)
L’interface Fabric est l’environnement hôte. Il restitue votre charge de travail en tant qu’iFrame et expose une API hôte sécurisée à l’iFrame afin que la charge de travail puisse interagir avec Fabric tout en restant isolée. L’hôte est responsable du démarrage de la charge de travail en fonction de son manifeste (points d’entrée, itinéraires et fonctionnalités), de la gestion des jetons d’authentification via l’ID Microsoft Entra et des appels de médiatisation de la charge de travail vers les API publiques et les services de plateforme Fabric.
Application web de charge de travail
Votre charge de travail est une application web (par exemple, React ou Angular) que vous hébergez dans votre cloud. Fabric le charge dans un iFrame et fournit des API hôtes à intégrer à la plateforme. L'application implémente les itinéraires et les interfaces utilisateur déclarés dans son manifeste, utilise des jetons d'ID Microsoft Entra (fournis par l'hôte) pour appeler les API publiques de Fabric et, si nécessaire, vos propres services d'arrière-plan, tout en suivant les directives de l'expérience utilisateur de Fabric pour qu'elle ressemble à une expérience native.
API publiques et service Fabric
Le service Fabric expose les API publiques pour la lecture et l’écriture de métadonnées et de contenu, la gestion des éléments et l’intégration à des fonctionnalités de plateforme. Les charges de travail appellent ces API à l’aide de jetons délimités émis via l’ID Microsoft Entra, par exemple pour effectuer des opérations CRUD et des actions de cycle de vie d’élément, accéder aux données et au contenu stockés dans OneLake et participer à des fonctionnalités d’espace de travail telles que la recherche et la découverte. Pour des conseils sur les points de terminaison, les étendues et les identités, consultez les API REST publiques Fabric.
Microsoft Entra (authentification)
L’authentification et l’autorisation sont gérées par l’ID Microsoft Entra. Le manifeste de la charge de travail déclare les autorisations dont elle a besoin ; l’hôte Fabric obtient les jetons appropriés et applique le consentement et l’accès en fonction de ces déclarations.
Modèle de charge de travail et manifeste
Les charges de travail sont définies par un manifeste qui décrit leur identité, leurs fonctionnalités, leurs itinéraires, leurs points d’entrée d’interface utilisateur et les autorisations requises. Le manifeste est le contrat entre votre application web et Fabric. Pour obtenir les instructions de schéma, d’exemples et de validation, consultez Vue d’ensemble du manifeste.
Éléments et participation native
Les charges de travail contribuent généralement à un ou plusieurs types d’éléments. Les éléments créés par votre charge de travail apparaissent dans les espaces de travail et se comportent comme des éléments Fabric natifs. Ils participent à la collaboration et au partage, sont détectables dans la recherche, suivent les opérations de cycle de vie et la gouvernance, et stockent des données via OneLake tout en utilisant des API publiques Fabric pour CRUD.
Flux de bout en bout
- Un utilisateur ouvre un espace de travail et accède à un élément ou un point d’entrée fourni par votre charge de travail.
- Le serveur frontal Fabric charge votre application web dans un iFrame basé sur le manifeste.
- L’hôte acquiert des jetons Microsoft Entra avec les étendues requises par votre charge de travail et expose une API hôte à l’iFrame.
- La charge de travail appelle les API publiques Fabric (et, le cas échéant, vos propres services) à l’aide de ces jetons.
- Les données d’élément sont stockées dans OneLake et les métadonnées d’élément sont gérées via les API Fabric afin qu’elles se comportent comme n’importe quel autre élément Fabric.
Étapes suivantes
Pour développer localement et publier votre charge de travail, consultez Publier votre charge de travail. Pour obtenir des conseils de schéma de manifeste et de développement local, consultez la vue d’ensemble du manifeste, DevServer et DevGateway. Pour les points de terminaison d’API, les étendues et les instructions d’identité, consultez les Fabric Public REST APIs.