Valider l’installation de l’application cliente

S’applique à : ÉDITEUR DE LOGICIELS / DÉVELOPPEUR

Utilisez cet article après qu’un client a installé une application SharePoint Embedded. La validation confirme que l’inscription du type de conteneur, le consentement, la facturation, la visibilité de l’administration et les opérations de conteneur de base fonctionnent. Exécutez ces vérifications avec l’administrateur client avant d’annoncer l’application aux utilisateurs.

Importante

Validez dans le locataire client qui exécutera la charge de travail de production. Un test réussi dans votre locataire développeur ne prouve pas que le locataire client est inscrit, accepté ou facturé correctement.

Objectifs de validation

Réalisez ces objectifs avant de fermer l’intégration du client :

Vérifiez que l’application et le type de conteneur sont inscrits dans le locataire du client.
Vérifiez que les autorisations attendues sont accordées.
Vérifiez que la facturation est valide pour les applications directes.
Vérifiez que l’application peut créer un conteneur ou y accéder.
Vérifiez que l’administrateur client peut afficher l’application et le conteneur.
Vérifiez que les opérations de contenu fonctionnent pour un utilisateur de test.
Vérifiez que les modes d’échec courants ont été écartés.

Pour connaître les étapes de configuration du client, consultez Guide customers through tenant setup.

People impliqués

La validation nécessite généralement des rôles d’éditeur de logiciels indépendants et de clients.

Role	Responsabilité
Développeur d’éditeurs de logiciels indépendants	Fournit les ID d’application attendus, l’ID de type de conteneur, le comportement de l’application et la résolution des problèmes de support.
Administrateur général du client ou administrateur SharePoint Embedded	Confirme la visibilité de la configuration, de la facturation et de l’administration des applications SharePoint Embedded.
Propriétaire ou contributeur de facturation Azure client	Permet de résoudre les problèmes de configuration de la facturation directe.
Utilisateur de test client	Se connecte et effectue des actions de document au niveau de l’application.

Avant de commencer

Collectez ces valeurs :

Nom ou ID du locataire du client.
ID d’application propriétaire.
ID d’application pour les applications invitées, si votre application les utilise.
ID de type de conteneur.
Nom du type de conteneur.
Modèle de facturation.
Comportement de partage attendu.
Ticket de support ou enregistrement d’intégration.

Conseil

Conservez l’enregistrement de validation avec le package d’installation du client. Il permet aux futures équipes de support technique de distinguer les problèmes de configuration des régressions de produit.

Étape 1 : Confirmer l’inscription du type de conteneur

Vérifiez que le type de conteneur est inscrit dans le locataire consommateur. Une application ne peut pas créer ou interagir avec des conteneurs tant que son type de conteneur n’est pas inscrit dans ce locataire. Utilisez le portail d’installation ou le flux d’inscription de votre produit pour afficher l’état de l’inscription.

Demandez à l’administrateur client d’utiliser le Centre d’administration SharePoint pour vérifier que votre application SharePoint Embedded est répertoriée sous l’onglet Applications installées dans la page Applications actives sous SharePoint Embedded. L’administrateur client peut vérifier les détails de votre application SharePoint Embedded, par exemple :

ID d’application propriétaire.
ID de type de conteneur.

Si l’inscription n’est pas terminée, revenez à Guide clients via la configuration du locataire.

Étape 2 : Vérifier les autorisations

Pour vérifier que votre application est correctement installée sur le locataire du client :

À l’aide de l’application propriétaire, demandez un jeton d’accès pour l’étendue Microsoft Graph .default dans le locataire consommateur.
Vérifiez que le jeton d’accès inclut FileStorageContainer.Selected et dans la scp revendication (pour l’accès au nom d’un utilisateur) ou roles la revendication (pour l’accès FileStorageContainerTypeReg.Selected sans utilisateur).
Utilisez le jeton pour obtenir l’inscription de votre type de conteneur dans le locataire. Si une inscription est retournée, cela signifie que votre application SharePoint Embedded est correctement installée.

Conseil

