Autenticazione
Usa UserJot.identify(...) per passare a UserJot l’utente che ha effettuato l’accesso alla tua app, così i feedback e i voti restano associati al suo account.
Prerequisito: Attiva Accesso automatico in Impostazioni → Accesso (disponibile con i piani Starter e Professional). Lo Swift SDK scambia l’identità dell’utente tramite l’accesso automatico anche se non abiliti Richiedi token firmati.
Identificazione di base
Come minimo, passa un ID utente stabile dal tuo database (non un token di sessione o un indirizzo email modificabile):
UserJot.identify(userId: "user_123")Includi l’email e i campi del profilo, quando disponibili, affinché gli account corrispondano correttamente nelle diverse sezioni di UserJot:
UserJot.identify(
userId: "user_123",
email: "john@example.com",
firstName: "John",
lastName: "Doe",
avatar: "https://example.com/avatar.jpg"
)Non testare l’identificazione client con un indirizzo email appartenente al proprietario o a un amministratore di una qualsiasi area di lavoro UserJot. A questi account è impedito l’accesso automatico lato client e devono accedere direttamente tramite UserJot.
Quando identificare gli utenti e disconnetterli
Chiama
UserJot.identify(...)dopo che l’app ha ripristinato o creato una sessione autenticata e ogni volta che cambiano i campi del profilo.Chiama
UserJot.logout()ogni volta che l’utente esce dalla tua app, così l’utente successivo sul dispositivo non erediterà la sessione.
@MainActor
func handleLogin(user: User) {
UserJot.identify(
userId: user.id,
email: user.email,
firstName: user.firstName,
lastName: user.lastName
)
}
@MainActor
func handleLogout() {
UserJot.logout()
}Autenticazione firmata (HMAC-SHA256)
Per un’identificazione verificata dal server, calcola un digest esadecimale HMAC-SHA256 dell’userId dell’utente usando come chiave il tuo Segreto del progetto (in Impostazioni → Accesso → Segreti) e passalo come signature:
UserJot.identify(
userId: "user_123",
email: "john@example.com",
signature: signatureFromYourServer
)Per rendere obbligatorie le firme per ogni chiamata, abilita Richiedi token firmati in Impostazioni → Accesso (l’opzione viene mostrata quando Accesso automatico è attivo). Non incorporare mai il segreto del progetto nel pacchetto dell’app iOS o macOS: calcola sempre la firma sul tuo backend.
Se usi anche il widget web, Richiedi token firmati si applica a entrambe le piattaforme: lo Swift SDK si aspetta un signature HMAC-SHA256, mentre il widget web si aspetta un JWT HS256 (token). Consulta Identità firmata.
Esempi di firma lato server
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)
endProcedura per le app 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
)
}
}
}
}
}Passaggi successivi
Presenta feedback, roadmap e aggiornamenti in Flussi comuni.
Confronta tutte le opzioni di autenticazione di UserJot in Identificare gli utenti.