Agregar un fragmento de código de recorte de seguridad en SharePoint
Puede usar un fragmento de código de recorte de seguridad para mostrar contenido únicamente a usuarios específicos, en función de un permiso específico que los usuarios deben tener y si los usuarios son autenticados o anónimos.
Introducción para el fragmento de código de recorte de seguridad
Puede usar un fragmento de código de recorte de seguridad para mostrar contenido únicamente a usuarios específicos, según un permiso específico que los usuarios deben tener, y si los usuarios están autenticados o anónimos. Puede agregar un panel de recorte de seguridad a una página maestra o un diseño de página. Un panel de recorte de seguridad es un contenedor que puede incluir otros componentes o fragmentos de código, como elementos web, además de contenido estático.
Por ejemplo, puede usar el panel de recorte de seguridad para mostrar el siguiente contenido a usuarios específicos:
Un elemento web de búsqueda que muestra los documentos de contenido en los que está trabajando un usuario autenticado.
Una vista de lista de los documentos modificados recientemente para que los usuarios autenticados puedan ver las novedades del sitio.
Un elemento web de búsqueda por contenido que muestra a los visitantes no autenticados una lista de vínculos recomendados basándose en el artículo actual. Dicha lista de recomendaciones podría ser irrelevantes a los autores de contenido autenticados trabajar en el sitio, pero es importante que los visitantes no autenticados.
Inicio de sesión de vínculo independiente de la cinta de opciones, para los usuarios no autenticados o usuarios que aún tienen que ser autenticados.
Nota:
Este vínculo de inicio de sesión se inserta automáticamente en una página maestra que se crea mediante el Administrador de diseño, pero puede eliminarlo si no es necesario.
Un panel de recorte de seguridad tiene los valores de dos propiedades importantes, uno para la autenticación y otro para permisos (o autorización). Por ejemplo, puede usar un panel de recorte de seguridad para mostrar el contenido siguiente a usuarios específicos:
AuthenticationRestrictions Con esta propiedad, puede restringir el panel a los usuarios autenticados o anónimos o elija todos los usuarios (todos los usuarios es la configuración predeterminada).
Permisos Con esta propiedad, puede seleccionar un permiso específico que los usuarios deben tener para ver el contenido en el panel.
Nota:
Va a seleccionar un permiso individual, no un nivel de permisos. (Un nivel de permiso es un conjunto de permisos concedidos).
Por supuesto, si restringe la autenticación solo a usuarios anónimos, normalmente no es necesario especificar un permiso específico porque a los usuarios anónimos normalmente no se les ha concedido ningún permiso de SharePoint. Solo tiene sentido usar permisos con todos los usuarios o con todos los usuarios autenticados.
El panel recorte de seguridad tiene tres opciones en la cinta de opciones, aparece en la columna izquierda de la tabla 1. En la tabla 1 se muestra cómo estas opciones de configuración determinan el permiso específico que los usuarios deben tener, el nivel de permiso predeterminado más bajo que incluye ese permiso específico y el grupo vinculado a ese nivel de permisos de forma predeterminada.
Nota:
Estos son los valores predeterminados, que se pueden cambiar para cualquier ámbito determinado, como una colección de sitios, sitio, lista o elemento.
Por ejemplo, si establece un panel recorte de seguridad para Mostrar a los autores, por contenido predeterminado dentro de dicho panel es visible para los usuarios en el grupo de miembros y el grupo propietarios.
Tabla 1. Asignación de opciones de panel a grupos y niveles de permisos predeterminados
| Opción de panel recorte de seguridad | Propiedad Permissions | Permiso | Nivel de permisos | Group |
|---|---|---|---|---|
| Mostrar a los autores | AddAndCustomizePages | Agregar y personalizar páginas | Contribute (o superior) | Members |
| Mostrar a los usuarios autenticados | ViewPages | Ver páginas | Lectura (o superior) | Visitantes |
| Mostrar a los administradores | FullMask | Seleccionar todo | Control completo | Propietarios |
Insertar un panel de recorte de seguridad
Al igual que todos los fragmentos de código, se agrega el fragmento de código de recorte de seguridad de la Galería de fragmento de código. Para navegar a la Galería de fragmento de código, primero debe seleccionar una página maestra o un diseño de página para editar.
Para insertar un panel de recorte de seguridad
Vaya a su sitio de publicación.
En la esquina superior derecha de la página, elija el engranaje Configuración y luego elija Administrador de diseño.
En el Administrador de diseño, en el panel de navegación izquierdo, elija Editar páginas principales o Editar diseños de página, en función del tipo de archivo que está editando.
Seleccione el nombre de la página maestra o un diseño de página que se va a agregar el fragmento de código.
Para abrir la Galería de fragmentos de código, elija Fragmentos de código en la esquina superior derecha de la vista previa del lado del servidor.
En la cinta de opciones, en la ficha Diseño, elija el Recorte de seguridad.
De forma opcional, en la lista desplegable en el botón de Recorte de seguridad, puede seleccionar los usuarios a los que el contenido del panel será visible o puede ver más opciones mediante la configuración de los valores de propiedad importante para el panel.
En el lado derecho de la Galería de fragmentos de código, en Acerca de este componente, haga clic o seleccione los encabezados de sección para expandir o contraer los grupos de propiedades y después, configure las opciones personalizadas que quiera.
Después de configurar las propiedades, elija Actualizar. Así se actualiza el fragmento de código HTML en el lado izquierdo de la página, para que el marcado refleje los cambios. Siempre puede elegir Restablecer para devolver todas las propiedades a sus configuraciones predeterminadas.
En el lado izquierdo de la Galería de fragmentos de código, en Fragmento de código HTML, elija Copiar al Portapapeles.
En su editor HTML, abra la unidad de red asignada en su equipo y luego abra el archivo HTML de la página principal o del diseño de página al que quiere agregar el fragmento de código.
En el archivo HTML, pegue el fragmento de código en el lugar donde quiere que aparezca el marcado.
Si va a agregar el fragmento de código a un diseño de página, asegúrese de pegar el fragmento de código dentro de PlaceHolderMain.
Reemplace la etiqueta
<div>dondeclass="DefaultContentBlock"por su propio contenido específico.Guarde la página y, a continuación, actualice la vista previa del lado del servidor en el Administrador de diseño para asegurarse de que el panel recorte de seguridad aparece como se esperaba.
Descripción del marcado del fragmento de código
Los elementos más importantes de un fragmento de código de recorte de seguridad son la propiedad AuthenticationRestrictions y la propiedad Permissions y el <div> en negrita a continuación. AuthenticationRestrictions aparece en el marcado únicamente cuando cambia de AllUsers, que es el valor predeterminado. Si elige Restablecer para el fragmento de código en la Galería de fragmento de código, se quitará el marcado, lo que significa que el fragmento de código usa el valor predeterminado, AllUsersen AuthenticationRestrictions.
El <div> donde class="DefaultContentBlock" es lo que reemplace con su propio contenido, que puede incluir otros fragmentos de código y controles.
<div data-name="SecurityTrimmedAuthors">
<!--CS: Start Security Trim Snippet-->
<!--SPM:<%@Register Tagprefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"%>-->
<!--MS:<SharePoint:SPSecurityTrimmedControl runat="server" AuthenticationRestrictions="AuthenticatedUsersOnly" Permissions="AddAndCustomizePages" PermissionContext="RootSite">-->
<!--PS: Start of READ-ONLY PREVIEW (do not modify)--><span><!--PE: End of READ-ONLY PREVIEW-->
<div class="DefaultContentBlock" style="border:medium black solid; background:yellow; color:black; margin:20px; padding:10px;">
You should replace this div with content that renders based on your Security Trim Properties.
</div>
<!--PS: Start of READ-ONLY PREVIEW (do not modify)--></span><!--PE: End of READ-ONLY PREVIEW-->
<!--ME:</SharePoint:SPSecurityTrimmedControl>-->
<!--CE: End Security Trim Snippet-->
</div>