Autenticação

Shayan TaslimAtualizado

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.

Note

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

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

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

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

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

Note

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

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 para aplicações 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óximos passos

Isto respondeu à sua pergunta?