Vous pouvez également vérifier que vos applications invitées sont correctement configurées en demandant un jeton d’accès pour l’étendue Microsoft Graph .default dans le locataire consommateur et en validant que les étendues/rôles attendus sont présents et que vous pouvez utiliser le jeton pour interagir avec le contenu. Seule l’application propriétaire peut accéder à l’inscription d’un type de conteneur dans un locataire.

Vérifiez que le client a accordé les autorisations attendues et qu’aucun ID d’application inattendu n’a été utilisé.

Pour la plupart des installations des clients, validez au moins ces autorisations :

Autorisation	Utilisation classique	Note de validation
`FileStorageContainerTypeReg.Selected`	Inscrivez le type de conteneur dans le locataire consommateur.	L’application peut demander cette autorisation en tant qu’autorisation déléguée ou d’application. Si l’inscription déléguée est utilisée, l’utilisateur qui effectue l’inscription doit être un administrateur SharePoint Embedded ou un administrateur général.
`FileStorageContainer.Selected`	Accédez aux conteneurs et au contenu de l’application installée.	L’autorisation d’application nécessite le consentement de l’administrateur ; l’autorisation déléguée ne le fait pas. Vérifiez que l’octroi correspond au comportement de l’application approuvé par le client.

Validez les éléments suivants :

Administration consentement a été accordé par un administrateur client autorisé pour les autorisations d’application si nécessaire.
L’ID d’application accepté correspond au package d’installation de l’éditeur de logiciels indépendants.
Le jeu d’autorisations inclut les autorisations d’inscription et de contenu attendues pour le modèle d’application.
Les autorisations d’application invitée sont présentes si nécessaire.
Le comportement délégué et d’application uniquement correspond à votre conception.
Les utilisateurs de test sont présents dans Microsoft Entra ID en tant que membres ou invités.

Attention

Ne poursuivez pas la validation si l’ID d’application ou l’éditeur ne correspond pas au package d’installation. Arrêtez et résolvez d’abord l’incompatibilité de consentement.

Si l’application propriétaire ou une application invitée ne dispose pas d’autorisations, revenez à Guide clients via la configuration du locataire.

Étape 3 : Vérifier les status de facturation

La validation de la facturation dépend du modèle de facturation sélectionné.

facturation Standard

Pour la facturation standard, vérifiez en interne que votre relation de facturation client développeur est active. Le client n’a pas besoin de configurer un profil de facturation SharePoint Embedded pour votre application. Indiquez toujours au client comment la consommation SharePoint Embedded est gérée pour votre application.

Vérifier:

L’application est documentée comme standard facturée.
Votre équipe des opérations peut surveiller la consommation.
Le transfert du client ne lui demande pas de configurer la facturation directe.

Facturation directe

Pour la facturation directe, aucun utilisateur ne peut accéder à l’application tant que le client n’a pas configuré une facturation valide. Demandez à l’administrateur client de confirmer la facturation dans le Centre d’administration Microsoft 365.

Vérifier:

Un abonnement Azure valide est connecté.
Un groupe de ressources valide est sélectionné.
La configuration a été effectuée pour les applications SharePoint Embedded.
L’administrateur de facturation client dispose des autorisations de propriétaire ou de contributeur si nécessaire.
Le client comprend que la désactivation de la facturation interrompt l’accès utilisateur.

Pour obtenir des conseils sur le modèle de facturation, consultez Choisir un modèle de facturation pour votre application.

Étape 4 : Créer ou ouvrir un conteneur de test

Utilisez le flux de produit normal de votre application pour créer ou ouvrir un conteneur de test dans le locataire du client. N’utilisez pas de chemin de validation masqué qui contourne les mêmes autorisations et l’inscription du type de conteneur que celles utilisées par les utilisateurs de production.

Valider:

L’application peut créer un conteneur du type de conteneur attendu.
L’application peut ouvrir un conteneur de test existant.
L’application peut charger un petit document de test.
L’application peut lire le document de test.
L’application peut mettre à jour ou supprimer le document de test si ces actions font partie du produit.
L’application signale les erreurs de manière à ce que le client et le support des éditeurs de logiciels indépendants puissent résoudre les problèmes.

