Аутентификация
Используйте UserJot.identify(...), чтобы передать вошедшего в приложение пользователя в UserJot и привязать отзывы и голоса к его учетной записи.
Предварительное условие: включите Автоматический вход в разделе Настройки → Вход (доступно в тарифных планах Starter и Professional). Swift SDK передает данные о пользователе через автоматический вход, даже если вы не включили параметр Требовать подписанные токены.
Базовая идентификация
Как минимум передавайте стабильный идентификатор пользователя из собственной базы данных (не токен сеанса и не изменяемый адрес электронной почты):
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 пользователя, используя в качестве ключа секрет проекта (в разделе Настройки → Вход → Секреты), и передайте его как signature:
UserJot.identify(
userId: "user_123",
email: "john@example.com",
signature: signatureFromYourServer
)Чтобы требовать подпись для каждого вызова, включите параметр Требовать подписанные токены в разделе Настройки → Вход (он появится после включения параметра Автоматический вход). Никогда не встраивайте секрет проекта в пакет приложения для iOS или macOS; всегда вычисляйте подпись на серверной части.
Если вы также используете веб-виджет, параметр Требовать подписанные токены применяется к обеим платформам: Swift SDK ожидает signature HMAC-SHA256, а веб-виджет — JWT с алгоритмом HS256 (token). См. раздел Идентификация с подписью.
Примеры создания подписи на сервере
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
)
}
}
}
}
}Дальнейшие действия
Представляйте отзывы, дорожную карту и обновления в разделе Типовые сценарии.
Сравните все варианты аутентификации UserJot в разделе Идентификация пользователей.