المصادقة

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

لا تختبر التعرّف على العميل باستخدام عنوان بريد إلكتروني يعود إلى مالك أو مسؤول في <1أي مساحة عمل على 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 قيمة HMAC-SHA256 signature، بينما تتوقع أداة الويب رمز 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
                        )
                    }
                }
        }
    }
}

الخطوات التالية

هل أجاب هذا عن سؤالك؟