Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-09-17

Autenticación, inicio de sesión y MFA

Cómo las personas entran a ingestia.io — Google, correo/contraseña, MFA (TOTP) e inicio de sesión vía udiApps — y cómo el dueño protege las cuentas.

En esta página (11)

Esta página cubre cómo una persona entra a ingestia.io y cómo el dueño del workspace refuerza el acceso a las cuentas. Para el aprovisionamiento automático por IdP corporativo (SAML/OIDC + SCIM), consulta SSO y SCIM.

Qué es#

La autenticación decide quién eres (identidad). Es distinto de lo que puedes hacer (roles/RBAC) y de qué filas ves (RLS). Una persona puede participar en varios workspaces con la misma identidad de inicio de sesión.

Formas de inicio de sesión disponibles#

FormaCómo funcionaEstado
GoogleInicio de sesión social (Google Sign-In). Restricción opcional por dominio de Google Workspace.Disponible
Correo + contraseñaRegistro self-service; contraseña guardada como hash (scrypt), nunca en texto. Se define en el registro — no hay cambio ni restablecimiento por autoservicio.Disponible
MFA (TOTP)Segundo factor por app autenticadora (Google Authenticator, Authy, 1Password…).Disponible
Inicio de sesión por udiAppsEntrada desde el gestor central udiApps (handshake firmado).Disponible
SSO corporativo (SAML 2.0 / OIDC)IdP de la empresa (Okta, Entra ID, Google Workspace). Consulta SSO y SCIM.Activado bajo pedido

Modo de desarrollo

Sin ninguna credencial de autenticación configurada en el entorno, la instancia corre en modo dev abierto (para desarrollo local). En producción esto está bloqueado: sin Google ni credenciales, el deploy no se anuncia saludable (verdad de producción — consulta Estado y limitaciones).

Para qué sirve#

  • Dar a cada persona una identidad única y auditable (el rastro de auditoría registra userEmail).
  • Exigir un segundo factor a todas las cuentas — no solo a las sensibles: en la versión implementada, el MFA es obligatorio para cualquier acceso con sesión iniciada.
  • Permitir la entrada federada por SSO corporativo (activado bajo pedido) sin contraseña local.

Plan y permisos#

  • Inicio de sesión y MFA: todos los planes.
  • SSO/SCIM: a partir de Scale (activado bajo pedido) — consulta Planes.
  • Quién lo controla: nadie elige. En la versión implementada, el MFA es obligatorio para cualquier acceso con sesión iniciada: entrar sin un segundo factor configurado lleva directo a la pantalla de configuración de MFA, y no hay forma de salir de ella hacia el producto. Cada persona configura su propio autenticador; gestionar personas es una acción de admin/owner (member.manage).
  • No existe "exigir MFA a un miembro". El registro de la persona tiene una marca con ese nombre, pero no tiene efecto: ningún camino de inicio de sesión la consulta. Como el MFA ya es obligatorio para todos, la marca no cambia nada — y no puede usarse para eximir a nadie.

Paso a paso — activar MFA (TOTP)#

  1. Abrir la configuración de MFA

    En tu perfil, elige Activar verificación en dos pasos. La plataforma genera un secreto TOTP y un código QR.

  2. Registrarlo en la app autenticadora

    Escanea el código QR (o escribe el secreto) en tu app (Google Authenticator, Authy, 1Password, etc.). Empieza a generar un código de 6 dígitos que cambia cada 30 s.

  3. Confirmar el código

    Escribe el código actual para confirmar el vínculo. A partir de ahí, todo inicio de sesión exige la contraseña y el código del momento.

El secreto TOTP se guarda cifrado (AES-256-GCM) en el servidor y nunca sale en reportes, DSAR ni logs.

Salvedad de registro heredado — la misma que consta en Credenciales y rotación

