Guidez les clients dans la configuration du client

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

Utilisez cet article pour créer le guide de configuration que vous remettez aux clients qui installent votre application SharePoint Embedded mutualisée. L’administrateur client est l’administrateur client qui gère les applications SharePoint Embedded inscrites dans le locataire Microsoft 365 et les conteneurs qui détiennent le contenu client.

Rôle d’administrateur du client

Indiquez aux clients qui doit effectuer la configuration. Un administrateur client consommateur est soit un administrateur général , soit un utilisateur affecté au rôle d’administrateur SharePoint Embedded . Le rôle est disponible dans Microsoft Entra ID et le Centre d’administration Microsoft 365. Les administrateurs généraux disposent déjà de ces autorisations.

Pour plus d’informations sur le rôle, voir Installer une application SharePoint Embedded.

Conditions préalables pour le client

Demandez au client de confirmer ces prérequis avant la réunion d’installation ou la fenêtre d’installation.

Les utilisateurs n’ont pas besoin d’une licence Office pour collaborer sur des documents Microsoft Office stockés dans un conteneur, à l’exception des expériences exceptionnelles documentées telles que les mentions.

Informations à donner au client

Indiquez ces valeurs dans votre guide de configuration :

• Nom du produit.
• Nom de l’éditeur.
• ID d’application propriétaire.
• ID du type de conteneur.
• Nom du type de conteneur.
• Modèle de facturation.
• Autorisations Microsoft Entra vos demandes d’application.
• Instructions de consentement pour votre application.
• URL de redirection ou de connexion utilisée par l’application.
• Contact du support technique.
• Durée d’installation prévue.
• Étapes de validation.

Pour obtenir des instructions de préparation des éditeurs de logiciels indépendants, consultez Préparer votre application pour une installation client.

Autorisations demandées par votre application

Indiquez aux clients exactement les autorisations Microsoft Graph dont votre application a besoin et pourquoi. Les applications SharePoint Embedded s’installent avec deux autorisations.

Vue d’ensemble de la configuration pour les clients

Utilisez cette séquence de haut niveau dans votre guide du client :

1. Attribuez le rôle d’administrateur approprié.
2. Examinez l’éditeur de l’application, les ID d’application et les autorisations demandées.
3. Accordez le consentement de l’administrateur si nécessaire.
4. Inscrivez le type de conteneur SharePoint Embedded dans le client consommateur via le flux d’installation de votre application.
5. Configurez la facturation directe si nécessaire.
6. Vérifiez que l’application apparaît à l’administrateur du client.
7. Créez ou accédez à un conteneur de test.
8. Vérifiez que l’application peut effectuer les opérations de fichier attendues.
9. Supprimez ou conservez le contenu du test conformément à la stratégie de validation du client.

Étape 1 : Affecter l’administrateur

Demandez au client de choisir un administrateur SharePoint Embedded ou un administrateur général pour la configuration des applications et des conteneurs. Si l’application utilise la facturation directe, assurez-vous qu’un administrateur de facturation ou un administrateur général termine la configuration de la facturation dans le Centre d’administration Microsoft 365.

Demandez au client de terminer les attributions de rôles requises avant la fenêtre d’installation. Cela permet d’éviter les retards lors de l’installation et de la validation.

Étape 2 : Examen de la demande

Demandez à l’administrateur client de réviser :

• Identité de l’éditeur.
• ID d’application.
• ID du type de conteneur.
• Autorisations demandées (voir Autorisations demandées par votre application).
• Données stockées dans des conteneurs SharePoint Embedded.
• Si l’application autorise l’accès invité.
• Engagements en matière de support et de réponse aux incidents.
• Modèle de facturation.

Si votre flux d’installation est hébergé dans votre portail d’administration Saas, incluez des captures d’écran ou des valeurs spécifiques au locataire dans votre transfert, et maintenez les liens stables afin que les administrateurs client puissent réutiliser le guide pour la production et la récupération d’urgence.

Étape 3 : Accorder le consentement de l’administrateur

L’administrateur du client accorde son consentement pour les autorisations requises par votre application. Documentez l’expérience de consentement exacte pour votre application plutôt que d’envoyer une URL de consentement brute sans expliquer ce qu’elle fait.

Donnez ces conseils au client :

