Password Vault Overzicht
Password Vault bewaart de kluis van elke gebruiker in een bestand in de app-map van diens OneDrive. Voor het lezen en schrijven van dit bestand vraagt het oplossingspakket precies één Microsoft Graph-machtiging aan: Files.ReadWrite.AppFolder. Een tenantbeheerder moet deze na de implementatie van het pakket eenmalig goedkeuren. Tot die tijd kan het webonderdeel geen kluizen openen of aanmaken. Dit artikel beschrijft de machtiging en de goedkeuring.
Waarom Password Vault de machtiging nodig heeft
Het webonderdeel gebruikt Microsoft Graph voor drie bewerkingen, allemaal in de OneDrive-app-map van de aangemelde gebruiker:
- het kluisbestand
vitextra-password-vault.jsonzoeken; - het bestand aanmaken wanneer de gebruiker Password Vault voor het eerst opent;
- het bestand lezen en na elke wijziging opslaan.
Password Vault vraagt geen andere Microsoft Graph-machtigingen aan en heeft geen machtigingen voor SharePoint-lijsten nodig. Elke gebruiker die de pagina kan openen, kan zijn of haar eigen kluis gebruiken.
Gebruikers hebben ook een ingerichte OneDrive en goedgekeurde toegang nodig. De hieronder beschreven machtigingsfout gaat ervan uit dat geen andere bestaande machtiging de benodigde bestandstoegang biedt.
Wat de machtiging toestaat en uitsluit
| Aspect | Details |
|---|---|
| Type machtiging | Gedelegeerd: werkt uitsluitend namens de aangemelde gebruiker, niet onder een zelfstandige toepassingsidentiteit |
| Toegestaan | Bestanden lezen en schrijven in de app-map van de eigen OneDrive van de aangemelde gebruiker |
| Niet toegestaan | Andere OneDrive-bestanden van de gebruiker, OneDrive van andere gebruikers, SharePoint-sites, e-mail, agenda’s of adreslijstgegevens lezen of wijzigen |
| Toegang als toepassing (app-only) | Geen; Password Vault heeft geen serviceaccount en geen achtergrondproces |
📝 Opmerking
In SharePoint Online worden API-machtigingen van SPFx-oplossingen verleend aan één Microsoft Entra ID-toepassing die alle SPFx-oplossingen in de tenant delen: SharePoint Online Client Extensibility Web Application Principal. Zodra Files.ReadWrite.AppFolder is goedgekeurd, is deze beschikbaar voor elke SPFx-oplossing in uw tenant. De app-map is die van de gedeelde toepassing. Zo werkt SharePoint Framework voor alle leveranciers. Implementeer alleen SPFx-oplossingen die u vertrouwt; zie de beveiligingsopmerkingen in KB10360. Microsoft Graph API-machtigingen voor Vitextra-oplossingen goedkeuren in het SharePoint-beheercentrum.
De machtiging goedkeuren
De machtigingsaanvraag wordt aangemaakt wanneer het Password Vault-pakket wordt geïmplementeerd in de app-catalogus van de tenant; zie KB10035. Een Vitextra-product installeren in SharePoint Online. Hiervoor hebt u de rol Globale beheerder nodig; alleen de rol SharePoint-beheerder is niet voldoende voor Microsoft Graph-machtigingen. Microsoft
1. Open het SharePoint-beheercentrum.
2. Ga naar Geavanceerd > API-toegang.
3. Selecteer op het tabblad Aanvragen in behandeling de aanvraag van het pakket Vitextra Password Vault voor Microsoft Graph / Files.ReadWrite.AppFolder.
4. Klik op Goedkeuren en bevestig.
5. Controleer of de machtiging nu op het tabblad Goedgekeurde aanvragen staat.
Als Files.ReadWrite.AppFolder al is goedgekeurd voor een andere SPFx-oplossing, verschijnt er geen nieuwe aanvraag: SharePoint gebruikt de bestaande toekenning. Gebruikers krijgen geen toestemmingsvenster. Na de goedkeuring werkt het webonderdeel voor iedereen in de tenant, doorgaans binnen enkele minuten. Laad de pagina opnieuw als dat niet het geval is.
💡 Tip
Zie KB10360. Microsoft Graph API-machtigingen voor Vitextra-oplossingen goedkeuren in het SharePoint-beheercentrum voor schermafbeeldingen, PowerShell-opdrachten, gedeeltelijke goedkeuring, het intrekken van machtigingen en het gedrag tijdens updates.
Wat gebruikers zien vóór de goedkeuring
Het pakket kan worden geïmplementeerd en het webonderdeel kan aan pagina’s worden toegevoegd terwijl de aanvraag nog in behandeling is. Zonder de machtiging kan het webonderdeel de kluis echter niet lezen of aanmaken. In plaats van Pincode instellen of Voer de pincode in zien gebruikers de melding 'Er is iets misgegaan. Vernieuw de pagina en probeer het nogmaals.' met de knop Vernieuwen. Er wordt geen kluisbestand aangemaakt.
Na de goedkeuring klikken gebruikers op Vernieuwen of laden ze de pagina opnieuw. Het webonderdeel opent dan normaal.
Dezelfde melding verschijnt als een goedgekeurde machtiging later wordt verwijderd op het tabblad Goedgekeurde aanvragen. Daardoor worden geen kluisbestanden verwijderd: deze blijven in de OneDrive van de gebruikers staan en kunnen weer worden geopend zodra de machtiging opnieuw is goedgekeurd. Zie KB10459. Waarom Password Vault niet wordt geladen: foutmeldingen en machtigingsproblemen voor andere oorzaken van deze melding.
