Password Vault Información general
Password Vault guarda la bóveda de cada usuario en un archivo de la carpeta de aplicación de su OneDrive. Para leer y escribir este archivo, el paquete de la solución solicita exactamente un permiso de Microsoft Graph: Files.ReadWrite.AppFolder. Un administrador del inquilino debe aprobarlo una vez después de implementar el paquete; hasta entonces, el elemento web no puede abrir ni crear ninguna bóveda. Este artículo explica el permiso y su aprobación.
Por qué Password Vault necesita este permiso
El elemento web utiliza Microsoft Graph para tres operaciones, todas en la carpeta de aplicación del OneDrive del usuario que ha iniciado sesión:
- buscar el archivo de la bóveda
vitextra-password-vault.json; - crearlo la primera vez que el usuario abre Password Vault;
- leerlo y guardarlo después de cada cambio.
Password Vault no solicita ningún otro permiso de Microsoft Graph ni necesita permisos para listas de SharePoint: cualquier usuario que pueda abrir la página puede utilizar su propia bóveda.
Los usuarios también necesitan un OneDrive aprovisionado y acceso aprobado. El error de permisos descrito a continuación supone que ninguna otra concesión existente proporciona el acceso necesario al archivo.
Qué permite y qué excluye el permiso
| Aspecto | Detalles |
|---|---|
| Tipo de permiso | Delegado: actúa únicamente en nombre del usuario que ha iniciado sesión, no con una identidad de aplicación independiente |
| Permite | Leer y escribir archivos en la carpeta de aplicación del OneDrive del usuario que ha iniciado sesión |
| No permite | Leer o modificar otros archivos de OneDrive del usuario, el OneDrive de otros usuarios, sitios de SharePoint, correo, calendarios o datos del directorio |
| Acceso de aplicación (app-only) | Ninguno; Password Vault no tiene una cuenta de servicio ni un proceso en segundo plano |
📝 Nota
En SharePoint Online, los permisos de API de las soluciones SPFx se conceden a una única aplicación de Microsoft Entra ID compartida por todas las soluciones SPFx del inquilino: SharePoint Online Client Extensibility Web Application Principal. Una vez aprobado Files.ReadWrite.AppFolder, está disponible para todas las soluciones SPFx implementadas en el inquilino, y la carpeta de aplicación pertenece a esa aplicación compartida. Así funciona SharePoint Framework para todos los proveedores. Implemente solo soluciones SPFx en las que confíe; consulte las notas de seguridad en KB10360. Cómo aprobar los permisos de la API de Microsoft Graph para las soluciones de Vitextra en el centro de administración de SharePoint.
Cómo aprobar el permiso
La solicitud de permiso se crea al implementar el paquete de Password Vault en el catálogo de aplicaciones del inquilino; consulte KB10035. Cómo instalar un producto Vitextra en SharePoint Online. Se necesita el rol Administrador global; el rol de administrador de SharePoint por sí solo no basta para aprobar permisos de Microsoft Graph. Microsoft
1. Abra el Centro de administración de SharePoint.
2. Vaya a Opciones avanzadas > Acceso a API.
3. En la pestaña Solicitudes pendientes, seleccione la solicitud del paquete Vitextra Password Vault para Microsoft Graph / Files.ReadWrite.AppFolder.
4. Haga clic en Aprobar y confirme.
5. Compruebe que el permiso aparece ahora en la pestaña Solicitudes aprobadas.
Si Files.ReadWrite.AppFolder ya se aprobó para otra solución SPFx, no aparece una nueva solicitud: SharePoint reutiliza la concesión existente. Los usuarios no ven una solicitud de consentimiento; tras la aprobación, el elemento web funciona para todos los usuarios del inquilino, normalmente en unos minutos. Si no es así, recargue la página.
💡 Consejo
Consulte KB10360. Cómo aprobar los permisos de la API de Microsoft Graph para las soluciones de Vitextra en el centro de administración de SharePoint para ver capturas de pantalla, comandos de PowerShell, aprobación parcial, revocación de permisos y comportamiento durante las actualizaciones.
Qué ven los usuarios antes de aprobar el permiso
Se puede implementar el paquete y añadir el elemento web a las páginas mientras la solicitud está pendiente. Sin el permiso, no obstante, el elemento web no puede leer ni crear la bóveda. En lugar de la pantalla Configurar PIN o Introduzca el PIN, los usuarios ven el mensaje «Se ha producido un error. Actualice la página y vuelva a intentarlo.» y el botón Actualizar. No se crea ningún archivo de bóveda.
Tras la aprobación, los usuarios pulsan Actualizar o recargan la página, y el elemento web se abre con normalidad.
El mismo mensaje aparece si posteriormente se elimina un permiso aprobado en la pestaña Solicitudes aprobadas. Eliminar el permiso no borra los archivos de las bóvedas: permanecen en el OneDrive de los usuarios y vuelven a abrirse cuando se aprueba el permiso. Para conocer otras causas del mensaje, consulte KB10459. Por qué Password Vault no se carga: errores y problemas de permisos.
