Autenticação

Shayan TaslimAtualizado

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.

Note

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

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

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

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.

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()
}

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:

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

Note

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

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

Padrão de 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
                        )
                    }
                }
        }
    }
}

Próximas etapas

Isso respondeu à sua pergunta?