Valider l’installation de l’application client

S’applique à : éditeurs de logiciels indépendants

Utilisez cet article après qu’un client a installé une application SharePoint Embedded. La validation confirme que l’enregistrement 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.

Objectifs de validation

Remplissez ces objectifs avant de conclure l’intégration des clients :

1. Vérifiez que l’application et le type de conteneur sont inscrits dans le client du client.
2. Vérifiez que les autorisations attendues sont accordées.
3. Vérifiez que la facturation est valide pour les applications directes.
4. Vérifiez que l’application peut créer ou accéder à un conteneur.
5. Vérifiez que l’administrateur du client peut afficher l’application et le conteneur.
6. Vérifiez que les opérations de contenu fonctionnent pour un utilisateur test.
7. Confirmez que les modes d’échec courants ont été exclus.

Pour connaître la procédure de configuration du client, reportez-vous à la rubrique Guide des clients à travers la configuration du client.

People involved

La validation a généralement besoin des éditeurs de logiciels indépendants et des rôles client.

Avant de commencer

Collectez les valeurs suivantes :

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

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

Vérifiez que le type de conteneur est enregistré dans le client 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 client. Utilisez le portail de configuration de votre produit ou le flux d’inscription pour afficher l’état de l’inscription.

Demandez à l’administrateur client d’ouvrir le Centre d’administration SharePoint, d’accéder à Applicationsactives> installées de SharePoint Embedded>et de vérifier que votre application SharePoint Embedded est répertoriée. L’administrateur client peut vérifier les détails de votre application SharePoint Embedded, tels que :

• ID de l’application propriétaire.
• ID du type de conteneur.

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

Étape 2 : Vérifier les autorisations

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

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

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 clientes, validez au moins les autorisations suivantes :

Validez les éléments suivants :

• Administration consentement a été accordé par un administrateur client autorisé pour les autorisations d’application lorsque cela est nécessaire.
• L’ID d’application approuvé correspond au package d’installation de l’éditeur de logiciels indépendant.
• L’ensemble 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.

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

Étape 3 : Vérifier le status de facturation

La validation de 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 de locataire 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 de SharePoint Embedded est gérée pour votre application.

Vérifiez :

• L’application est documentée comme facturée en standard.
• Votre équipe d’exploitation peut surveiller la consommation.
• Le transfert client ne demande pas au client 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érifiez :

• 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 client qui configure la facturation dispose du rôle Propriétaire ou Contributeur pour l’abonnement Azure, le cas échéant.
• Le client comprend que la désactivation de la facturation interrompt l’accès utilisateur.

Pour obtenir des instructions 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 client client. N’utilisez pas un chemin de validation masqué qui contourne les autorisations et l’inscription de type de conteneur 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 télé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 d’une manière que le client et le support ISV peuvent résoudre.

Étape 5 : vérifier l’administration du conteneur

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

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

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

Étape 6 : Vérifier les attentes en matière de partage et de conformité

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 de l’étiquette de confidentialité.
• Attentes en matière de rétention ou de suppression.
• Exigences en matière d’audit ou d’examen de conformité.
• Exceptions à la politique du 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 ne commencent à utiliser l’application.

Modes d’échec courants

Utilisez ce tableau lors de l’intégration.

Liste de vérification de la validation

Utilisez cette liste de contrôle comme validation finale du client.

• [ ] L’administrateur du client a obtenu le consentement administrateur pour votre application.
• [ ] L’enregistrement du type de conteneur est terminé.
• [ ] L’administrateur du client voit votre application SharePoint Embedded dans le Centre d’administration SharePoint.
• [ ] La facturation est valide ou n’est pas requise pour le client client.
• [ ] L’utilisateur test peut se connecter à votre application.
• [ ] Le conteneur de test peut être créé ou ouvert.
• [ ] Les opérations de fichier de test fonctionnent.
• [ ] L’administrateur du 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 du support est terminé.

Après validation

Une fois la validation réussie :

1. Enregistrez la date, le locataire, l’ID d’application et l’ID de type de conteneur.
2. Enregistrez le modèle de facturation et le résultat de la configuration client.
3. Partagez l’enregistrement de validation avec le client.
4. Déplacez l’application à l’étape de publication ou de déploiement suivante.

En cas d’échec de la validation, maintenez le client dans la phase d’installation et résolvez l’échec avant un accès large à l’utilisateur.

Étapes suivantes

• Vue d’ensemble administrateur
• Installer une application SharePoint Embedded
• Résolution des problèmes