Uwierzytelnianie
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.
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):
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:
UserJot.identify(
userId: "user_123",
email: "john@example.com",
firstName: "John",
lastName: "Doe",
avatar: "https://example.com/avatar.jpg"
)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.
@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:
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.
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
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)
endSchemat dla aplikacji 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
)
}
}
}
}
}Następne kroki
Prezentuj opinie, plan rozwoju i aktualizacje w sekcji Typowe procesy.
Porównaj wszystkie opcje uwierzytelniania UserJot w sekcji Identyfikowanie użytkowników.