Autenticación
Usa UserJot.identify(...) para pasar a UserJot el usuario autenticado de tu app, de modo que los comentarios y los votos sigan vinculados a su cuenta.
Requisito previo: Activa el Inicio de sesión automático en Configuración → Inicio de sesión (disponible en los planes Starter y Professional). El Swift SDK intercambia la identidad del usuario mediante el Inicio de sesión automático, aunque no habilites Exigir tokens firmados.
Identificación básica
Como mínimo, pasa un ID de usuario estable de tu propia base de datos (no un token de sesión ni una dirección de correo electrónico que pueda cambiar):
UserJot.identify(userId: "user_123")Incluye el correo electrónico y los campos del perfil siempre que estén disponibles, para que las cuentas coincidan correctamente en todas las secciones de UserJot:
UserJot.identify(
userId: "user_123",
email: "john@example.com",
firstName: "John",
lastName: "Doe",
avatar: "https://example.com/avatar.jpg"
)No pruebes la identificación del lado del cliente con una dirección de correo electrónico que pertenezca al propietario o administrador de cualquier espacio de trabajo de UserJot. Se bloquea el inicio de sesión automático desde el cliente para esas cuentas, que deben iniciar sesión directamente a través de UserJot.
Cuándo identificar y cerrar sesión
Llama a
UserJot.identify(...)después de que tu app restaure o cree una sesión autenticada, y también si cambian los campos del perfil.Llama a
UserJot.logout()cada vez que el usuario cierre sesión en tu app, para que el siguiente usuario del dispositivo no herede la sesión.
@MainActor
func handleLogin(user: User) {
UserJot.identify(
userId: user.id,
email: user.email,
firstName: user.firstName,
lastName: user.lastName
)
}
@MainActor
func handleLogout() {
UserJot.logout()
}Autenticación firmada (HMAC-SHA256)
Para una identificación verificada por el servidor, calcula un resumen hexadecimal HMAC-SHA256 del userId del usuario con tu Secreto del proyecto (en Configuración → Inicio de sesión → Secretos) como clave y pásalo como signature:
UserJot.identify(
userId: "user_123",
email: "john@example.com",
signature: signatureFromYourServer
)Para exigir firmas en cada llamada, activa Exigir tokens firmados en Configuración → Inicio de sesión (esta opción aparece una vez activado el Inicio de sesión automático). Nunca incluyas el Secreto del proyecto en el paquete de la app de iOS o macOS; calcula siempre la firma en tu backend.
Si también usas el widget web, Exigir tokens firmados se aplica a ambas plataformas: el Swift SDK espera un signature HMAC-SHA256, mientras que el widget web espera un JWT HS256 (token). Consulta Identidad firmada.
Ejemplos de firmas en el servidor
Node.js
import crypto from 'node:crypto';
export function signUserJotIdentity(userId, secret) {
return crypto.createHmac('sha256', secret).update(userId).digest('hex');
}Python
import hmac
import hashlib
def sign_userjot_identity(user_id: str, secret: str) -> str:
return hmac.new(
secret.encode("utf-8"),
user_id.encode("utf-8"),
hashlib.sha256,
).hexdigest()PHP
<?php
function signUserJotIdentity(string $userId, string $secret): string
{
return hash_hmac('sha256', $userId, $secret);
}Ruby
require 'openssl'
def sign_userjot_identity(user_id, secret)
OpenSSL::HMAC.hexdigest('sha256', secret, user_id)
endPatrón para apps de SwiftUI
@main
struct MyApp: App {
@StateObject private var authManager = AuthManager()
init() {
UserJot.setup(projectId: "YOUR_PROJECT_ID")
}
var body: some Scene {
WindowGroup {
ContentView()
.onAppear {
if let user = authManager.currentUser {
UserJot.identify(
userId: user.id,
email: user.email
)
}
}
}
}
}Próximos pasos
Presenta comentarios, hoja de ruta y novedades en Flujos habituales.
Compara todas las opciones de autenticación de UserJot en Identificar usuarios.