Autenticação
Utilize UserJot.identify(...) para transmitir o utilizador com sessão iniciada na sua app ao UserJot, para que o feedback e os votos continuem associados à respetiva conta.
Pré-requisito: Ative o Início de sessão automático em Definições → Início de sessão (disponível nos planos Starter e Professional). O Swift SDK troca a identidade do utilizador através do Início de sessão automático, mesmo que não ative a opção Exigir tokens assinados.
Identificação básica
No mínimo, transmita um ID de utilizador estável da sua própria base de dados (não um token de sessão nem um endereço de e-mail que possa mudar):
UserJot.identify(userId: "user_123")Inclua o endereço de e-mail e os campos do perfil sempre que estiverem disponíveis, para que as contas correspondam 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 do cliente com um endereço de e-mail pertencente ao proprietário ou administrador de qualquer espaço de trabalho UserJot. Essas contas estão impedidas de iniciar sessão automaticamente do lado do cliente e têm de iniciar sessão diretamente através do UserJot.
Quando identificar utilizadores e terminar sessão
Chame
UserJot.identify(...)depois de a sua app restaurar ou criar uma sessão autenticada e novamente se os campos do perfil forem alterados.Chame
UserJot.logout()sempre que o utilizador terminar sessão na sua app, para que o utilizador seguinte no 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 utilizadores com verificação no servidor, calcule um resumo hexadecimal HMAC-SHA256 do userId do utilizador, utilizando o seu segredo do projeto como chave (em Definições → Início de sessão → Segredos), e transmita-o como signature:
UserJot.identify(
userId: "user_123",
email: "john@example.com",
signature: signatureFromYourServer
)Para exigir assinaturas em todas as chamadas, ative a opção Exigir tokens assinados em Definições → Início de sessão (apresentada depois de ativar o Início de sessão automático). Nunca inclua o segredo do projeto no pacote da app de iOS ou macOS; calcule sempre a assinatura no seu backend.
Se também utilizar o widget web, a opção Exigir tokens assinados aplica-se a ambas as plataformas: o Swift SDK espera um signature HMAC-SHA256, enquanto o widget 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 para aplicações 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 passos
Apresente feedback, roteiro e atualizações em Fluxos comuns.
Compare todas as opções de autenticação do UserJot em Identificar utilizadores.