Control de acceso

El control de acceso determina quién puede leer tu centro de ayuda y cada sección, colección y artículo que contiene. El centro de ayuda en sí puede ser Público o Privado, y cada nivel inferior solo puede restringir quién entra, nunca ampliar el acceso.

Centros de ayuda públicos y privados

La configuración del centro de ayuda ofrece las opciones Público y Privado bajo el encabezado Quién puede leer tu centro de ayuda. Público significa que cualquiera puede navegar por él. Privado significa que los visitantes deben iniciar sesión primero.

Antes de poder guardar un centro de ayuda como privado, debe estar habilitado al menos un método de inicio de sesión para visitantes. Consulta los pasos en Haz que tu centro de ayuda sea privado.

Métodos de inicio de sesión para visitantes

Los métodos de inicio de sesión funcionan en centros de ayuda privados y en centros de ayuda públicos que restringen secciones o colecciones. Puedes habilitar varios métodos a la vez, y los lectores verán todas las opciones habilitadas en la página de inicio de sesión:

• Enlaces mágicos: los lectores introducen su correo electrónico y reciben un enlace de inicio de sesión de un solo uso. Consulta Iniciar sesión con enlaces mágicos.

• Inicio de sesión único (OIDC): los lectores inician sesión a través de tu proveedor de identidad. Consulta Iniciar sesión con SSO de OIDC.

• Contraseña compartida: una contraseña para todos los lectores. Los lectores que usan una contraseña compartida no tienen una identidad individual, por lo que las restricciones de grupos de usuarios no se aplican a ellos. Consulta Contraseña compartida.

• Iniciar sesión con tu producto: los lectores usan la cuenta que ya tienen en tu aplicación. Consulta Iniciar sesión con tu producto.

La jerarquía de acceso

El acceso se restringe en cada nivel, y ningún nivel puede eliminar una restricción establecida por encima de él:

• Centro de ayuda: Público o Privado establece la base para todo lo que está por debajo.

• Sección: el editor de secciones tiene una pestaña Acceso con tres opciones: Heredar, Lectores con sesión iniciada o Grupos específicos. La sección de inicio sigue la configuración del centro de ayuda y no tiene un acceso independiente.

• Colección: las mismas tres opciones que una sección.

• Artículo: Heredar de la colección, Cualquiera que haya iniciado sesión o Grupos de usuarios específicos. Un artículo solo puede restringir la audiencia de su colección, nunca ampliarla.

Para saber cómo configurar el acceso en cada nivel, consulta Acceso a secciones y colecciones. Para restringir el acceso de los lectores a grupos específicos, créalos primero: consulta Grupos de usuarios.

Bloqueado u oculto: qué ven los lectores sin acceso

Para cada sección o colección que restrinjas, eliges qué ven los lectores sin acceso: Heredar (la opción predeterminada, que se resuelve como oculto), Mostrar con un candado u Ocultar.

Se muestra con un candado

Una sección o colección bloqueada mantiene visible su título. El título con un icono de candado aparece en las pestañas de sección, la barra lateral y las listas de colecciones. Al abrirla, se muestra una tarjeta de acceso denegado con tu descripción (o el texto predeterminado, como «No tienes acceso a esta sección»), un botón Iniciar sesión para los lectores que no han iniciado sesión, un botón opcional que configures y Usar otra cuenta para los lectores que sí han iniciado sesión.

La búsqueda del centro de ayuda solo encuentra coincidencias con el título bloqueado. El contenido nunca se muestra.

Oculto

Una sección o colección oculta no aparece en ninguna lista. Un enlace directo devuelve 401 a los lectores que no han iniciado sesión o 403 a los lectores que han iniciado sesión pero no tienen acceso, y muestra la misma tarjeta de acceso denegado sin revelar nunca el título. Las URL desconocidas siguen devolviendo 404, por lo que el contenido oculto y el contenido inexistente solo se diferencian por el código de estado.

Cómo se combinan las restricciones entre niveles

Es posible que un lector que no puede abrir un elemento tampoco cumpla los requisitos de los niveles superiores. Empieza en el primer nivel que el lector no cumple y sigue la cadena hasta el elemento:

• Si algún nivel de esa cadena está configurado como Ocultar, el elemento queda oculto.

• Si todos los niveles de la cadena están configurados como Mostrar con un candado, el elemento se muestra con un candado. El mensaje del candado procede del nivel más cercano al elemento.

Dos casos especiales:

• Un requisito establecido en el propio artículo siempre se oculta. Nunca muestra un candado, aunque los niveles superiores sí lo hagan.

• En un centro de ayuda Privado, los visitantes que no han iniciado sesión no ven nada.

Dónde aparece el contenido bloqueado y oculto

Los elementos bloqueados solo aparecen en las páginas del centro de ayuda. Se excluyen del widget, MCP, llms.txt, el mapa del sitio y RSS.

El asistente de IA puede mencionar y enlazar un artículo bloqueado por su título sin exponer su contenido. El contenido oculto nunca se menciona, y a los lectores anónimos no se les muestran los nombres de los grupos.

Identificación silenciosa con JWT

La identificación silenciosa mediante JWT está disponible en todos los planes y en ambos modos de acceso. Tu backend firma un JWT para identificar a los lectores sin que tengan que iniciar sesión por separado en el centro de ayuda. Para configurarlo, consulta Autenticación JWT.