Cuando migra una biblioteca de documentos de un entorno de SharePoint a otro, la biblioteca a menudo conserva la herencia de permisos de la estructura del sitio o de la biblioteca anterior. Esto significa que los usuarios que no deberían tener acceso aún pueden ver o editar archivos, lo que crea brechas de seguridad. La causa es que las herramientas de migración copian la biblioteca con sus permisos únicos o configuraciones heredadas del origen intactas. Este artículo explica cómo romper la herencia de permisos en la biblioteca migrada y aplicar permisos nuevos y correctos.
Puntos clave: Cómo restablecer permisos en una biblioteca migrada
- Configuración de la biblioteca de SharePoint > Permisos para esta biblioteca de documentos: Use esta ruta para romper la herencia y administrar permisos únicos.
- Botón Dejar de heredar permisos: Haga clic aquí para desconectar la biblioteca de los permisos de su sitio o biblioteca principal.
- Eliminar permisos únicos después de la migración: Use PowerShell o el centro de administración de SharePoint para eliminar en masa los permisos heredados de las bibliotecas migradas.
Por qué las bibliotecas migradas conservan la herencia de permisos antigua
Cuando migra una biblioteca de documentos de SharePoint con herramientas como ShareGate, Metalogix o la Herramienta de migración de SharePoint nativa, la herramienta copia la biblioteca junto con su configuración de permisos. Si la biblioteca de origen tenía permisos únicos no heredados del elemento principal, la copia migrada conserva esos permisos únicos. Si la biblioteca de origen heredaba permisos de su sitio principal, la copia migrada intentará heredar del nuevo sitio principal, que puede tener un conjunto de permisos diferente. Esta discrepancia hace que la biblioteca aparezca con la herencia de permisos antigua, lo que a menudo permite accesos no intencionados.
El comportamiento técnico de raíz es que SharePoint almacena la herencia de permisos como una propiedad en cada objeto protegible (sitio, biblioteca, carpeta, elemento). Las herramientas de migración replican esta propiedad exactamente. Después de la migración, debe romper o restaurar manualmente la herencia para que coincida con su entorno de destino. El proceso de migración en sí no restablece automáticamente los permisos a los valores predeterminados del destino.
Permisos heredados frente a permisos únicos en SharePoint
En SharePoint, toda biblioteca comienza heredando permisos de su sitio principal. Cuando rompe la herencia, la biblioteca obtiene su propia lista de control de acceso (ACL) independiente de la principal. Después de la migración, la biblioteca puede mostrarse como heredera del nuevo sitio principal, pero el acceso real de los usuarios aún puede reflejar la configuración del origen anterior. Esto se debe a que la herramienta de migración puede copiar la ACL pero marcarla como heredada, lo que genera confusión. Verifique siempre el modo de permisos después de la migración.
Pasos para romper la herencia de permisos en una biblioteca migrada
Siga estos pasos para asegurarse de que la biblioteca migrada use la herencia de permisos correcta. Necesitará al menos permisos de Edición en la biblioteca o Control total en el sitio.
- Abra la configuración de la biblioteca
Vaya a la biblioteca migrada en el sitio de SharePoint de destino. Haga clic en el icono de engranaje (Configuración) en la esquina superior derecha y, a continuación, seleccione Configuración de la biblioteca. Si está en una página moderna de SharePoint, haga clic en el menú de la cinta y elija Configuración > Configuración de la biblioteca. - Compruebe la herencia de permisos actual
En el panel de navegación izquierdo de Configuración de la biblioteca, haga clic en Permisos para esta biblioteca de documentos. Verá un banner que indica “Esta biblioteca hereda permisos de su elemento principal” o “Esta biblioteca tiene permisos únicos”. Si dice que hereda, continúe con el paso siguiente. Si dice que es única, puede conservar los permisos únicos o restaurar la herencia del elemento principal. - Deje de heredar permisos
Haga clic en el botón Dejar de heredar permisos en la cinta. Aparece un cuadro de diálogo de confirmación. Haga clic en Aceptar. La biblioteca ahora tiene permisos únicos, pero la ACL antigua de la migración aún está presente. Ahora debe quitar los usuarios o grupos no deseados. - Quite los usuarios y grupos migrados
En la página Permisos, verá una lista de usuarios y grupos. Marque las casillas junto a los que provengan del origen anterior y no deban tener acceso. Haga clic en Quitar permisos de usuario en la cinta. Confirme la eliminación. Repita hasta que solo queden los usuarios correctos. - Agregue los permisos correctos
Haga clic en Conceder permisos en la cinta. Escriba los usuarios o grupos que deben tener acceso a esta biblioteca. Seleccione el nivel de permiso (Lectura, Colaboración, Edición, etc.) y haga clic en Compartir. La biblioteca ahora tiene permisos nuevos no vinculados al entorno anterior.
Restaurar la herencia en lugar de permisos únicos
Si desea que la biblioteca migrada herede permisos de su nuevo sitio principal, puede restaurar la herencia. Esto elimina por completo la ACL antigua.
- Vaya a Permisos para esta biblioteca de documentos
La misma ruta que antes: Configuración de la biblioteca > Permisos para esta biblioteca de documentos. - Haga clic en Eliminar permisos únicos
En la cinta, haga clic en Eliminar permisos únicos. Una advertencia le indica que se perderán los permisos únicos. Haga clic en Aceptar. La biblioteca ahora hereda permisos de su sitio principal. Se quitan todos los usuarios migrados antiguos. - Verifique la herencia
Actualice la página Permisos. El banner ahora debería decir “Esta biblioteca hereda permisos de su elemento principal”. Compruebe los permisos del sitio principal para confirmar que los usuarios correctos tienen acceso.
Problemas comunes después de migrar una biblioteca con permisos antiguos
Incluso después de romper o restaurar la herencia, puede encontrar problemas. Estos son los más frecuentes y cómo resolverlos.
Los usuarios aún tienen acceso después de romper la herencia
Esto ocurre si no quitó los usuarios antiguos después de romper la herencia. La ACL del origen aún está presente. Vuelva a Permisos para esta biblioteca de documentos, seleccione todos los usuarios del entorno anterior y haga clic en Quitar permisos de usuario. Compruebe también si hay grupos de SharePoint del sitio anterior y quítelos.
La herencia de permisos aparece como rota pero quedan grupos antiguos
Es posible que la herramienta de migración haya copiado los grupos del sitio anterior (por ejemplo, “Miembros del sitio antiguo”) como permisos únicos. Estos grupos ya no existen en el entorno de destino, pero aparecen como entradas sin resolver. No puede quitarlos desde el explorador. Use PowerShell para quitarlos. Ejecute el siguiente script en el Shell de administración de SharePoint Online:
$web = Get-PnPWeb
$list = $web.Lists.GetByTitle("Your Library Name")
$list.BreakRoleInheritance($false, $false)
$list.Update()
Invoke-PnPQuery
Este script rompe la herencia de nuevo y quita todas las asignaciones de roles existentes. Después puede agregar permisos nuevos.
La biblioteca muestra permisos heredados pero el acceso es incorrecto
Si la biblioteca hereda del sitio principal pero los usuarios del origen anterior aún tienen acceso, es posible que el sitio principal haya heredado permisos antiguos de un nivel superior. Compruebe la herencia de permisos del sitio principal. Si el propio sitio principal tiene permisos únicos de la migración, primero debe romper o restaurar la herencia en el nivel del sitio. Después, la biblioteca heredará correctamente.
Modos de permisos de bibliotecas migradas: antes y después de la corrección
| Elemento | Antes de la corrección | Después de la corrección |
|---|---|---|
| Herencia de permisos | Heredada del elemento principal (con ACL antigua) | Única o heredada correctamente del nuevo elemento principal |
| Acceso de usuarios | Usuarios antiguos del entorno de origen | Solo los usuarios previstos del entorno de destino |
| Administración de permisos | No se pueden editar ni quitar fácilmente los usuarios antiguos | Control total para agregar o quitar usuarios |
| Riesgo de seguridad | Alto: persiste el acceso no intencionado | Bajo: los permisos coinciden con las necesidades actuales |
Si sigue los pasos anteriores, puede asegurarse de que su biblioteca migrada tenga la herencia de permisos correcta. Verifique siempre los permisos inmediatamente después de la migración. Use la configuración de la biblioteca para romper o restaurar la herencia, y quite los usuarios antiguos. Para migraciones masivas, considere usar PowerShell para automatizar el restablecimiento de permisos en varias bibliotecas.