Descripción general
Su perfil personal de operador controla cómo inicia sesión en el Panel de Passinstance (/settings/account/profile, /preferences, /notifications, /authentication, /two-factor-authentication y /sessions), cómo se muestran textos y marcas temporales en su sesión del navegador y cómo recibe avisos de seguridad. A diferencia de los ajustes globales de Configuración de empresa, los cambios realizados en Cuenta -> Perfil y preferencias afectan únicamente a su identidad User individual sin alterar los idiomas de los pases de clientes ni la vista de sus compañeros.
Arquitectura de identidad, MFA y ciclo de vida de sesiones
Importante: Cambiar su Idioma de interfaz o Tema visual personal solo modifica su sesión en el Panel. Los textos de pases para clientes, las páginas inteligentes
/d/:slugy los formularios PassFlow siguen siempre las reglas de idioma configuradas en cada plantilla y en Configuración de empresa.
Perfil personal y preferencias de interfaz
Vaya a Cuenta -> Perfil (/settings/account/profile) y Preferencias (/settings/account/preferences) para configurar su identidad y preferencias de visualización:
| Ajuste | Campo API | Comportamiento y ámbito |
|---|---|---|
| Nombre visible y avatar | firstName, lastName / PUT /api/v1/users/me/avatar | Se muestra en listados de equipo, historial de revisiones de plantillas y registros de auditoría (GET /api/v1/audit-log/export.csv). |
| Idioma de interfaz | locale (en, de, es, fr, it, nl, pt) | Controla el diccionario del Panel con independencia del idioma del espacio de trabajo o de las plantillas. |
| Modo de tema | theme (light, dark, system) | Guarda su esquema de color entre dispositivos y se sincroniza con los tokens CSS semánticos. |
| Zona horaria de vista | timezone (identificador IANA) | Da formato a las marcas de actividad en su sesión personal respetando la zona del espacio para analítica. |
| Canales de notificación | Objeto notifications | Activa o desactiva avisos por correo para importaciones por lotes, caducidad de certificados, recibos de cobro y alertas de inicio de sesión. |
Actualizar perfil y preferencias vía API
PUT /api/v1/users/me/profile HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json
{
"firstName": "Elena",
"lastName": "Rostova",
"timezone": "Europe/Berlin"
}
Use PUT /api/v1/users/:userId/preferences (o GET /api/v1/users/me/settings) para actualizar el idioma de interfaz, el tema y los indicadores de notificación:
{
"id": "usr_019331a0-4c22-7b10-8a99-112233445566",
"email": "elena.rostova@example.com",
"firstName": "Elena",
"lastName": "Rostova",
"locale": "en",
"timezone": "Europe/Berlin",
"theme": "dark",
"twoFactorEnabled": true,
"updatedAt": "2026-11-16T09:31:00.000Z"
}
Registro en autenticación en dos factores (TOTP 2FA)
Passinstance admite autenticación multifactor mediante contraseñas temporales RFC 6238 (TOTP) en /settings/account/two-factor-authentication, compatible con 1Password, Google Authenticator, Authy y Contraseñas de Apple. Los espacios pueden además exigir 2FA obligatoria para roles administrativos desde Miembros del equipo y permisos.
-
1
Generar secreto y URI QR (
POST /api/v1/auth/2fa/setup): Devuelve una URI de aprovisionamientootpauth://totp/cifrada y clave base32 (GET /api/v1/auth/2fa/statusconsulta el estado). -
2
Verificar y activar (
POST /api/v1/auth/2fa/verify+/api/v1/auth/2fa/enable): Envíe un código válido de 6 dígitos de su aplicación autenticadora para activar 2FA y obtener códigos de recuperación de un solo uso (POST /api/v1/auth/2fa/regenerate-backup-codeslos regenera). -
3
Custodia de códigos de respaldo: Guarde los códigos de recuperación en lugar seguro; cada código solo puede usarse una vez en caso de pérdida del teléfono.
POST /api/v1/auth/2fa/verify HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json
{
"code": "482910"
}
{
"twoFactorEnabled": true,
"verifiedAt": "2026-11-16T09:32:15.000Z",
"recoveryCodes": [
"PI-894A-221C",
"PI-773B-904D",
"PI-112E-665F",
"PI-550C-338A"
]
}
Rotación de contraseña y gestión de sesiones activas
En Cuenta -> Autenticación (/settings/account/authentication) y Sesiones (/settings/account/sessions), puede rotar su contraseña e inspeccionar todas las sesiones autenticadas vinculadas a su usuario:
-
Cambio de contraseña (
POST /api/v1/users/change-password): Requiere verificar su contraseña actual (y código TOTP vigente si tiene 2FA activa). Al cambiarla, se revocan de inmediato todos los demás tokens de actualización activos en dispositivos secundarios. -
Inspección y cierre remoto de sesiones (
GET /api/v1/users/sessions,DELETE /api/v1/sessions/:sessionIdyDELETE /api/v1/sessions/others): Muestra dirección IP, navegador/SOUser-Agent, confianza de dispositivo (/api/v1/sessions/trust-device) y última actividad para cerrar sesiones a distancia.
Documentación relacionada
-
Configure políticas de seguridad del espacio de trabajo en Seguridad de la cuenta y acceso.
-
Defina moneda de organización, domicilio fiscal e idioma predeterminado en Configuración de empresa.
