Inicio de sesión para los usuarios de tu app
Tu app viene con cuentas
Las apps creadas en Kliv tienen sus propios usuarios: los clientes, miembros o compañeros de equipo de quien use tu producto. Cada app recibe desde el inicio un sistema completo de inicio de sesión para esos usuarios. No integras un proveedor de autenticación ni administras tú mismo el almacenamiento de contraseñas: describe quién debería poder iniciar sesión, y Kliv se encarga del resto.
Una distinción que conviene mantener clara: esta página trata sobre los usuarios de tu app. El inicio de sesión para tu propio equipo, las personas que crean la app contigo en Kliv, incluido cualquier SSO empresarial que use tu organización, es independiente y se cubre en Administración de usuarios.
Métodos de inicio de sesión
Los usuarios de tu app pueden iniciar sesión con:
- Correo y contraseña — la cuenta tradicional con una dirección de correo verificada
- Sign in with Google y Sign in with Facebook — inicio de sesión social con un clic usando una cuenta que ya tienen
- Passkeys (WebAuthn) — inicio de sesión sin contraseña usando biometría del dispositivo o una llave de seguridad
- Autenticación de dos factores (TOTP) — un código basado en tiempo desde una app autenticadora como segundo paso
Dile a Kliv en conversación qué métodos debería ofrecer tu app. "Permite que los usuarios se registren con correo o Google, y soporta passkeys" es suficiente.
Organizaciones y roles
Los usuarios no tienen que ser una lista plana. Los usuarios de tu app pueden pertenecer a organizaciones, y dentro de una organización cada usuario tiene un rol. Esta es la forma natural para productos de equipo y apps B2B: una empresa se registra, invita a su gente, y lo que cada persona puede hacer se deriva de su rol. Describe los roles que necesitas y Kliv los configura.
Inicio de sesión y acceso a datos
Iniciar sesión no es solo una puerta de entrada: determina a qué puede acceder cada usuario. El acceso a datos sigue las reglas de seguridad a nivel de fila de tu base de datos, así que un usuario con sesión iniciada solo lee y escribe las filas que esas reglas permiten. Consulta Base de datos para ver cómo funciona la seguridad a nivel de fila.
Lo mismo aplica a los agentes. Si tu app incluye un agente, el estado de inicio de sesión de un usuario delimita lo que el agente puede leer en su nombre: un agente que responde la pregunta de un usuario no puede apoyarse en filas que ese usuario no podría ver por sí mismo. Consulta Agentes y tus datos.
Usa tus propias credenciales de Google o Facebook
El inicio de sesión con Google y Facebook funciona desde el primer momento con claves administradas por Kliv, y no tienes que registrar nada con el proveedor. Usar tus propias claves es opcional: así, la pantalla de consentimiento del proveedor muestra el nombre de tu app en lugar del de Kliv.
Si usas tus propias claves, registra en el proveedor un URI de redireccionamiento por cada dirección en la que los visitantes inician sesión:
https://<dirección de tu sitio>/api/v2/auth/oauth/<proveedor>/complete
Por ejemplo: https://example.com/api/v2/auth/oauth/google/complete. Necesitas uno por dirección: uno por cada dominio personalizado, más uno para la dirección <clave-del-sitio>.kliv.site de tu sitio si los visitantes la usan. Una dirección www que redirige a tu dominio principal no necesita ninguno.
No tienes que armarlos a mano. En Configuración del sitio → Inicio de sesión social → Usa tus credenciales OAuth aparecen los URI exactos de tu sitio, cada uno con un botón para copiarlo.
Dónde agregarlos:
- Google: en Google Cloud Console, abre tu cliente de OAuth y agrégalos en URI de redireccionamiento autorizados (Authorized redirect URIs). Orígenes autorizados de JavaScript puede quedar vacío.
- Facebook: en tu app de desarrollador de Meta, abre la configuración de Inicio de sesión con Facebook y agrégalos en URI de redireccionamiento de OAuth válidos (Valid OAuth Redirect URIs).
Iniciar sesión con Apple solo admite claves administradas por Kliv.
El inicio de sesión en las direcciones de vista previa no funciona con tus propias claves, así que pruébalo en tu sitio publicado.
Documentación relacionada
- Base de datos → — reglas de seguridad a nivel de fila
- Agentes y tus datos → — cómo los agentes respetan el acceso de usuario
- Administración de usuarios → — inicio de sesión y roles para tu propio equipo