Avertissement

Évitez la validation destructrice dans un conteneur de production existant. Utilisez un conteneur de test clairement identifié et supprimez le contenu du test une fois la validation terminée.

Étape 5 : Vérifier l’administration des conteneurs

Les administrateurs client peuvent utiliser le Centre d’administration SharePoint pour administrer leur installation de votre application SharePoint Embedded et de ses conteneurs :

Obtenez les détails des conteneurs pour l’application SharePoint Embedded.
Afficher les détails d’un conteneur spécifique.
Afficher les conteneurs triés par stockage.
Définissez une étiquette de confidentialité, le cas échéant.
Gérez les conteneurs supprimés le cas échéant.
Restaurez ou supprimez définitivement les conteneurs de test uniquement quand cela est prévu.

Pour obtenir des conseils sur l’administration des clients, voir Gérer les conteneurs dans le Centre d’administration SharePoint.

SharePoint Embedded utilise les fonctionnalités de sécurité et de conformité de Microsoft 365. Demandez à l’administrateur client de valider les paramètres importants pour l’application :

Comportement de partage externe.
Accès utilisateur invité.
Attentes des étiquettes de confidentialité.
Attentes en matière de rétention ou de suppression.
Exigences en matière d’audit ou de révision de conformité.
Exceptions de stratégie client, le cas échéant.

Si l’application nécessite une collaboration externe, vérifiez que les stratégies de partage client autorisent le comportement prévu. Si le partage est restreint, documentez l’impact sur le produit avant que les utilisateurs commencent à utiliser l’application.

Modes d’échec courants

Utilisez ce tableau lors de l’intégration.

Mode d’échec	Éléments à vérifier	Où établir un lien
L’application n’apparaît pas pour l’administrateur	Inscription du type de conteneur et ID d’application	Vue d’ensemble administrateur
Erreur de consentement	rôle Administration et autorisations attendues	Accorder le consentement de l’administrateur
Application directe inaccessible	Configuration de la facturation et abonnement Azure	Guider les clients tout au long de la configuration du locataire
Échec de la création du conteneur	Inscription, autorisations et facturation	Installer une application SharePoint Embedded
L’utilisateur invité ne peut pas accéder au contenu	Stratégie de partage et d’identité d’invité	Accorder le consentement et les autorisations de l’administrateur
Administration outils échouent	Attribution de rôle et accès aux outils d’administration	Vue d’ensemble administrateur
La facturation a été déconnectée	La création d’un nouveau conteneur est bloquée ; les conteneurs existants restent accessibles	Configurer la facturation dans Centre d’administration Microsoft 365

Liste de contrôle de validation

Utilisez cette liste de vérification comme signature finale du client.

[ ] L’administrateur du client a accordé le consentement de l’administrateur pour votre application.
[ ] L’inscription du type de conteneur est terminée.
[ ] L’administrateur client voit votre application SharePoint Embedded dans le Centre d’administration SharePoint.
[ ] La facturation est valide ou non requise pour le locataire client.
[ ] L’utilisateur de test peut se connecter à votre application.
[ ] Le conteneur de test peut être créé ou ouvert.
[ ] Fonctionnement des opérations de fichier de test.
[ ] L’administrateur client peut afficher l’application ou le conteneur dans les outils d’administration.
[ ] Les attentes en matière de partage et de conformité sont documentées.
[ ] Le contenu du test est supprimé ou conservé par accord.
[ ] Le transfert de support est terminé.

Après validation

Une fois la validation réussie :

Enregistrez la date, le locataire, l’ID d’application et l’ID de type de conteneur.
Enregistrez le modèle de facturation et le résultat de la configuration du client.
Partagez l’enregistrement de validation avec le client.
Déplacez l’application vers l’étape de mise en production ou de déploiement suivante.

Si la validation échoue, conservez le client dans la phase d’installation et résolvez l’échec avant un accès utilisateur étendu.

Étapes suivantes

Last updated on 2026-07-15