Autenticação
Use UserJot.identify(...) para enviar seu usuário autenticado no app ao UserJot, para que os comentários e votos permaneçam vinculados à conta dele.
Pré-requisito: ative o Login automático em Configurações → Login (disponível nos planos Starter e Professional). O Swift SDK troca a identidade do usuário por meio do Login automático, mesmo que você não habilite Exigir tokens assinados.
Identificação básica
No mínimo, informe um ID de usuário estável do seu próprio banco de dados (não um token de sessão nem um e-mail que possa mudar):
UserJot.identify(userId: "user_123")Inclua o e-mail e os campos do perfil sempre que disponíveis para que as contas sejam correspondidas corretamente em todas as áreas do UserJot:
UserJot.identify(
userId: "user_123",
email: "john@example.com",
firstName: "John",
lastName: "Doe",
avatar: "https://example.com/avatar.jpg"
)Não teste a identificação pelo cliente com um endereço de e-mail que pertença a um proprietário ou administrador de qualquer espaço de trabalho do UserJot. Essas contas estão impedidas de fazer login automático pelo lado do cliente e devem entrar diretamente pelo UserJot.
Quando identificar e encerrar a sessão
Chame
UserJot.identify(...)depois que seu app restaurar ou criar uma sessão autenticada e novamente se os campos do perfil mudarem.Chame
UserJot.logout()sempre que o usuário sair do seu app para que o próximo usuário do dispositivo não herde a sessão.
@MainActor
func handleLogin(user: User) {
UserJot.identify(
userId: user.id,
email: user.email,
firstName: user.firstName,
lastName: user.lastName
)
}
@MainActor
func handleLogout() {
UserJot.logout()
}Autenticação assinada (HMAC-SHA256)
Para identificar usuários com verificação do servidor, calcule um resumo hexadecimal HMAC-SHA256 do userId do usuário usando seu Segredo do projeto (em Configurações → Login → Segredos) como chave e passe-o como signature:
UserJot.identify(
userId: "user_123",
email: "john@example.com",
signature: signatureFromYourServer
)Para exigir assinaturas em todas as chamadas, habilite Exigir tokens assinados em Configurações → Login (a opção aparece quando o Login automático está ativado). Nunca inclua seu Segredo do projeto no pacote do app para iOS ou macOS; sempre calcule a assinatura no seu backend.
Se você também usa o widget da web, Exigir tokens assinados se aplica às duas plataformas: o Swift SDK espera um signature HMAC-SHA256, enquanto o widget da web espera um JWT HS256 (token). Consulte Identidade assinada.
Exemplos de assinatura no 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)
endPadrão de 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
)
}
}
}
}
}Próximas etapas
Apresente comentários, roteiro e atualizações em Fluxos comuns.
Compare todas as opções de autenticação do UserJot em Identificar usuários.