Аутентификация

Shayan TaslimОбновлено

Используйте UserJot.identify(...), чтобы передать вошедшего в приложение пользователя в UserJot и привязать отзывы и голоса к его учетной записи.

Note

Предварительное условие: включите Автоматический вход в разделе Настройки → Вход (доступно в тарифных планах Starter и Professional). Swift SDK передает данные о пользователе через автоматический вход, даже если вы не включили параметр Требовать подписанные токены.

Базовая идентификация

Как минимум передавайте стабильный идентификатор пользователя из собственной базы данных (не токен сеанса и не изменяемый адрес электронной почты):

Swift
UserJot.identify(userId: "user_123")

По возможности добавляйте адрес электронной почты и данные профиля, чтобы учетные записи корректно сопоставлялись во всех разделах UserJot:

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

Не проверяйте идентификацию на стороне клиента с помощью адреса электронной почты, принадлежащего владельцу или администратору любой рабочей области UserJot. Для этих учетных записей автоматический вход на стороне клиента заблокирован, поэтому таким пользователям необходимо войти напрямую через UserJot.

Когда идентифицировать пользователя и выполнять выход

  • Вызывайте UserJot.identify(...) после восстановления или создания авторизованного сеанса в приложении, а также при изменении данных профиля.

  • Вызывайте UserJot.logout() при каждом выходе пользователя из приложения, чтобы следующий пользователь устройства не унаследовал сеанс.

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

Аутентификация с подписью (HMAC-SHA256)

Чтобы идентифицировать пользователя с проверкой на сервере, вычислите шестнадцатеричный дайджест HMAC-SHA256 для userId пользователя, используя в качестве ключа секрет проекта (в разделе Настройки → Вход → Секреты), и передайте его как signature:

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

Чтобы требовать подпись для каждого вызова, включите параметр Требовать подписанные токены в разделе Настройки → Вход (он появится после включения параметра Автоматический вход). Никогда не встраивайте секрет проекта в пакет приложения для iOS или macOS; всегда вычисляйте подпись на серверной части.

Note

Если вы также используете веб-виджет, параметр Требовать подписанные токены применяется к обеим платформам: Swift SDK ожидает signature HMAC-SHA256, а веб-виджет — JWT с алгоритмом HS256 (token). См. раздел Идентификация с подписью.

Примеры создания подписи на сервере

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

Типовой сценарий для приложения 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
                        )
                    }
                }
        }
    }
}

Дальнейшие действия

Эта статья ответила на ваш вопрос?