Mi lugar en la comunidad WordPress
- Tengo cuenta en wordpress.org desde 2006.
- He contribuido al núcleo de WordPress en las versiones 7.0 y 7.1.
- Mantengo 30 plugins en wordpress.org.
- Organizo WordCamps y hablo en ellos como ponente.
- He asistido a todas las WordCamp Europe de 2017 a 2026.
Un portal de personal con inicio de sesión único
Una empresa con oficina y personal en planta, almacén o ruta acaba juntando en un mismo sitio lo que hoy está repartido: partes de trabajo, solicitudes internas, documentación para plantilla, listados que solo debe ver una parte del equipo. Cuando eso se hace como aplicación web propia, la primera decisión es quién entra y qué ve cada persona.
Soy Mariusz Szatkowski: trabajo en solitario desde Gdynia, Polonia, y llevo desde 2006 con WordPress. Todo el proyecto va por escrito y a distancia: brief, preguntas, alcance y aceptación. El diseño y los wireframes los aportas tú, y yo los implemento en Next.js.

Foto: Visentico / Sento, CC BY-SA 2.0, Wikimedia Commons.
Quién eres y qué puedes hacer son dos preguntas distintas
El inicio de sesión único responde a la primera: la persona se identifica una vez en el proveedor de identidad de la empresa y el portal recibe esa identidad. La segunda, qué puede hacer, la responde la aplicación, en el servidor, con los roles. Mezclarlas es el error habitual: se da por hecho que quien ha entrado puede verlo todo, o se esconde un botón en pantalla y se cree que el dato está protegido.
La guía de autenticación de Next.js separa tres conceptos: autenticación, gestión de sesión y autorización (nextjs.org). Un portal interno necesita las tres, pero solo la primera la presta el proveedor de identidad.
Conectar el portal a Microsoft Entra ID
Si tu empresa usa Microsoft 365, el directorio ya existe y es Microsoft Entra ID. Auth.js incluye un proveedor para él (documentación). El proceso, tal como lo documenta Auth.js, es este:
- Alguien con permisos de administración registra la aplicación en el centro de administración de Entra, con el URI de redirección del portal.
- El identificador de aplicación, un secreto de cliente y el emisor pasan a tres variables de entorno.
- En el registro se elige quién puede iniciar sesión: solo tu organización, cualquier organización, o también cuentas personales. El emisor depende de esa elección.
El detalle que importa en un portal interno: si el emisor no se define, el proveedor usa por defecto el de cuentas de cualquier organización y personales. Para un portal de personal se fija al identificador de tu directorio. Además, Auth.js documenta cómo restringir el acceso con el callback signIn, por ejemplo por dominio de correo (guía). Dos comprobaciones valen más que una.
Dos cosas más antes de elegir librería. Auth.js ahora forma parte de Better Auth, como indica su propia web. Y al consultar el registro de npm el 15 de noviembre de 2026, next-auth marcaba como última la versión 4.24.15 y como beta la 5.0.0-beta.32, que es la que describe la documentación para App Router. La página de autenticación de Next.js lista otras opciones compatibles, entre ellas Better Auth, Auth0, Clerk, Ory o WorkOS. Elegir se hace contigo y por escrito: depende de si ya tienes un proveedor, de dónde quieres guardar las sesiones y de quién mantendrá esto cuando yo no esté.
Roles: de dónde salen
Hay tres sitios razonables para guardar a qué rol pertenece cada persona:
| Origen | Cómo llega al portal | A tener en cuenta |
|---|---|---|
| Roles de aplicación en Entra | Notificación roles en el token, con los roles asignados a la persona o a sus grupos | El administrador del directorio los gestiona; el portal no guarda nada |
| Grupos de seguridad | Notificación groups en el token | Hay un límite de tamaño y puede haber exceso |
| Tabla de roles en la base de datos del portal | Se consulta al iniciar sesión | Hay que mantenerla sincronizada con las altas y bajas |
La documentación de Microsoft sobre roles de aplicación explica que se declaran en el registro de la aplicación, que se pueden asignar a usuarios o a grupos y que Entra emite una notificación roles con los concedidos (Microsoft Learn). Para un portal es la opción más limpia: el rol vive donde ya se gestionan las altas.
Los grupos tienen una trampa documentada. Microsoft limita a 200 los grupos de un token JWT; si la persona pertenece a más, el token no lleva la lista y trae un indicador de exceso (hasgroups o _claim_names), y la aplicación debe consultar a Microsoft Graph (Microsoft Learn). Un código que da por hecho que la lista siempre llega falla en silencio justo con las personas con más permisos.
En Auth.js, el rol llega a la sesión a través del callback profile() y, con JWT, de los callbacks jwt y session. La guía oficial lo aclara: determinar el rol es responsabilidad de quien desarrolla, con lógica propia o con lo que devuelva el proveedor (Auth.js).
Cuándo se entera el portal de un cambio de rol
La misma guía avisa de una consecuencia: con sesión en JWT, el rol viaja en una cookie y, para cambiarlo, la persona debe volver a iniciar sesión. Con sesiones en base de datos, el rol se lee del usuario guardado y el cambio se aplica antes. Para un portal con datos de personal, donde una baja o un cambio de puesto debe cortar el acceso, la segunda estrategia suele encajar mejor. Es una decisión de diseño que se fija en el alcance, no al final.
Dónde se comprueba el permiso
La documentación de Next.js distingue dos tipos de comprobación. La optimista usa los datos de sesión de la cookie y sirve para redirigir o mostrar y ocultar elementos. La segura consulta la sesión contra la base de datos y es la que protege datos sensibles. Recomienda centralizar la lógica en una capa de acceso a datos y devolver solo lo necesario.
El proxy (el antiguo middleware, renombrado en Next.js 16) sirve para el primer tipo: corre en todas las rutas, también en las precargadas, así que solo debe leer la cookie y no consultar la base de datos. Auth.js lo dice sin rodeos: no te apoyes solo en el proxy para autorizar y verifica la sesión lo más cerca posible de donde se piden los datos.
Las Server Actions y los Route Handlers merecen atención aparte. Next.js los equipara a puntos de acceso públicos: cada uno comprueba por sí mismo si la persona puede hacer eso. Un botón oculto en pantalla no impide que alguien llame a la acción. En un Route Handler se distinguen dos respuestas, 401 si no hay sesión y 403 si la hay pero el rol no basta.
Una comprobación mínima en el servidor, con Auth.js, queda así:
import 'server-only'
import { redirect } from 'next/navigation'
import { auth } from '@/auth'
export async function requireRole(role: string) {
const session = await auth()
if (!session?.user) redirect('/login')
if (session.user.role !== role) throw new Error('Forbidden')
return session.user
}Cada acción que modifica algo empieza llamando a esa función. Una ruta que lista datos hace lo mismo antes de leerlos.
Roles y permisos: una tabla de partida
Los nombres cambian de empresa en empresa. Esta tabla es el tipo de documento que te pido antes de escribir código, y puedes usarla aunque no trabajes conmigo:
| Rol | Qué ve | Qué puede cambiar | Dónde se comprueba |
|---|---|---|---|
| Persona empleada | Sus propios datos y la documentación general | Sus solicitudes | Servidor, en cada consulta |
| Responsable de equipo | Datos de las personas de su equipo | Aprobar o rechazar solicitudes | Servidor, en cada acción |
| Recursos humanos | Datos de toda la plantilla | Altas y fichas | Servidor, y con registro de accesos |
| Administración del portal | Configuración | Roles y ajustes | Servidor, con doble confirmación |
La columna que más se olvida es la última. Si la comprobación solo existe en la pantalla, no existe.
Datos de personas empleadas
Un portal de personal guarda datos de las personas que trabajan en la empresa. El artículo 32 del RGPD obliga al responsable y al encargado a aplicar medidas técnicas y organizativas adecuadas al riesgo, entre ellas la capacidad de garantizar la confidencialidad y de restaurar el acceso a los datos tras un incidente (texto del Reglamento). El artículo 25 añade la protección por defecto: que los datos no sean accesibles a un número indeterminado de personas sin intervención de la persona. Es la misma idea que la tabla de roles, aplicada al diseño.
La LOPDGDD, en el BOE (texto consolidado), recoge los derechos digitales en el ámbito laboral. Dos artículos conviene tenerlos presentes si el portal toca el trabajo diario:
- El artículo 87 reconoce el derecho a la intimidad en el uso de dispositivos digitales facilitados por la empresa. Obliga a establecer criterios de utilización, con participación de los representantes de los trabajadores, y a informar de ellos.
- El artículo 88 reconoce el derecho a la desconexión digital fuera del tiempo de trabajo y pide una política interna, previa audiencia de los representantes. Si el portal envía avisos, ese criterio decide a qué horas.
Si el portal registra accesos para auditoría, qué se registra y para qué lo definen la empresa y, si procede, los representantes; yo lo implemento. No soy abogado y esto no sustituye a tu asesoría laboral ni a tu delegado de protección de datos, si lo tienes. La AEPD publica su guía y sus modelos en aepd.es.
Cómo trabajo un proyecto así
- Brief por escrito: qué procesos entran en el portal y quién los usa.
- Preguntas por escrito sobre el directorio, los roles y los sistemas internos.
- Alcance y supuestos por escrito: proveedor de identidad, estrategia de sesión, lista de roles y vistas.
- Una instalación de prueba con personas de prueba, no con la plantilla real.
- Aceptación contra la tabla de roles: para cada rol, qué debe verse y qué debe rechazar el servidor.
- Mantenimiento como opción aparte, con las actualizaciones probadas antes de pasar a producción.
Para empezar necesito que la persona que administra tu proveedor de identidad registre la aplicación, la lista de roles con sus permisos y acceso a los sistemas internos que el portal debe leer. Las vistas las aportas tú, como hoja de maquetación o diseño. Las credenciales no se envían por chat: se acuerda por escrito cómo hacerlas llegar.
Lista de comprobación antes de publicar
- El emisor de Entra apunta a tu directorio y no al de cualquier organización.
- Cada Server Action y cada Route Handler comprueba el rol por su cuenta.
- El proxy solo redirige; no es la única barrera.
- El código contempla el exceso de grupos en el token, o usa roles de aplicación.
- Está decidido cuándo se aplica una baja o un cambio de rol: JWT o sesión en base de datos.
- Cada rol tiene una prueba que demuestra qué le rechaza el servidor.
- Los registros de acceso están definidos y, si procede, acordados con los representantes.
- Las respuestas incluyen solo los campos que la vista necesita.
Preguntas frecuentes
¿Auth.js sirve para un portal interno con Microsoft Entra ID?
Sí, tiene un proveedor para Microsoft Entra ID. Registras la aplicación en el centro de administración de Entra, copias el identificador de cliente y el secreto a las variables de entorno y fijas el emisor. Si no defines el emisor, el proveedor usa por defecto el de cuentas de cualquier organización y personales, así que para un portal interno conviene apuntarlo al identificador de tu directorio y, además, restringir el acceso en el callback signIn. Auth.js pasó a formar parte de Better Auth, y la rama 5 que usa la documentación de Next.js sigue marcada como beta en npm: eso se decide contigo antes de empezar.
¿Los roles los pone Next.js o el proveedor de identidad?
Los define y asigna el proveedor, o tu propia base de datos, y Next.js los lee. Con Entra ID puedes declarar roles de aplicación y asignarlos a usuarios o grupos, y el token incluye una notificación roles con los asignados. Auth.js no inventa el rol: la guía oficial dice que determinarlo es responsabilidad de quien programa, ya sea con tu lógica o con lo que devuelva el proveedor.
¿Qué pasa si una persona pertenece a muchos grupos?
El token deja de llevar la lista completa. Microsoft documenta un límite de 200 grupos en tokens JWT; superado, el token incluye un indicador de exceso en lugar de la notificación groups y la aplicación tiene que pedir la pertenencia a Microsoft Graph. Con roles de aplicación en vez de grupos se evita buena parte del problema, y en cualquier caso el código debe contemplar el exceso en lugar de dar por hecho que la lista llega.
¿Basta con proteger las rutas en el proxy de Next.js?
No. La documentación de Next.js describe el proxy como comprobación optimista, que solo lee la cookie, y recomienda verificar la sesión junto al acceso a los datos. La de Auth.js dice lo mismo: no te apoyes solo en el proxy para autorizar. Las Server Actions y los Route Handlers se tratan como puntos de acceso públicos y comprueban el rol cada uno.
¿Cuándo se aplica un cambio de rol o una baja?
Depende de la estrategia de sesión. Con JWT, el rol viaja en una cookie y, según la documentación de Auth.js, para cambiarlo hay que obligar a la persona a iniciar sesión de nuevo. Con sesiones en base de datos, el cambio o la revocación se aplican en la siguiente petición. Para un portal con datos de personal suele compensar la segunda opción, y la baja de la persona en el directorio es el disparador.
¿Qué necesito aportar para empezar?
Quién administra vuestro proveedor de identidad (esa persona registra la aplicación; yo no necesito ser administrador del directorio), la lista de roles con lo que cada uno puede hacer, los sistemas internos que el portal debe leer o escribir y las vistas, que las aportas tú en una hoja de maquetación o como diseño. Todo se acuerda por escrito antes de la primera línea de código.
Escríbeme
Si quieres un portal de personal con inicio de sesión único y roles, escríbeme desde la página de contacto. Cuéntame qué proveedor de identidad usáis, qué procesos quieres llevar al portal, la fecha que tienes en mente y el stack actual. La primera estimación es gratuita y la recibes por escrito.
Proyectos seleccionados
Ejemplos de mi trabajo.
Sitio Web Corporativo: osemka.pl - Banner
Un paquete de diversos banners especiales para el sitio web osemka.pl
Sitio Web Corporativo: osemka.pl - bannery
Un paquete de diversos banners especiales para el sitio web osemka.pl
Sitio web corporativo: predko.pl
predko.pl es un proyecto web dedicado a la marca personal y la presencia online de Krzysztof Predko, con enfoque en contenidos, rendimiento y experiencia móvil.
Soporte y desarrollo WordPress en Valencia
¿Buscas el servicio: Desarrollador Next.js en Valencia?
Describe tu proyecto por e-mail. Respondo en 48 horas.
Describe tu proyectoExplora otros servicios WordPress y base de conocimiento
Migración a Astro, Next.js y headless WordPress.
Sincronización WooCommerce con ERP y mayorista.
Automatización de procesos de negocio en torno a WordPress y sistemas empresariales.
Biblioteca de casos concretos de automatización.
Headless WordPress, Sanity, Strapi y Contentful con Astro o Next.js.
Astro, MDX, edge delivery y Core Web Vitals medidos con tráfico real.
Ingeniería WordPress y arquitectura personalizada.
Arquitectura headless, ERP e IA escalable para enterprise.
Categorías relacionadas
Artículos de apoyo

De seis a dieciséis semanas para proyectos típicos, en cuatro fases: descubrimiento, alcance, construcción y cutover, ajuste. Las variables son el tamaño del catálogo, el número de integraciones, la preservación de URLs y la disposición del equipo editorial, no la elección del framework.

Análisis exhaustivo del coste total de propiedad (TCO) a 4 años, métricas reales de Core Web Vitals, arquitectura Astro 7 GraphQL APQ y matriz de decisión de 10 puntos para directores de tecnología que eligen entre WordPress desacoplado y tradicional.

La decisión entre Shopify Plus y WooCommerce headless en 2026 ya no es un compromiso binario "plataforma vs personalizado". Ambos pueden funcionar en headless, ambos integran IA, ambos sirven en el edge. Los ejes reales son el control, el coste total a lo largo de cinco años y la estrategia de salida. Este artículo recorre la matriz con datos confirmados de cada plataforma.