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