email · obligatorio
Correo corporativo que identifica al empleado en el portal central.
Documento técnico · Colombia
Guía para implementar un acceso seguro y transparente desde la intranet de Colombia, sin exponer el correo del empleado ni el secreto de firma en el navegador.
El empleado abre el Portal Prowinch desde la intranet React de Colombia sin iniciar sesión por segunda vez.
request.user.El middleware de autenticación debe dejar disponibles los datos del empleado en el servidor.
request.user = {
id: 74,
email: 'usuario@prowinch.com',
name: 'Nombre del empleado'
};
email · obligatorioCorreo corporativo que identifica al empleado en el portal central.
id · obligatorioID numérico estable del empleado en la intranet de Colombia.
name · recomendadoNombre visible del empleado para trazabilidad y presentación.
canViewReceivables · opcionalPermiso booleano para habilitar acceso al módulo de cuentas por cobrar.
function currentEmployee(request) {
const source = request.user;
return {
email: source.UsuEmail,
name: source.UsuNombre,
legacyUserId: Number(source.UsuCod),
showReceivables: source.canViewReceivables === true,
};
}
La ruta debe ejecutarse después de los middleware de sesión y autenticación existentes.
function currentEmployee(request) {
const user = request.user;
if (!user) {
throw new Error('Usuario no autenticado');
}
const email = String(user.email || '').trim().toLowerCase();
const legacyUserId = Number(user.id);
if (!email) {
throw new Error('El usuario autenticado no tiene correo');
}
if (!Number.isInteger(legacyUserId)) {
throw new Error('El usuario no tiene un ID válido');
}
return {
email,
name: user.name || '',
legacyUserId,
showReceivables: user.canViewReceivables === true,
};
}
app.get(
'/api/employee-portal/embed-url',
requireAuth,
(request, response) => {
try {
const employee = currentEmployee(request);
const url = createColombiaPortalEmbedUrl({
employee,
parentOrigin: process.env.PROWINCH_PORTAL_PARENT_ORIGIN,
});
response.json({ ok: true, url });
} catch (error) {
response.status(401).json({
ok: false,
message: error.message,
});
}
}
);
app.use(sessionMiddleware);
app.use(authenticationMiddleware);
app.use(employeePortalRouter);
Ambos servidores deben usar exactamente el mismo origen público de la aplicación React.
PROWINCH_PORTAL_PARENT_ORIGIN=https://web-intranet-co-dev.azurewebsites.net
PORTAL_EMBED_COLOMBIA_ORIGINS=https://web-intranet-co-dev.azurewebsites.net
/#/, el hash no forma parte del origen.
/#/, parámetros o nombres de páginas dentro del valor del origen.
React solicita una URL nueva al montar el componente y la utiliza como dirección del iframe.
async function getPortalUrl() {
const response = await fetch('/api/employee-portal/embed-url', {
method: 'GET',
credentials: 'include',
headers: {
Accept: 'application/json',
},
});
const result = await response.json();
if (!response.ok || !result.ok || !result.url) {
throw new Error(
result.message || 'No fue posible abrir el Portal Prowinch'
);
}
return result.url;
}
{
"ok": true,
"url": "https://prowinch.us/intranet/portal-embed.php?ticket=..."
}
El correo no aparece directamente en la respuesta: queda protegido dentro del ticket firmado y temporal. La URL no debe guardarse en localStorage, una base de datos ni estados persistentes.
Después de validar la firma y consumir el ticket, el portal crea su propia sesión con el correo firmado.
$_SESSION['glocodusu'] = strtolower(
trim((string) $claims['sub'])
);
La identidad siempre debe provenir de una sesión o token previamente validado por el backend.
?email=usuario@prowinch.com ni incluir un correo elegido por el navegador en el cuerpo de la solicitud. Esto permitiría intentos de suplantación.
request.user.requireAuth.VITE_* o REACT_APP_*.Este log temporal comprueba la identidad sin revelar credenciales ni el ticket.
console.log('Portal integration user:', {
authenticated: Boolean(request.user),
emailPresent: Boolean(request.user?.email),
userId: request.user?.id,
});
Revisar requireAuth, credentials: 'include', la existencia de request.user y que tenga correo e ID.
Confirmar que el correo exista y esté activo en employees o employee_aliases.
Comparar los orígenes exactos y revisar CSP, especialmente la directiva frame-ancestors.
El backend ya recibió un correo e ID válidos. Continuar la revisión en la validación central del usuario.
La integración está lista cuando todos estos puntos han sido verificados.
request.user.currentEmployee() devuelve correo, nombre e ID numérico correctos./api/employee-portal/embed-url está protegida./#/.credentials: 'include'.request.user, genera una URL firmada y React usa únicamente esa URL para cargar el portal.