Uwierzytelnianie

Shayan TaslimZaktualizowano

Użyj UserJot.identify(...), aby przekazać zalogowanego użytkownika aplikacji do UserJot, dzięki czemu opinie i głosy będą przypisane do jego konta.

Note

Wymaganie wstępne: Włącz automatyczne logowanie w Ustawieniach → Logowanie (dostępne w planach Starter i Professional). Swift SDK wymienia informacje o tożsamości użytkownika za pośrednictwem automatycznego logowania, nawet jeśli nie włączysz opcji Wymagaj podpisanych tokenów.

Podstawowa identyfikacja

Przynajmniej przekazuj stabilny identyfikator użytkownika z własnej bazy danych (nie token sesji ani zmienny adres e-mail):

Swift
UserJot.identify(userId: "user_123")

Jeśli to możliwe, uwzględnij adres e-mail i pola profilu, aby konta były prawidłowo dopasowywane we wszystkich obszarach UserJot:

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

Nie testuj identyfikacji klienta, używając adresu e-mail należącego do właściciela lub administratora dowolnego obszaru roboczego UserJot. Te konta nie mogą korzystać z automatycznego logowania po stronie klienta i muszą logować się bezpośrednio przez UserJot.

Kiedy identyfikować użytkownika i się wylogować

  • Wywołaj UserJot.identify(...), gdy aplikacja przywróci lub utworzy uwierzytelnioną sesję, a także ponownie, gdy zmienią się pola profilu.

  • Wywołaj UserJot.logout() za każdym razem, gdy użytkownik wyloguje się z aplikacji, aby kolejny użytkownik urządzenia nie odziedziczył sesji.

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

Uwierzytelnianie podpisane (HMAC-SHA256)

Aby identyfikacja była weryfikowana przez serwer, oblicz skrót HMAC-SHA256 w formacie szesnastkowym dla userId użytkownika, używając sekretu projektu (z Ustawienia → Logowanie → Sekrety), i przekaż go jako signature:

Swift
UserJot.identify(
    userId: "user_123",
    email: "john@example.com",
    signature: signatureFromYourServer
)

Aby wymagać podpisów przy każdym wywołaniu, włącz opcję Wymagaj podpisanych tokenów w Ustawieniach → Logowanie (opcja pojawi się po włączeniu automatycznego logowania). Nigdy nie umieszczaj sekretu projektu w pakiecie aplikacji na iOS ani macOS — podpis obliczaj zawsze na zapleczu.

Note

Jeśli używasz także widżetu internetowego, opcja Wymagaj podpisanych tokenów dotyczy obu platform: Swift SDK oczekuje signature HMAC-SHA256, a widżet internetowy — tokenu JWT HS256 (token). Zobacz Podpisana tożsamość.

Przykłady generowania podpisów po stronie serwera

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

Schemat dla aplikacji 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
                        )
                    }
                }
        }
    }
}

Następne kroki

Czy ten artykuł odpowiedział na Twoje pytanie?