Автентифікація
Використовуйте UserJot.identify(...), щоб передавати UserJot дані про користувача, який увійшов у ваш застосунок, і прив’язувати відгуки та голоси до його облікового запису.
Передумова: Увімкніть Automatic login у розділі Settings → Login (доступно в тарифних планах Starter і Professional). Swift SDK передає дані про особу користувача через Automatic login, навіть якщо ви не ввімкнули Require signed tokens.
Базова ідентифікація
Щонайменше передавайте стабільний ідентифікатор користувача з власної бази даних (не токен сеансу й не змінну адресу електронної пошти):
UserJot.identify(userId: "user_123")За можливості додавайте адресу електронної пошти й дані профілю, щоб облікові записи коректно зіставлялися в усіх розділах UserJot:
UserJot.identify(
userId: "user_123",
email: "john@example.com",
firstName: "John",
lastName: "Doe",
avatar: "https://example.com/avatar.jpg"
)Не тестуйте клієнтську ідентифікацію, використовуючи адресу електронної пошти власника або адміністратора будь-якого робочого простору UserJot. Для цих облікових записів заблоковано автоматичний вхід на стороні клієнта, тому їхні власники мають входити безпосередньо через UserJot.
Коли ідентифікувати користувача та виходити з облікового запису
Викликайте
UserJot.identify(...), коли ваш застосунок відновлює або створює автентифікований сеанс, а також щоразу, коли змінюються дані профілю.Викликайте
UserJot.logout()щоразу, коли користувач виходить із вашого застосунку, щоб наступний користувач цього пристрою не успадкував сеанс.
@MainActor
func handleLogin(user: User) {
UserJot.identify(
userId: user.id,
email: user.email,
firstName: user.firstName,
lastName: user.lastName
)
}
@MainActor
func handleLogout() {
UserJot.logout()
}Автентифікація з підписом (HMAC-SHA256)
Щоб ідентифікувати користувачів із перевіркою на сервері, обчисліть шістнадцятковий дайджест HMAC-SHA256 для userId користувача, використовуючи як ключ Project secret (у розділі Settings → Login → Secrets), і передайте його як signature:
UserJot.identify(
userId: "user_123",
email: "john@example.com",
signature: signatureFromYourServer
)Щоб вимагати підпис для кожного виклику, увімкніть Require signed tokens у розділі Settings → Login (цей параметр з’явиться, коли буде ввімкнено Automatic login). Ніколи не додавайте Project secret до пакета застосунку для iOS або macOS; завжди обчислюйте підпис на своєму сервері.
Якщо ви також використовуєте вебвіджет, параметр Require signed tokens застосовується до обох платформ: Swift SDK очікує HMAC-SHA256 signature, а вебвіджет — JWT у форматі HS256 (token). Докладніше див. Signed identity.
Приклади створення підпису на сервері
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)
endШаблон для застосунку 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
)
}
}
}
}
}Наступні кроки
Дізнайтеся, як показувати відгуки, дорожню карту й оновлення, у розділі Common flows.
Порівняйте всі способи автентифікації UserJot у розділі Identify users.