Remarque
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.
S’applique à : Développeur
Utilisez cet article comme séquence de construction canonique pour une application SharePoint Embedded. Chaque étape est liée à la procédure détaillée de cette tâche.
Suivez cet ordre :
- Préparer les clients et l’inscription de l’application.
- Créez un type de conteneur.
- Configurez la facturation standard lorsque le propriétaire de l’application paie.
- Inscrivez le type de conteneur dans chaque locataire consommateur.
- Activer la facturation à l’utilisation dans le client consommateur lorsque le client paie.
- Créez un conteneur à partir d’un serveur principal confidentiel.
- Travaillez avec des fichiers via Microsoft Graph.
Importante
Inscrivez le type de conteneur dans le locataire consommateur avant de créer ou d’accéder aux conteneurs. Le consentement Microsoft Graph seul n’accorde pas l’accès aux conteneurs.
Choisir un chemin de génération
| Objectif | Chemin recommandé |
|---|---|
| Évaluer SharePoint Embedded pendant 30 jours | Créez un type de conteneur d’évaluation dans votre locataire de développeur. |
| Créer une application de production où le développeur paie | Créez un type de conteneur standard et joignez un profil de facturation Azure. |
| Créer une application mutualisée où chaque client paie | Créez un type de directToCustomer conteneur et demandez à chaque client consommateur d’activer la facturation à l’utilisation. |
| Démarrer avec les outils guidés | Utilisez le guide de démarrage rapide de Visual Studio Code. |
| Générer avec un agent de codage | Utilisez le serveur SharePoint Embedded Model Context Protocol (MCP). |
Une version d’évaluation est monolocataire et ne peut pas être convertie en production. Un client peut avoir un type de conteneur d’évaluation avec jusqu’à cinq conteneurs, y compris des conteneurs dans la corbeille. Chaque conteneur dispose de 1 Go de stockage et la version d’évaluation expire au bout de 30 jours.
1. Préparer les prérequis
Avant de générer, préparez-vous :
- Un client Microsoft 365 avec SharePoint disponible.
- Un administrateur Microsoft 365 qui peut effectuer la configuration du consentement et du client. Utilisez un administrateur général ou un administrateur SharePoint Embedded lorsque la procédure liée nécessite ce rôle.
- Comptes de membre ou d’invité Microsoft Entra ID pour chaque utilisateur qui s’authentifie à l’application.
- Inscription d’une application Microsoft Entra ID propriétaire du type de conteneur.
- Pour la facturation de production standard, un abonnement et un groupe de ressources Azure. La personne qui associe la facturation a besoin d’un accès Propriétaire ou Collaborateur.
- Visual Studio Code, Node.js et npm si vous utilisez l’exemple de démarrage rapide.
Pour le modèle de locataire, consultez Comprendre l’architecture de l’application et du locataire.
2. Créez l’application Microsoft Entra propriétaire
Créez ou sélectionnez l’application Microsoft Entra ID propriétaire du type de conteneur SharePoint Embedded. Une application propriétaire peut posséder exactement un type de conteneur.
Configurez les autorisations Microsoft Graph nécessaires pour les opérations effectuées par votre application :
| Autorisation | Utilisation |
|---|---|
FileStorageContainerType.Manage.All |
Créez et gérez le type de conteneur dans le client propriétaire. |
FileStorageContainerTypeReg.Selected |
Enregistrez le type de conteneur et ses autorisations d’application dans un client consommateur. |
FileStorageContainer.Selected |
Accédez aux conteneurs et aux fichiers du type de conteneur enregistré. |
Les exigences de consentement dépendent du type d’autorisation et du mode d’accès. Les autorisations d’application nécessitent le consentement de l’administrateur. Le consentement de l’administrateur délégué FileStorageContainer.Selected n’est pas nécessaire, mais l’utilisateur connecté a quand même besoin d’un rôle de conteneur.
Pour le modèle d’autorisation complet, consultez Planifier l’authentification et les autorisations et Configurer l’authentification et l’autorisation.
3. Créez le type de conteneur
Créez un type de conteneur dans le locataire propriétaire avec :
- Un nom d’affichage durable.
- ID de l’application propriétaire.
- Une classification de facturation :
trial,standard, oudirectToCustomer. - Paramètres de comportement facultatifs pour le partage, la recherche, la détectabilité, l’intégration d’Office, le contrôle de version, les redirections et le stockage.
Utilisez Microsoft Graph :
POST https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypes
Enregistrez l’ID de type de conteneur renvoyé. Chaque conteneur créé à partir de ce type porte cet ID, qui contrôle l’accès, les paramètres et la facturation.
Pour connaître les choix de demande et de configuration, consultez Créer et configurer un type de conteneur.
4. Configurer la facturation standard
Ignorez cette étape pour une version d’évaluation.
- Pour
standard, attachez un abonnement Azure et un groupe de ressources dans le locataire développeur. - Pour
directToCustomer, passez à l’inscription. Le client consommateur active la facturation à l’utilisation après l’inscription.
Les choix de facturation sont permanents pour un type de conteneur. Pour passer de la version d’évaluation à la facturation de production ou de facturation standard à la facturation directe, créez un type de conteneur.
Pour les chemins de décision et de configuration, consultez Choisir un modèle de facturation.
5. Inscrire le type de conteneur dans le client consommateur
Répétez cette étape pour chaque locataire qui utilise l’application.
- Créez le principal de service de l’application propriétaire dans le locataire consommateur.
- Demandez à l’administrateur client consommateur d’accorder le consentement Microsoft Graph requis.
- Utilisez l’application propriétaire pour inscrire le type de conteneur auprès de l’API Microsoft Graph
containerTypeRegistrations. - Accordez à l’application propriétaire et à toutes les applications invitées uniquement les autorisations d’application de type conteneur dont elles ont besoin.
- Validez l’inscription avant de créer des conteneurs. La propagation des mises à jour d’inscription et des autorisations peut prendre jusqu’à une heure. Par conséquent, réessayez avec une interruption limitée avant de traiter une demande d’inscription réussie comme non valide.
Pour une version d’évaluation, le client propriétaire et le client consommateur sont les mêmes locataires, mais l’inscription fait toujours partie du flux d’installation.
Pour directToCustomer, le client consommateur active la facturation à l’utilisation après l’inscription et avant la création du conteneur.
L’enregistrement crée la couche intermédiaire du modèle d’autorisation SharePoint Embedded :
- L’autorisation Microsoft Graph permet à l’application d’appeler l’API.
- L’autorisation d’application de type conteneur permet à l’application de travailler avec des conteneurs du type inscrit.
- Un rôle de conteneur contrôle ce qu’un utilisateur connecté peut faire dans un conteneur.
Pour la procédure API, voir Enregistrer les autorisations d’application.
6. Choisissez un accès délégué ou d’application uniquement
Utilisez l’accès délégué pour les opérations pilotées par l’utilisateur lorsque cela est possible. L’accès effectif est l’intersection des autorisations de type conteneur de l’application et du rôle de conteneur de l’utilisateur.
Utilisez l’accès à l’application uniquement pour les opérations en arrière-plan qui n’agissent pas pour un utilisateur. L’accès à l’application uniquement atteint les conteneurs autorisés par les autorisations de type de conteneur de l’application, appliquez donc le moindre privilège.
Les rôles de conteneur sont les suivants :
ReaderWriterManagerOwner
Lorsqu’un utilisateur délégué crée un conteneur, SharePoint Embedded lui attribue automatiquement le Owner rôle.
7. Créer le premier conteneur
Une fois l’inscription et la facturation valides, créez un conteneur de stockage de fichiers via Microsoft Graph. La création de conteneurs nécessite un jeton acquis par un client confidentiel, y compris lorsque la demande utilise des autorisations déléguées. Création de routes via un backend ou un autre composant pouvant contenir en toute sécurité les informations d’identification d’une application ; n’appelez pas cette API directement à partir d’un client public monopage, mobile ou de bureau. Traitez l’ID de conteneur renvoyé comme son ID de lecteur Graph.
POST https://graph.microsoft.com/v1.0/storage/fileStorage/containers
Un conteneur est une limite de sécurité et de contenu isolée. Choisissez une granularité de conteneur qui correspond à un objet métier, tel qu’un projet, une revendication, un cas, un espace de travail client ou une data room.
Pour la procédure complète, consultez Créer et gérer des conteneurs.
8. Effectuer la première opération de fichier
Traiter le contenu du conteneur via les API DriveItem Microsoft Graph sous /drives/{containerId}/items.
Pour un premier test de fumée :
- Créer un dossier.
- Chargez un petit fichier avec une seule
PUTrequête. - Lisez le DriveItem renvoyé.
- Téléchargez le fichier avec
GET /drives/{containerId}/items/{itemId}/content. - Supprimez et restaurez le fichier de test.
Utilisez une session de chargement pour les fichiers d’une taille supérieure à 250 Mo. Les réponses de téléchargement peuvent rediriger vers une URL préauthentifiée de courte durée. Ne stockez pas ou ne mettez pas en cache cette URL ; demander une nouvelle URL pour un téléchargement ultérieur.
Pour les opérations sur les fichiers et les dossiers, reportez-vous à la section Charger, télécharger et gérer les fichiers.
9. Ajoutez les expériences d’application dont vous avez besoin
| Tâche | Fonctionnalité intégrée et article suivant |
|---|---|
| Ouvrir et co-créer des fichiers Office | Office sur le Web et Desktop prennent en charge la co-création, l’enregistrement automatique et l’historique automatique des versions. Consultez Ouvrir des fichiers Office à partir de votre application. |
| Afficher un aperçu des fichiers PDF et d’autres fichiers pris en charge | Générez une URL d’aperçu intégrable avec l’API d’aperçu DriveItem. Afficher un aperçu des fichiers dans votre application. |
| Partager un fichier sans accès à l’échelle du conteneur | Ajouter une autorisation DriveItem. Voir Partager des fichiers et gérer les autorisations. |
| Interroger des valeurs de métadonnées connues | Stockez les valeurs et utilisez les filtres OData pris en listItem/fields charge. Voir Stocker et interroger les métadonnées des conteneurs. |
| Récupérer du contenu supprimé | Restaurez des fichiers à partir de la Corbeille et des conteneurs à partir de la collection de conteneurs supprimés. La fenêtre normale de récupération de conteneur supprimé est de 93 jours, sauf si un administrateur supprime définitivement le conteneur ou si les exigences de rétention affectent la suppression finale. |
SharePoint Embedded prend en charge tous les types de fichiers. Les expériences de collaboration et d’historique des versions spécifiques à Office s’appliquent aux fichiers Word, Excel et PowerPoint pris en charge.
10. Valider le chemin de production
Avant d’intégrer des utilisateurs ou des clients, vérifiez :
- L’application propriétaire et le type de conteneur ont une relation un-à-un.
- Chaque client consommateur dispose du principal du service, du consentement et de l’inscription du type de conteneur.
- La facturation est valable pour une utilisation en production standard ou directe.
- L’application demande uniquement Microsoft Graph et les autorisations de type conteneur dont elle a besoin.
- Les opérations pilotées par l’utilisateur utilisent l’accès délégué lorsque cela est possible.
- Les rôles de conteneur et le partage au niveau de l’élément correspondent à votre modèle d’accès.
- Les flux de chargement, de téléchargement, de lancement d’Office, d’aperçu, de suppression et de restauration gèrent les erreurs et les URL expirées.
- Le locataire consommateur peut appliquer des stratégies d’audit, de rétention, de protection contre la perte de données, d’eDiscovery, d’étiquette de confidentialité et d’accès conditionnel.
Pour l’intégration des clients, continuez à Préparer votre application pour une installation cliente.
Étapes suivantes
- Commencer avec les outils guidés : Démarrage rapide : Créez votre première application avec VS Code.
- Créez la ressource principale manuellement : Créez et configurez un type de conteneur.
- Passez en revue la conception d’accès : planifiez l’authentification et les autorisations.