El cifrado en reposo vale para todo registro nuevo: activar (o reactivar) el MFA graba la semilla cifrada. El lector, sin embargo, tolera una semilla heredada en texto plano: si el descifrado falla, el valor guardado se usa tal cual. Esto existe para no romper el inicio de sesión de quien registró el MFA antes del cifrado — y no hay migración que reescriba los registros antiguos, así que "cifrado en reposo" describe lo que se graba hoy, no una garantía retroactiva sobre todo registro existente. Es la misma salvedad de Credenciales y rotación; las dos páginas afirmaban cosas distintas, y esta es la versión que corresponde al código. Reactivar el MFA (desactivarlo y activarlo de nuevo) vuelve a grabar la semilla cifrada.

Registrar la salvedad no es afirmar que exista un secreto en texto plano en algún entorno: es decir que el producto todavía acepta leer uno, y que no se hizo ningún barrido de valores (ni se pediría) para escribir esta página.

Ejemplo#

En Comércio Aurora (ficticia), Maria (owner) entra con Google. João (admin) usa correo + contraseña y, como opera fuentes y personas, activa el MFA. A partir de ahí, su inicio de sesión pide la contraseña y el código de 6 dígitos de la app autenticadora.

Resultado esperado#

  • Un inicio de sesión exitoso crea la sesión y lleva al área con sesión iniciada.
  • Con el MFA activo, un inicio de sesión sin código válido es denegado (no entras "solo con la contraseña").
  • La entrada queda registrada en el rastro de auditoría del workspace.

Seguridad#

  • Contraseñas: hash scrypt; la plataforma nunca guarda ni muestra la contraseña en texto.
  • MFA: verificación TOTP con ventana de tolerancia; secreto cifrado en reposo en los registros nuevos, con la salvedad de lectura de registro heredado descrita arriba.
  • Dominio de Google (opcional): el dueño puede restringir el inicio de sesión social a un dominio de Workspace específico (hd), rechazando las cuentas fuera de él.
  • Invitación de miembro: el registro de una persona no emite contraseña. Emite un enlace de activación de un solo uso, con vencimiento, guardado como hash; la persona define su propia contraseña al aceptar (consulta Usuarios). Un enlace perdido o vencido se resuelve reenviando la invitación — no existe "generar nueva contraseña". Consulta Credenciales y rotación.
  • El equipo nunca pide tu contraseña ni el valor de una clave — consulta Soporte.

Límites#

  • Recuperación de MFA: no existe, ni por autoservicio ni por el producto. No hay códigos de recuperación de un solo uso, y no hay acción de admin, de owner ni de soporte dentro del producto que restablezca el segundo factor de otra persona — la buscamos y no existe en el código. Quien pierde la app autenticadora se queda sin camino de vuelta por la interfaz; resolverlo hoy requiere una intervención fuera del producto. Guarda la semilla del autenticador al configurarlo.
  • Cambio de contraseña: no hay pantalla de "cambiar mi contraseña" ni flujo de "olvidé mi contraseña". La contraseña de inicio de sesión se define en el registro; cambiarla después es un caso de soporte. Quien entra con Google o SSO no tiene contraseña local.
  • Sesión: la sesión es un token firmado guardado en el navegador; el servidor no mantiene una lista de sesiones, así que no hay "cerrar sesión en todos los dispositivos" ni revocación de sesión al cambiar una credencial.
  • SSO corporativo: queda apagado hasta que se active para su organización; hable con soporte.
  • El correo transaccional puede no estar habilitado en todos los entornos actuales; prefiere los canales in-app cuando el flujo dependa del correo.

Errores comunes y cómo resolverlos#

SíntomaCausa probableQué hacer
Inicio de sesión rechazado con la contraseña correctaMFA activo y código ausente/incorrectoingresa el código actual de la app autenticadora
Código TOTP siempre inválidoreloj del celular desfasadosincroniza la hora automática del dispositivo
Google rechaza la cuentarestricción de dominio de Workspace (hd)usa una cuenta del dominio permitido
"Autenticación no configurada en producción"entorno sin Google ni credencialesel operador debe configurar las variables de entorno de autenticación

Relacionados#


Última revisión: 2026-09-17.

Enlaces relacionados