Автентифікація

Shayan TaslimОновлено

Використовуйте UserJot.identify(...), щоб передавати UserJot дані про користувача, який увійшов у ваш застосунок, і прив’язувати відгуки та голоси до його облікового запису.

Note

Передумова: Увімкніть Automatic login у розділі Settings → Login (доступно в тарифних планах Starter і Professional). Swift SDK передає дані про особу користувача через Automatic login, навіть якщо ви не ввімкнули Require signed tokens.

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

Щонайменше передавайте стабільний ідентифікатор користувача з власної бази даних (не токен сеансу й не змінну адресу електронної пошти):

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 користувача, використовуючи як ключ Project secret (у розділі Settings → Login → Secrets), і передайте його як signature:

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

Щоб вимагати підпис для кожного виклику, увімкніть Require signed tokens у розділі Settings → Login (цей параметр з’явиться, коли буде ввімкнено Automatic login). Ніколи не додавайте Project secret до пакета застосунку для iOS або macOS; завжди обчислюйте підпис на своєму сервері.

Note

Якщо ви також використовуєте вебвіджет, параметр Require signed tokens застосовується до обох платформ: Swift SDK очікує HMAC-SHA256 signature, а вебвіджет — JWT у форматі HS256 (token). Докладніше див. Signed identity.

Приклади створення підпису на сервері

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

Наступні кроки

  • Дізнайтеся, як показувати відгуки, дорожню карту й оновлення, у розділі Common flows.

  • Порівняйте всі способи автентифікації UserJot у розділі Identify users.

Чи відповіла ця стаття на ваше запитання?