Skip to content
Guía del Centro de ayuda · Ajustes de cuenta y espacio
3 min de lecturaVerificado 2026-11-16

Perfil y preferencias

Actualiza datos personales de acceso, idioma del panel, zona horaria y preferencias de avisos.

En esta guía

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

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
PERFIL DE OPERADOR, TOTP 2FA Y GESTIÓN DE SESIONES
ETAPA 01 CAPA DE NAVEGADOR / CLIENTE DEL OPERADOR
Interfaz Perfil/Idioma
(/settings/account/*)
App Autenticadora
(RFC 6238 TOTP 6 díg.)
Gestor de sesiones
activas por equipo
ETAPA 02 CONTROLADORES USERS, AUTH Y SESSION (API)
Identidad y Preferencias
GET/api/v1/users/me/profile
PUT/api/v1/users/me/profile
`PUT/api/v1/users/:id/preferences
Tema: light | dark | system
Seguridad y Control de Sesiones
POST/api/v1/auth/2fa/setup
POST/api/v1/auth/2fa/verify
POST/api/v1/users/change-passw
DELETE/api/v1/sessions/:id
ETAPA 03 CAPA DE PERSISTENCIA Y AUDITORÍA DE SEGURIDAD
Registro User (Secreto TOTP cifrado, Hash Bcrypt, Códigos de respaldo)
Almacén in-memory cache de Refresh Tokens (Invalidación inmediata al cambiar contraseña)

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/:slug y 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:

AjusteCampo APIComportamiento y ámbito
Nombre visible y avatarfirstName, lastName / PUT /api/v1/users/me/avatarSe muestra en listados de equipo, historial de revisiones de plantillas y registros de auditoría (GET /api/v1/audit-log/export.csv).
Idioma de interfazlocale (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 tematheme (light, dark, system)Guarda su esquema de color entre dispositivos y se sincroniza con los tokens CSS semánticos.
Zona horaria de vistatimezone (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ónObjeto notificationsActiva 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

HTTP
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:

JSON
{
  "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. 1
    Generar secreto y URI QR (POST /api/v1/auth/2fa/setup): Devuelve una URI de aprovisionamiento otpauth://totp/ cifrada y clave base32 (GET /api/v1/auth/2fa/status consulta el estado).
  2. 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-codes los regenera).
  3. 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.
HTTP
POST /api/v1/auth/2fa/verify HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "code": "482910"
}
JSON
{
  "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/:sessionId y DELETE /api/v1/sessions/others): Muestra dirección IP, navegador/SO User-Agent, confianza de dispositivo (/api/v1/sessions/trust-device) y última actividad para cerrar sesiones a distancia.

Documentación relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.