Autenticazione

Shayan TaslimAggiornato

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.

Note

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

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

Swift
UserJot.identify(
    userId: "user_123",
    email: "john@example.com",
    firstName: "John",
    lastName: "Doe",
    avatar: "https://example.com/avatar.jpg"
)
Warning

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.

Swift
@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:

Swift
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.

Note

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

JavaScript
import crypto from 'node:crypto';

export function signUserJotIdentity(userId, secret) {
  return crypto.createHmac('sha256', secret).update(userId).digest('hex');
}

Python

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
<?php

function signUserJotIdentity(string $userId, string $secret): string
{
    return hash_hmac('sha256', $userId, $secret);
}

Ruby

Ruby
require 'openssl'

def sign_userjot_identity(user_id, secret)
  OpenSSL::HMAC.hexdigest('sha256', secret, user_id)
end

Procedura per le app SwiftUI

Swift
@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

Ha risposto alla tua domanda?