1. Connectez-vous avec le compte administrateur du client.
2. Ouvrez la configuration de l’application ou l’expérience de consentement que vous fournissez.
3. Passez en revue l’éditeur et les autorisations demandées.
4. Accordez le consentement uniquement lorsque l’éditeur et les autorisations correspondent au transfert du client.
5. Enregistrez l’heure et l’administrateur qui a donné le consentement.

Les administrateurs client ne doivent accorder leur consentement qu’à l’ID exact de l’application dans votre package d’installation signé. Le consentement à un autre ID d’application constitue un risque de sécurité.

Étape 4 : Inscrire le type de conteneur

Avant que l’application puisse créer et utiliser des conteneurs, le type de conteneur doit être inscrit auprès du client consommateur. Ce flux étant spécifique à l’application, associez les clients à l’expérience de configuration de votre produit et à la documentation d’inscription actuelle.

Demandez au client de confirmer que :

• Le flux d’installation utilise l’ID d’application propriétaire attendu.
• L’inscription cible l’ID de type de conteneur attendu.
• L’inscription se termine dans le locataire du client.
• Les messages d’erreur sont capturés avec les informations d’heure, de locataire et de corrélation, le cas échéant.

Étape 5 : Configurer la facturation si nécessaire

Ignorez cette étape lorsque votre application utilise la facturation standard. Si votre application utilise la facturation directe, informez le client que la facturation SharePoint Embedded doit être configurée pour que les utilisateurs puissent accéder à l’application.

Le client a besoin d’un abonnement et d’un groupe de ressources Azure valides. Un administrateur de facturation ou un administrateur général configure la facturation dans le Centre d’administration Microsoft 365. Cet administrateur a également besoin du rôle Propriétaire ou Contributeur pour l’abonnement Azure. Configurez ensuite la facturation :

1. Ouvrez le Centre d’administration Microsoft 365.
2. Accédez à Configurer> lafacturation et les licences, puis sélectionnez Activer les services de paiement à l’utilisation.
3. Sous Services Syntex pour, sélectionnez Applications, puis SharePoint Embedded.
4. Suivez les instructions de la page SharePoint Embedded pour activer les applications SharePoint Embedded.

Étape 6 : Valider la visibilité de l’administration

Une fois le consentement, l’inscription et la facturation terminés, demandez à l’administrateur client de confirmer que l’application peut être gérée. Les administrateurs peuvent utiliser le Centre d’administration SharePoint et d’autres outils d’administration pour gérer les applications et conteneurs SharePoint Embedded.

Les administrateurs client peuvent :

• Énumérer les applications dans le locataire.
• Énumérer les conteneurs d’une application.
• Afficher les détails du conteneur.
• Affichez les conteneurs actifs et supprimés dans les expériences d’administration.
• Gérez les étiquettes de confidentialité et les paramètres de partage lorsqu’ils sont pris en charge.
• Examinez le comportement en matière de sécurité et de conformité.

Pour connaître les étapes de validation plus approfondies, consultez Valider l’installation d’une application cliente.

Liste de contrôle pour la configuration client

Donnez aux clients une liste de contrôle qu’ils peuvent approuver.

• [ ] Un administrateur SharePoint Embedded ou administrateur général est affecté à la configuration des applications et des conteneurs.
• [ ] Un administrateur de facturation ou un administrateur général est disponible pour terminer la configuration de la facturation directe, si nécessaire.
• [ ] L’ID de l’application et l’éditeur correspondent au transfert ISV.
• [ ] Administration consentement est accordé pour l’application attendue.
• [ ] Le type de conteneur est enregistré dans le client consommateur.
• [ ] La facturation directe est configurée, si nécessaire.
• [ ] Un utilisateur de test peut se connecter à l’application.
• [ ] Un conteneur de test peut être créé ou ouvert.
• [ ] Un document de test peut être téléchargé, lu et supprimé.
• [ ] L’administrateur client peut afficher l’application ou les conteneurs dans les outils d’administration.
• [ ] Les notes de validation et les contacts d’assistance sont enregistrés.

Résolution des problèmes pendant l’installation

Utilisez ce tableau pour acheminer les problèmes de configuration précoce.

Étapes suivantes

Après l’installation, validez l’installation avec l’administrateur client : Valider l’installation de l’application cliente.