Sesiones y perfiles persistentes

Aprende sobre las Sesiones persistentes (sticky) y los Perfiles persistentes en Oxylabs Agent Browser. Reconéctate a sesiones en curso y reutiliza tus cookies o almacenamiento local a lo largo de varias sesiones.

Gestionar flujos de trabajo de automatización de varias etapas de larga duración o mantener estados de usuario autenticados entre secuencias de conexión distintas requiere conservar los estados del navegador. Oxylabs Agent Browser ofrece dos sistemas avanzados de persistencia:

Sesiones persistentes	Mantén un entorno de navegador remoto activo durante las desconexiones del cliente.
Perfiles persistentes	Guarda y restaura cookies, almacenamiento local y la caché del navegador.

Sesiones persistentes

Las sesiones persistentes (sticky) mantienen tu instancia remota del navegador ejecutándose en la nube (incluso cuando tu script local de automatización se desconecta) definiendo un valor personalizado para session_name en la URL de conexión:

wss://USER:[e-mail]?session_name=checkout-flow-test

Las sesiones persistentes están habilitadas de forma predeterminada para todos los usuarios, con un límite predeterminado de 5 sesiones simultáneas. Si necesitas un límite mayor, contacta con el soporte de Oxylabs (chat en vivo o correo electrónico) o a tu gestor de cuenta dedicado.

Parámetro	Descripción	Tipo
session_name	Cuando se define, una sesión persiste hasta el tiempo de vida máximo (TTL) (máx. 24 h o hasta que se detenga). Reconéctate con el mismo session_name para volver a adjuntar el mismo ID de sesión y las pestañas existentes. Formato compatible: ^[A-Za-z0-9-]{3,36}$	Cadena
keep_alive	Mientras false (predeterminado), al llamar a browser.close() recupera y cierra la sesión. Mientras true, la sesión permanece activa en la nube después de desconectarte (hasta 10 minutos).	Booleano

Reconéctate a una pestaña existente

// Reconnect to existing session with 
const browser = await chromium.connectOverCDP(endpoint);
const ctx = browser.contexts()[0];
const page = ctx.pages().find(p => p.url().includes("http://example.com "));

Perfiles persistentes

Los Perfiles persistentes son habilitadas de forma predeterminada para todos los usuarios, con un límite predeterminado de 5 perfiles. Úsalo para guardar cookies y localStorage bajo un perfil con nombre y restaurarlos en una sesión completamente nueva. Los siguientes parámetros te permiten mantener una identidad con sesión iniciada entre sesiones sin volver a autenticarte cada vez:

Parámetro	Descripción	Tipo
o_profile	Guarda y restaura cookies y localStorage con un perfil con nombre (14 días desde el último uso). Formato compatible: ^[A-Za-z0-9_-]{1,36}$	Cadena
o_profile_save	Forzar el guardado del perfil durante o al final de la sesión. Valor predeterminado: false.	Booleano
proxy_resi_ses_id	ID de sesión personalizado para fijar la IP de salida residencial entre sesiones. Formato compatible: ^[A-Za-z0-9]{3,36}$.	Cadena
proxy_resi_ses_time	Duración para mantener fijada la IP de salida del proxy residencial en minutos. Mín 1, máx. 1440 (24 h).	Entero

Superar el max_profiles límite de 5 devuelve CDP_LIMIT_REACHED: profile limit reached error. Puedes inspeccionar y eliminar perfiles guardados directamente en el Dashboard (hb.oxylabs.io/dashboard) si alcanzas el límite, o reutiliza un nombre de perfil estable. Contacta con el soporte de Oxylabs (chat en vivo o correo electrónico) o a tu gestor de cuenta dedicado si se requieren límites más altos.

Restauración fiable entre sesiones

Para sitios web con sistemas estrictos de monitoreo de bots, guardar cookies no es suficiente. Si un perfil restaurado se conecta desde una IP de salida residencial diferente, tus cookies pueden invalidarse, lo que provocará páginas en blanco o pantallas de verificación de seguridad.

Para asegurar inicios de sesión consistentes, combina tu perfil con una IP de salida residencial fijada:

// Session 1: Authenticate and back up state
const connectionOne = "wss://USER:[e-mail]?o_profile=my_user_profile&proxy_resi_ses_id=ip_session_abc&proxy_resi_ses_time=120";

// Session 2: Restore profile with the exact same IP session context
const connectionTwo = "wss://USER:[e-mail]?o_profile=my_user_profile&proxy_resi_ses_id=ip_session_abc&proxy_resi_ses_time=120";