Password Vault Vue d'ensemble
Password Vault conserve le coffre-fort de chaque utilisateur dans un fichier situé dans le dossier d'application du OneDrive de cet utilisateur. Pour lire et écrire ce fichier, le package de la solution demande exactement une autorisation Microsoft Graph : Files.ReadWrite.AppFolder. Un administrateur du locataire doit l'approuver une fois après le déploiement du package ; d'ici là, le composant WebPart ne peut ouvrir ni créer aucun coffre-fort. Cet article explique l'autorisation et son approbation.
Pourquoi Password Vault a besoin de cette autorisation
Le composant WebPart utilise Microsoft Graph pour trois opérations, toutes dans le dossier d'application du OneDrive de l'utilisateur connecté :
- rechercher le fichier du coffre-fort
vitextra-password-vault.json; - le créer la première fois que l'utilisateur ouvre Password Vault ;
- le lire et l'enregistrer après chaque modification.
Password Vault ne demande aucune autre autorisation Microsoft Graph et n'a besoin d'aucune autorisation sur les listes SharePoint : tout utilisateur qui peut ouvrir la page peut utiliser son propre coffre-fort.
Les utilisateurs doivent aussi disposer d’un OneDrive provisionné et d’un accès approuvé. L’erreur d’autorisation décrite ci-dessous suppose qu’aucune autre autorisation existante ne fournit l’accès nécessaire au fichier.
Ce que l'autorisation permet et ne permet pas
| Aspect | Détails |
|---|---|
| Type d'autorisation | Déléguée : elle fonctionne uniquement pour le compte de l'utilisateur connecté, et non sous une identité d’application indépendante |
| Permet | La lecture et l'écriture de fichiers dans le dossier d'application du propre OneDrive de l'utilisateur connecté |
| Ne permet pas | La lecture ou la modification des autres fichiers OneDrive de l'utilisateur, du OneDrive d'autres utilisateurs, des sites SharePoint, du courrier, des calendriers ou des données d'annuaire |
| Accès en tant qu'application (app-only) | Aucun ; Password Vault n'a pas de compte de service ni de processus en arrière-plan |
📝 Remarque
Dans SharePoint Online, les autorisations d'API des solutions SPFx sont accordées à une seule application Microsoft Entra ID partagée par toutes les solutions SPFx du locataire, SharePoint Online Client Extensibility Web Application Principal. Une fois Files.ReadWrite.AppFolder approuvée, elle est disponible pour chaque solution SPFx déployée dans votre locataire, et le dossier d'application est celui de cette application partagée. C'est ainsi que fonctionne SharePoint Framework pour tous les éditeurs. Ne déployez que des solutions SPFx auxquelles vous faites confiance ; consultez les remarques sur la sécurité dans KB10360. Comment approuver les autorisations d'API Microsoft Graph pour les solutions Vitextra dans le Centre d'administration SharePoint.
Approuver l'autorisation
La demande d'autorisation est créée lorsque le package Password Vault est déployé dans le catalogue d'applications du locataire (voir KB10035. Comment installer un produit Vitextra dans SharePoint Online). Vous devez disposer du rôle Administrateur général ; le rôle Administrateur SharePoint seul ne suffit pas pour approuver les autorisations Microsoft Graph. Microsoft
1. Ouvrez le Centre d'administration SharePoint.
2. Accédez à Avancé > Accès aux API.
3. Dans l'onglet Demandes en attente, sélectionnez la demande du package Vitextra Password Vault pour Microsoft Graph / Files.ReadWrite.AppFolder.
4. Cliquez sur Approuver et confirmez.
5. Vérifiez que l'autorisation apparaît désormais dans l'onglet Demandes approuvées.
Si Files.ReadWrite.AppFolder a déjà été approuvée pour une autre solution SPFx, aucune nouvelle demande n'apparaît : SharePoint réutilise l'autorisation existante. Les utilisateurs ne voient aucune invite de consentement ; après l'approbation, le composant WebPart fonctionne pour tout le monde dans le locataire, généralement en quelques minutes. Si ce n'est pas le cas, rechargez la page.
💡 Astuce
Pour les captures d'écran, les commandes PowerShell, l'approbation partielle, la révocation des autorisations et le comportement lors des mises à jour, consultez KB10360. Comment approuver les autorisations d'API Microsoft Graph pour les solutions Vitextra dans le Centre d'administration SharePoint.
Ce que voient les utilisateurs tant que l'autorisation n'est pas approuvée
Le package peut être déployé et le composant WebPart peut être ajouté à des pages alors que la demande est encore en attente. Sans l'autorisation, toutefois, le composant WebPart ne peut ni lire ni créer le coffre-fort. Au lieu de l'écran Configurer le code PIN ou de l'invite Entrez le code PIN, les utilisateurs voient le message « Désolé, nous avons rencontré un problème. Veuillez actualiser la page, puis réessayer. » avec un bouton Actualiser. Aucun fichier de coffre-fort n'est créé.
Après l'approbation, les utilisateurs cliquent sur Actualiser ou rechargent la page, et le composant WebPart s'ouvre normalement.
Le même message apparaît si une autorisation approuvée est ensuite supprimée dans l'onglet Demandes approuvées. La suppression de l'autorisation ne supprime aucun fichier de coffre-fort : les fichiers restent dans le OneDrive des utilisateurs et s'ouvrent à nouveau dès que l'autorisation est approuvée. Pour les autres causes de ce message, consultez KB10459. Pourquoi Password Vault ne se charge pas : « Nous avons rencontré un problème » et erreurs d'autorisation.
